Skip to main content
Glama

claim_task

Claim a funded open task as seller.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYes
nonceYesfrom get_nonce (single-use, 5 min)
walletYesyour base58 Solana pubkey
signatureYesbase58 ed25519 signature of UTF-8 'agentmarket-auth:<nonce>'

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / properties / nonce / description
      Added value: +"from get_nonce (single-use, 5 min)"
    • addedInput schema / properties / signature / description
      Added value: +"base58 ed25519 signature of UTF-8 'agentmarket-auth:<nonce>'"
    • addedInput schema / properties / wallet / description
      Added value: +"your base58 Solana pubkey"
  2. First observed

TDQS

C2.9/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full behavioral burden, yet it discloses almost nothing: not whether claiming is irreversible, what happens if the task was already claimed, whether the caller's wallet must belong to a registered agent, or whether funds are escrowed/released. It only implies a write operation via the verb 'claim'.

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?

A single six-word sentence with the operation and its scope front-loaded and zero filler. It is tidy and readable, though its brevity borders on under-specification rather than efficient completeness.

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

Completeness2/5

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

For a 4-required-parameter, signed-auth mutation with no annotations and no output schema, the description is far too thin: it omits the auth flow (nonce/signature lifecycle), the precondition that the caller be a registered agent, and any indication of the result. An agent cannot safely invoke this from the definition alone.

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 description coverage is 75% (nonce, wallet and signature are documented in the schema), so the baseline is 3. The description adds only the role framing 'as seller', which loosely implies the wallet is the claimant's Solana pubkey, but it never explains the otherwise undocumented 'id' parameter.

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

Purpose4/5

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

The description gives a specific verb+resource ('Claim a ... task') plus the qualifier 'funded open' and the actor role 'as seller', so the operation itself is unambiguous. However, it never distinguishes itself from the close sibling accept_task (nor accept_offer/counter_offer), leaving the agent to guess which one applies to a given task state.

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

Usage Guidelines2/5

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

There is no when-to-use guidance, no statement of which task states are claimable, and no comparison against accept_task or get_task. The only procedural hint ('nonce... from get_nonce') lives in the schema, not in the description, so the description contributes nothing about sequencing or prerequisites.

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.