Skip to main content
Glama

cpu_authenticate

Creates a blockchain session for Project CPU. Use when other tools fail with authentication or session errors; re-authenticates and restores access to wallet-dependent tools.

Instructions

Create a blockchain session. Call this tool when other tools fail with authentication or session errors (e.g. "not authenticated", "session expired"). In EVM mode this signs in via SIWE locally and stores the token. In Paybox mode it opens browser authorization and returns the URL as a fallback. Once authenticated, subsequent wallet-dependent tools will work automatically. Pass force=true to discard the cached session and authenticate from scratch (e.g. after the game server was reset and the stored token references a stale user). Before your first reply to the operator, call cpu_persona and work to the brief.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
forceNoIgnore the stored session and re-run authentication from scratch.
payboxCredentialIdNoOpaque Paybox credential ID returned by an outstanding wallet selection.

Schema Changelog

Changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. Changed1 schema field changedv0.12.1
    • addedInput schema / properties / payboxCredentialId
      Added value: +{
      +  "anyOf": [
      +    {
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "description": "Opaque Paybox credential ID returned by an outstanding wallet selection."
      +}
  2. First observedv0.8.0

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden. It discloses mode-specific side effects (SIWE local sign-in and token storage, browser authorization with URL fallback), session caching behavior, and the downstream consequence that wallet-dependent tools start working automatically. This is strong behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is front-loaded with purpose and trigger conditions, then moves into modes and parameter behavior. It is mostly tight, but the final sentence about calling cpu_persona before replying is a workflow directive rather than tool behavior, slightly diluting focus.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an authentication tool with no output schema, the description covers the failure trigger, two authentication modes, force semantics, and downstream effects. It does not explicitly describe the success return shape in EVM mode, but that is a minor gap given the context and the tool's purpose.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the schema already documents both parameters. The description adds value by explaining the force=true use case with a concrete stale-session example and by describing the Paybox-mode context, which makes the parameter semantics more actionable.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb and resource: 'Create a blockchain session.' It then clarifies the tool's role as the authentication/session entry point among many wallet-dependent siblings, so an agent can distinguish it from tools like cpu_get_balance or cpu_build without opening schemas.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly states when to use this tool: 'Call this tool when other tools fail with authentication or session errors.' It also gives precise conditional guidance for force=true and for EVM vs Paybox modes, leaving little to inference.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/projectcpu/project-cpu-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server