Skip to main content
Glama

Submit the signed token offer (step 2 of 2)

submit_token_offer

Complete the offer: pass workId, the BODY_JSON from prepare_token_offer UNCHANGED, and the signature your wallet produced over MESSAGE_TO_SIGN. Relays to the same public door any HTTP client uses (POST /labor/work/:workId/back/token); this server holds no keys, no funds and no tokens. Free with a valid signature. Returns the recorded offer and the packet's token terms. Cost and signer: free, no gas; signed by the person's own wallet or passkey, and the house never holds a key.

Input Schema

NameRequiredDescriptionDefault
workIdYesThe packet id.
bodyJsonYesThe exact BODY_JSON string from prepare_token_offer, unchanged.
signatureYesThe 0x… personal_sign output over MESSAGE_TO_SIGN.

Output Schema

NameRequiredDescriptionDefault
okNo
toolNo
fundedNo
payUsdNo
workIdNo
claimIdNo
claimableNo
next_callNo
proofRuleNo
fulfillableByNo
definitionOfDoneNo
needs_from_callerNo
notClaimableReasonNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Added

TDQS

A4/5.0
Behavior4/5

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

Goes well beyond the annotations by disclosing that the server relays to a public door, holds no keys/funds/tokens, requires no gas, and that signing happens in the user's own wallet or passkey. That is real trust and cost context an agent needs. It omits the non-idempotent retry behavior implied by idempotentHint=false, which matters for a submission step.

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

Conciseness3/5

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

Front-loaded with the required inputs, which is good, but the tail repeats itself: 'Free with a valid signature' is restated as 'Cost and signer: free, no gas,' and the no-key point is made twice. Roughly a third of the text is redundant.

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?

An output schema exists, so return values need not be explained, though the description usefully notes it returns the recorded offer and token terms. Combined with the openWorldHint relay context, the definition is nearly complete; the main gap is guidance on re-submission given the non-idempotent hint.

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

Parameters3/5

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

Schema coverage is 100% and the schema descriptions already say bodyJson is the exact string from prepare_token_offer and signature is the personal_sign output over MESSAGE_TO_SIGN. The description restates those constraints rather than adding new semantics, so the baseline 3 applies.

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?

States a concrete action (complete the offer), names the exact endpoint it relays to (POST /labor/work/:workId/back/token), and ties itself to step 1 via prepare_token_offer. This is clearly distinguishable from siblings like prepare_token_offer and submit_token_settlement.

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

Usage Guidelines4/5

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

Gives the explicit precondition chain: run prepare_token_offer first, pass its BODY_JSON unchanged, and supply a wallet signature over MESSAGE_TO_SIGN. It also states the operation is free with a valid signature. It does not name a when-not-to-use case or point to submit_token_settlement as the contrasting path, so it stops short of full routing guidance.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources