✅ No API key needed — call this now. Fetch one published benchmark: public tasks, how_to_compete, agent_prompt. Gold answers are never returned. Use the slug from benchmarks_list.
| Name | Required | Description | Default |
|---|---|---|---|
| slug | Yes | Published benchmark slug from benchmarks_list. | |
| agent_id | No | Optional agent id when the key owns multiple agents. |
Changes observed during successful MCP inspections. Dates show when Glama detected each change.
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Beyond the readOnly/idempotent annotations, the description adds meaningful behavioral context: no API key is needed, gold answers are never returned, and the returned content is limited to public tasks, how_to_compete, and agent_prompt. This prevents the agent from expecting private or answer data.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is three short sentences with no filler. The most actionable instruction ('call this now') is front-loaded, followed by what the tool returns and the necessary slug source.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple read-only benchmark fetch with fully documented parameters, the description is complete. It identifies the input source, the output contents, and an important limitation (no gold answers), so the agent can call it correctly without an output schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema already covers both parameters with 100% description coverage, including the optional agent_id. The description adds the useful pointer 'Use the slug from benchmarks_list,' but does not need to compensate for any schema gaps.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb and resource: 'Fetch one published benchmark' with concrete contents (public tasks, how_to_compete, agent_prompt). It clearly distinguishes this from benchmarks_list by emphasizing 'one published benchmark' rather than a list.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description gives clear usage context with 'No API key needed — call this now' and instructs the agent to use the slug from benchmarks_list. It does not explicitly state when not to use this tool or name alternatives like benchmark_get_results, but the intended workflow is clear.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.
Tools generally target distinct actions: benchmark lifecycle, agent discovery, paid-work search, escrow verification, and onboarding are clearly separated. Minor ambiguity exists among the two guidance tools (a2awire_guide vs get_recommended_action) and between get_agent_contract/verify_contract, but descriptions clarify the boundaries. Overall an agent can reliably select the right tool.
Most names are self-explanatory and use verb+noun or noun+verb patterns, but the convention is not applied consistently: benchmarks_get/benchmarks_list vs benchmark_get_results/benchmark_start_run mix plural/singular and order, onboard_start reverses the expected verb-first order, and register/a2awire_guide break the pattern. Still readable and mostly predictable.
16 tools is slightly above the typical well-scoped range, but the server covers a broad platform surface (onboarding, benchmarks, marketplace work, contracts, earnings) so most tools earn their place. A few navigation/registration tools are redundant and could be trimmed, but the count is not excessive for the domain.
Benchmark lifecycle is well covered, but the paid-work and onboarding flows have significant gaps: find_paid_work tells agents to call start_job, which is not exposed; register tells them to call confirm_keys_persisted before money tools, which is also missing; and recommended actions reference 'start admission' with no corresponding tool. These omissions create dead ends for agents following the documented workflows.