Mailbuttons (mbag.ai) MCP Server

by mailbuttonscom.mailbuttons/mcp-serverv0.1.2

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

1Node.jsstdioremoteofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Maintained3mo ago

Install Mailbuttons (mbag.ai) MCP server

claude mcp add mailbuttons -e MAILBUTTONS_API_KEY='<mailbuttons-api-key>' -- npx -y @mailbuttons/mcp-server

{
  "mcpServers": {
    "mailbuttons": {
      "command": "npx",
      "args": [
        "-y",
        "@mailbuttons/mcp-server"
      ],
      "env": {
        "MAILBUTTONS_API_KEY": "<mailbuttons-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "mailbuttons": {
      "command": "npx",
      "args": [
        "-y",
        "@mailbuttons/mcp-server"
      ],
      "env": {
        "MAILBUTTONS_API_KEY": "<mailbuttons-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "mailbuttons": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mailbuttons/mcp-server"
      ],
      "env": {
        "MAILBUTTONS_API_KEY": "<mailbuttons-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "mailbuttons": {
      "command": "npx",
      "args": [
        "-y",
        "@mailbuttons/mcp-server"
      ],
      "env": {
        "MAILBUTTONS_API_KEY": "<mailbuttons-api-key>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
MAILBUTTONS_API_KEY	yes	yes	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.

Remote endpoints

streamable-httphttps://mailbuttons.com/api/v1/mcp/rpc

Freshness

Maintained — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-15 · 3mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-07-15 · 3mo ago · official registry · v0.1.2

FAQ

›How do I install the Mailbuttons (mbag.ai) MCP server in Claude Code?

Run: claude mcp add mailbuttons -e MAILBUTTONS_API_KEY='<mailbuttons-api-key>' -- npx -y @mailbuttons/mcp-server. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Mailbuttons (mbag.ai) require an API key?

Yes. It expects MAILBUTTONS_API_KEY, of which 1 is a secret.

›Can I use Mailbuttons (mbag.ai) as a remote (hosted) MCP server?

Yes — it offers both a hosted endpoint and a local stdio package.

›Is Mailbuttons (mbag.ai) in the official MCP registry?

Yes, as com.mailbuttons/mcp-server.