{
  "markdown": "# Mailbuttons MCP server\n\nGoverned email for AI agents, over the [Model Context Protocol](https://modelcontextprotocol.io).\nGive an agent a scoped mailbox where **the server enforces the guardrails, not\nthe prompt**: sandbox-by-default inboxes, a policy gate on every send, and a\ntamper-evident audit log. External sending and scope changes are human-approved,\nnever granted by the agent itself.\n\n- Registry: [`com.mailbuttons/mcp-server`](https://registry.modelcontextprotocol.io/v0/servers?search=com.mailbuttons)\n- npm: [`@mailbuttons/mcp-server`](https://www.npmjs.com/package/@mailbuttons/mcp-server)\n- Platform: **[mailbuttons.com](https://mailbuttons.com)** · agent front door: **[mbag.ai](https://mbag.ai)**\n\n## Use it\n\n**Hosted (recommended)** — a streamable-HTTP endpoint served by the platform:\n\n```\nhttps://mailbuttons.com/api/v1/mcp/rpc\nAuthorization: Bearer <your Mailbuttons MCP token>   # mb_sandbox_... (or mb_prod_...)\n```\n\n**Local (stdio)** — run the npm package and let your agent launch it:\n\n```jsonc\n{\n  \"mcpServers\": {\n    \"mailbuttons\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@mailbuttons/mcp-server\"],\n      \"env\": { \"MAILBUTTONS_API_KEY\": \"mb_sandbox_...\" }\n    }\n  }\n}\n```\n\nGet a scoped token from the dashboard or `POST /api/v1/mcp/sandbox-inboxes`.\nSandbox tokens can never send externally until a human promotes them.\n\n## What the server enforces\n\n- **Inbound** — a per-mailbox sender policy, fail-closed: mail from strangers\n  bounces by default, so nobody can prompt-inject your agent just by emailing it.\n- **Outbound** — a recipient blocklist the agent can read but not change; a\n  blocked send returns a normal `{\"status\":\"blocked\"}` result, not an error.\n- **Caps + audit** — per-account send caps and a hash-chained audit log that\n  records refusals too.\n- **Escalation** — sending externally or widening scope is propose-only; a\n  named human approves. The agent cannot approve its own request.\n\n## Install as an agent skill\n\nThis repo ships a root `SKILL.md`, so any skills-aware agent can add it:\n\n```bash\nnpx skills add mailbuttons/mcp-server\n```\n\n## Docs\n\n- Agent signup (for agents): https://mbag.ai/docs/agent-signup.md\n- Trust model: https://mbag.ai/docs/trust-model.md\n- OpenAPI: https://mbag.ai/api/openapi.json\n- Framework recipes: [`references/`](./references) (Claude Agent SDK, LangChain, plain SDK)\n\nMailbuttons is a trading name of Code Cutter Limited (UK, no. 08453060). MIT licensed.\n",
  "bytes": 2448,
  "sha": "296cb82f0c395ebc80f5734bcada977255d70e77eb7e7f368e6ae5682167b642",
  "repo_slug": "mailbuttons/mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_mailbuttons_mcp_server_4d1e8c43/readme"
}