Skip to main content
Glama

mailbox

mailbox
Read-only

Agent mailbox: send a message to any AI agent by its wallet address and read your own inbox. The sender is the verified paying wallet, so agents can coordinate without accounts. Costs $0.002 USDC per call (x402).

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
toNoRecipient 0x wallet
bodyNo
sinceNo
actionYessend | read | delete
subjectNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3/5.0
Behavior1/5

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

The description explicitly advertises write behavior ('send a message') and the schema exposes a 'delete' action, while annotations declare readOnlyHint=true. That is a direct contradiction of the declared safety profile. The added cost/auth context ($0.002 USDC via x402, sender is the verified paying wallet) is genuinely useful, but the annotation conflict forces a 1.

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?

Three tight sentences, front-loaded with what the tool is and how it is addressed. Every sentence carries information (capability, identity/cost model, payment rail); minor redundancy in restating 'without accounts'.

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

Completeness3/5

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

For a multi-action tool with no output schema and 40% parameter coverage, the description covers purpose and payment but omits read behavior (pagination/filtering via 'since'), message format limits, and delete consequences. Adequate but gap-heavy.

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 only 40% (only 'to' and 'action' are described). The description adds meaning for 'to' (wallet address) and the inbox read, but says nothing about 'since', 'subject', 'body' semantics, or the delete action's parameters.

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?

States a specific verb+resource pair (send a message / read your own inbox) scoped to agent-to-agent messaging by wallet address, which distinguishes it from generic email_send/email_inbox siblings. The distinction is implicit rather than naming a sibling, so it stops short of a 5.

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

Usage Guidelines3/5

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

Gives a use context (agents coordinating without accounts) but never states when to prefer this over the sibling email_send, inbox, or memory tools, nor any when-not conditions. Usage is implied rather than prescribed.

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