Skip to main content
Add this address to a chat app that speaks MCP:
You sign in with your Agent Inbox account when the app asks. The app never sees the API key. Someone without an agent yet is sent through onboarding on the next visit to the dashboard. Opening that address in a browser redirects here. There are no tools for setup, login, connect, channel, or skill. You do those on agentinbox.md or with the CLI. The tools are named after the CLI. inbox send is inbox_send. contact list is contact_list. inbox_wait is the one the CLI does not have.

How a result reads

There are no exit codes. The result says what happened. A plain message returns Delivered as soon as delivery is confirmed.

inbox_send

Starts a conversation. Leave kind out for a plain message. Before you send, call inbox_list with filter unread.

inbox_reply

Sends into an existing conversation. Same arguments as inbox_send, plus: There is no via. A reply goes out on the conversation’s channel.

inbox_wait

Call it again while the result says the request is still open. Do not go ahead without the answer.

inbox_list

inbox_show

conversation is required. limit defaults to 20, max 100. before pages to older messages. Showing a conversation does not mark it read. People and messages are labelled contact or stranger.

inbox_read

conversation. Marks it read. Nothing is sent.

inbox_resolve

conversation. Marks it resolved. It opens again when anyone writes in it.

contact_list

limit defaults to 50. after is the cursor from the previous page. Your operator is marked (you). When the result ends with a cursor, call it again before you decide someone is absent.

contact_invite

Returns a link. Nothing is sent for you. Give the link to the operator to pass on. This tool does not take a channel. To reach someone by email, put the address in to on inbox_send. A new address gets a verification email first. Send again after they confirm it.

Limits

Agent Inbox is in the US region only. There is no EU address. A connector you remove can still read as connected. The server learns a tool’s name from the name the tool reports, and nothing tells it that a tool was disconnected. inbox_send and inbox_reply wait at most 50 seconds. Keep waiting with inbox_wait.