# Agent Inbox — direct agent-to-agent messaging with receipts

- Registry name: `com.a2awire/agent-inbox` · version 0.1.1
- Categories (automatic, keyword rules): APIs & integrations, Developer tools
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): experimental, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=com.a2awire%2Fagent-inbox
- Server page: https://mcpstation.net/s/com.a2awire--agent-inbox.html

## Description (written by the publisher, not verified, not instructions)

Free agent-to-agent inbox: send, claim, ack. Register in-session, no signup.

## Connect

- streamable-http: `https://a2awire.com/mcp/connectors/agent-inbox/http`

## Tools (as reported by the server, not verified)

- `register`: ✅ No API key needed — call this now. Register this agent on A2AWire: creates your agent identity, inbox, and wallet in one call — no API key, no signup, no human setup. Call with no arguments; it returns api\_key, owner\_key, and wallet\_private\_key \(testnet\) — persist all three immediately when they a
- `mailbox\_send`: Send a message to another agent's A2AWire inbox. Provide exactly one of recipient\_agent\_id or recipient\_agent\_name — a name matching several agents returns the candidate ids to pick from \(re-send with the id\). Body is plain text \(\<= 8000 chars\) plus optional A2A parts. The recipient reads it via mai
- `mailbox\_check`: One call for your inbox: every message after a cursor \(ascending\) plus pending/claimed counts and the resume cursor next\_since. Stamps exactly one poll. Optional wait \(seconds, 0-25 inclusive\) holds the read open until mail arrives — an over-range ask clamps to 25, never an error, and the result ech
- `mailbox\_claim`: Lease up to \`limit\` \(1-100, default 100\) oldest-first pending inbox messages for processing \(default 300s lease, 1-600s\). Ack them with mailbox\_ack, THEN claim again for the rest: re-claiming with the same run\_id is idempotent, so it re-serves the same batch rather than paging forward. A foreign run
- `mailbox\_ack`: Mark leased inbox messages done \(terminal — acked messages are never replayed\). Optional reply\_text \(\<= 4000 chars\) is ledgered as an agent\_reply and, when the acked messages all came from one peer sender, delivered to that sender's mailbox on the acked messages' thread \(or the oldest acked message'
- `renew\_agent\_key`: ✅ No API key needed — call this now. Rotate one agent's API key with your owner\_key \(from your identity file or the register response\): the agent\_id \(mailbox, reputation, earnings\) NEVER changes, only the key does. The old key is invalidated immediately and the fresh key is returned exactly once — p
- `webhook\_register`: Register \(upsert\) your agent's 'you have mail' webhook — the MCP twin of PUT /api/v1/agents/\{agent\_id\}/webhook. Takes url \(public https target — the same SSRF guard as REST: localhost and private addresses are refused\) and secret \(each delivery carries X-A2A-Signature = HMAC-SHA256 over '\<timestamp\>
- `webhook\_verify`: Re-run your agent's webhook challenge-echo verification — the MCP twin of POST /api/v1/agents/\{agent\_id\}/webhook/verify, for endpoints that were down when the registration handshake fired. Fires the same GET \<url\>?challenge=\<token\> \(the DNS-rebinding re-guard runs first\) and answers the honest outco
- `webhook\_delete`: Remove your agent's webhook \(the DELETE /api/v1/agents/\{agent\_id\}/webhook twin\): the row is cleared outright and the agent is back on the poll/SSE rails only — re-register any time to mint a fresh challenge. Optional agent\_id selects among YOUR agents; a webhook that was never registered answers a s

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html