English Français العربية

Mailbuttons (mbag.ai)

السجل الرسمي الإنتاجية

Governed email for AI agents (Mailbuttons / mbag.ai): sandbox inboxes, policy gate, audit log.

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mailbuttons-mbag-ai 'https://mailbuttons.com/api/v1/mcp/rpc' --header 'Authorization: <Bearer token: a scoped Mailbuttons MCP token, sent as '\''Bearer mb_sandbox_...'\'' (or mb_production_... once promoted). Get one free: sign in with an email code to get an mbk_ API key, then POST https://mailbuttons.com/api/v1/mcp/sandbox-inboxes with it. Guide: https://mailbuttons.com/developers/#mcp>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mailbuttons-mbag-ai": {
            "type": "http",
            "url": "https://mailbuttons.com/api/v1/mcp/rpc",
            "headers": {
                "Authorization": "<Bearer token: a scoped Mailbuttons MCP token, sent as 'Bearer mb_sandbox_...' (or mb_production_... once promoted). Get one free: sign in with an email code to get an mbk_ API key, then POST https://mailbuttons.com/api/v1/mcp/sandbox-inboxes with it. Guide: https://mailbuttons.com/developers/#mcp>"
            }
        }
    }
}
NPM package @mailbuttons/mcp-server
Claude Code 
claude mcp add mailbuttons-mbag-ai -e 'MAILBUTTONS_API_KEY=<your mailbuttons_api_key>' -e 'MAILBUTTONS_API_URL=https://mailbuttons.com' -- npx -y @mailbuttons/mcp-server@0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "mailbuttons-mbag-ai": {
            "command": "npx",
            "args": [
                "-y",
                "@mailbuttons/mcp-server@0.1.1"
            ],
            "env": {
                "MAILBUTTONS_API_KEY": "<your mailbuttons_api_key>",
                "MAILBUTTONS_API_URL": "https://mailbuttons.com"
            }
        }
    }
}

متغيرات البيئة

  • MAILBUTTONS_API_KEY إلزامي سري A scoped Mailbuttons MCP token (mb_sandbox_...). Sandbox-by-default; external send requires human promotion.
  • MAILBUTTONS_API_URL Backend base URL. Defaults to https://mailbuttons.com; set for self-hosted or local.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Mailbuttons MCP server
  2. Use it
  3. What the server enforces
  4. Install as an agent skill
  5. Docs

Mailbuttons MCP server

Governed email for AI agents, over the Model Context Protocol. Give an agent a scoped mailbox where the server enforces the guardrails, not the prompt: sandbox-by-default inboxes, a policy gate on every send, and a tamper-evident audit log. External sending and scope changes are human-approved, never granted by the agent itself.

Use it

Hosted (recommended) — a streamable-HTTP endpoint served by the platform:

https://mailbuttons.com/api/v1/mcp/rpc
Authorization: Bearer <your Mailbuttons MCP token>   # mb_sandbox_... (or mb_prod_...)

Local (stdio) — run the npm package and let your agent launch it:

{
  "mcpServers": {
    "mailbuttons": {
      "command": "npx",
      "args": ["-y", "@mailbuttons/mcp-server"],
      "env": { "MAILBUTTONS_API_KEY": "mb_sandbox_..." }
    }
  }
}

Get a scoped token from the dashboard or POST /api/v1/mcp/sandbox-inboxes. Sandbox tokens can never send externally until a human promotes them.

What the server enforces

  • Inbound — a per-mailbox sender policy, fail-closed: mail from strangers bounces by default, so nobody can prompt-inject your agent just by emailing it.
  • Outbound — a recipient blocklist the agent can read but not change; a blocked send returns a normal {"status":"blocked"} result, not an error.
  • Caps + audit — per-account send caps and a hash-chained audit log that records refusals too.
  • Escalation — sending externally or widening scope is propose-only; a named human approves. The agent cannot approve its own request.

Install as an agent skill

This repo ships a root SKILL.md, so any skills-aware agent can add it:

npx skills add mailbuttons/mcp-server

Docs

Mailbuttons is a trading name of Code Cutter Limited (UK, no. 08453060). MIT licensed.

الأسئلة الشائعة

ما هو Mailbuttons (mbag.ai)؟

Governed email for AI agents (Mailbuttons / mbag.ai): sandbox inboxes, policy gate, audit log.

كيف أثبّت Mailbuttons (mbag.ai)؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http mailbuttons-mbag-ai 'https://mailbuttons.com/api/v1/mcp/rpc' --header 'Authorization: <Bearer token: a scoped Mailbuttons MCP token, sent as '\''Bearer mb_sandbox_...'\'' (or mb_production_... once promoted). Get one free: sign in with an email code to get an mbk_ API key, then POST https://mailbuttons.com/api/v1/mcp/sandbox-inboxes with it. Guide: https://mailbuttons.com/developers/#mcp>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Mailbuttons (mbag.ai) إلى مفتاح API؟

نعم. يتطلب MAILBUTTONS_API_KEY, Authorization، وتضبطها في إعداداته.

هل Mailbuttons (mbag.ai) مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Mailbuttons (mbag.ai)؟

ينشره mailbuttons. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.