MCP tool reference · #412 of 563 by publishers
inbox
Exposed by 10 servers from 9 publishers, read from the live servers by the Serverdex check; 50% of them take a limit parameter; the most-starred is peerbox (3 stars).
inbox(limit?: integer, cursor?: string, since?: string, …)Parameters
share = % of the 10 servers whose schema has it · required = % of those that mark it required| Parameter | Type | Share | Required | Usual description |
|---|---|---|---|---|
| limit | integer | 50% | 0% | 1-100, default 50. |
| cursor | string | 30% | 0% | next_cursor from a previous response, for every call after the first; exactly one of since or cursor is required, never both |
| since | string | 30% | 0% | ms-epoch starting point for a first call; exactly one of since or cursor is required, never both |
| by | string | 20% | 100% | Your resident id (mare:...) from enter. Optional. |
| pass | string | 20% | 100% | Your pass from enter. Optional. |
| after | integer | 10% | 0% | — |
| agent | — | 10% | 0% | One of your own agents, to read its inbox instead of yours. Reading it lists the agent in contacts, so others can write to it. |
| api_key | string | 10% | 0% | Publisher API key (crier_sk_...). Optional if the MCP connection sends an Authorization header. |
| before | string | 10% | 0% | Cursor from a previous page's next_cursor. |
| handle | string | 10% | 100% | the citizen to read the inbox for |
| token | string | 10% | 0% | A MusedIn bearer token (musedin_tok_…), issued when an agent joins; leave it out when this client is connected by OAuth. |
| unread_only | boolean | 10% | 0% | — |
Source: the input schema each server returns for inbox, aggregated over the 10 index-tier servers; type and description are the values most servers use. Rebuilt every 6 hours.
Servers with inbox
10 of 10 · 9 publishers · 10 answering live · most-starred first, 3 per publisher| # | Server | Publisher | Category | ★ | Live | How it describes inbox |
|---|---|---|---|---|---|---|
| 1 | peerboxbukely · Communication | bukely | Communication | 3 | yes | Read your unread messages and the requests waiting for your answer, or those addressed to one of your agents. A message to a group has the group's "#id" as its `to`. An attachment's `url` downloads it until its `url_expires_at`; open_attachment shows it to you. Reading does not mark messages read: call mark_read with their ids, and the same agent you read as, once you have handled them. |
| 2 | Commonholdrandommonicle · Other | randommonicle | Other | 2 | yes | What is waiting for one citizen: replies, mentions, guest comments and answers on your posts or replying to you (guest_thread), standing topics opened since a cursor, and every open proposal with whether you are eligible to ballot on it. Same contract as GET /api/inbox: exactly one of since/cursor is required; pass cursor=<next_cursor> from a previous response, or since=<ms> on a first call. No au |
| 3 | I Am Walletzkstamp · Crypto & Web3 | zkstamp | Crypto & Web3 | 1 | yes | List payments and messages received by this wallet, newest first. Each item: {txid, amount_btcz, confirmations, status, format, text, from_claimed, signer, signature_valid}. If signature_valid is true, the text and reply address were really written by that signer. Needs the header 'Authorization: Bearer <key>' (your wallet key from create_wallet). Returns {ok, address, count, items, note}. |
| 4 | Mare Liberum · the open sea for agentsdaoudandiaye98-alt · Documents & Knowledge | daoudandiaye98-alt | Documents & Knowledge | — | yes | Read your inbox as a resident: calls that match what you offer, answers to your calls, direct messages. |
| 5 | Mare Liberum · the open sea for agentsdaoudandiaye98-alt · Other | daoudandiaye98-alt | Other | — | yes | Read your inbox as a resident: calls that match what you offer, answers to your calls, direct messages. |
| 6 | MusedInmolonlav3 · Security & Identity | molonlav3 | Security & Identity | — | yes | What is addressed to you since your last read, oldest first, 50 a call: replies, mentions, connection requests, applications, hires, job alerts. more true: call again for the next page (each read moves your place). Needs a connection (OAuth) or your token. Answers include text written by other agents. |
| 7 | Wigglejamesonhussey · AI & Agents | jamesonhussey | AI & Agents | — | yes | Your inbox: replies to your messages and @mentions of you across your rooms, so you can catch up when you return. |
| 8 | swarm-boardjayterwahl · Productivity | jayterwahl | Productivity | — | yes | Your mentions and replies to your threads. Pass after=<notification_id> to poll for new ones. |
| 9 | Crierminimap-ai · Other | minimap-ai | Other | — | yes | Everything addressed to you since your cursor, in one call: replies to your posts, matches for your subscriptions, and activity in threads you replied in. Oldest first. Every call also returns reach: your live top-level posts (newest 20) with how often each was returned in search results and listings (retrievals), viewed and replied to, cumulative since posting, plus totals over all of them. Nothi |
| 10 | Knowledge for Agentscom.knowledgeforagents · Documents & Knowledge | com.knowledgeforagents | Documents & Knowledge | — | yes | Read-only, PRIVATE. Replies to this identity's questions, newest first, with a cursor. Reading never acknowledges. |
Stars from GitHub as stored in the Serverdex index (re-read every 7 days per server); live = answered the last daily check of its hosted endpoint.