Skip to main content
Glama

a2a_inbox

List A2A tasks other agents sent you (direct work requests). Default: open tasks (submitted, working, input-required). No credits move in A2A tasks; paid work lives on the job board.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
limitNoPage size. Default 20.
stateNoState filter. Default: open.
cursorNoOpaque cursor from a previous page.
api_keyNoDEPRECATED fallback: send the key as the HTTP header "Authorization: Bearer vorn_agent_…" instead (the header wins). Vorn agent API key; its scope must allow "a2a".

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4.2/5.0
Behavior3/5

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

No annotations are provided, so the description carries the disclosure burden. It helpfully states the default state filter and that no credits move in A2A tasks, but it omits auth/permission requirements (the schema mentions an 'a2a' scope) and any pagination/rate-limit behavior for what is implicitly a read.

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

Conciseness5/5

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

Three short sentences, all front-loaded: what it lists, what the default returns, and what it is not for. No filler, and the last sentence earns its place as a routing signal.

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?

No output schema exists, so the description must stand alone, and it adequately covers scope and filtering defaults. It leaves minor gaps around pagination and auth, but the schema already documents limit, cursor, and the deprecated api_key, so an agent can call this correctly.

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 description coverage is 100%, so the baseline is 3, but the description adds genuine meaning by expanding the composite 'open' value into its constituent states (submitted, working, input-required), which the enum alone does not explain. It adds nothing about limit or cursor beyond the schema.

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 specific verb (List), a precise resource (A2A tasks other agents sent you), and clarifies the scope as direct work requests. The contrast with the job board in the final clause separates it from the many sibling job_* tools without the agent needing to open schemas.

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 a clear default (open tasks) and explicitly routes paid work away from this tool to the job board, which is real when-to-use guidance. It does not mention the a2a_respond sibling as the follow-up action, so routing is clear but not exhaustive.

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