{"_id":"sentfromai-mcp","_rev":"3-ab927a6de7219ef1b4691128926f4183","name":"sentfromai-mcp","dist-tags":{"latest":"0.4.1"},"versions":{"0.3.0":{"name":"sentfromai-mcp","version":"0.3.0","keywords":["mcp","model-context-protocol","mcp-server","email","email-api","ai-agents","agent-tools","sentfromai","claude","openclaw","inbox","smtp","transactional-email"],"license":"MIT","_id":"sentfromai-mcp@0.3.0","maintainers":[{"name":"sentviaai","email":"help@brightboardai.com"}],"homepage":"https://docs.sentfrom.ai/guides/mcp","bugs":{"url":"https://github.com/samuelar2/sentfromai-mcp/issues"},"bin":{"sentfromai-mcp":"server.js"},"dist":{"shasum":"b8e453bdc9134a22c2b406af50cee528338b057b","tarball":"https://registry.npmjs.org/sentfromai-mcp/-/sentfromai-mcp-0.3.0.tgz","fileCount":4,"integrity":"sha512-YQxftvQ3nF6Jkk8TjYDX5BgiMckiewVaRjNsbJy1Is2HDFMonD0V9EMrBASlz4goRfESfEBY9XrtpUMBgMAx+A==","signatures":[{"sig":"MEYCIQC5Y5rbVEId/Q6HJPheKn65fELC0diD0k7+Qk4Coza6RQIhAI0tmCShFupuSXnvSueeQeNQp1vB+91LJEd9fAiE/1Q1","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":18871},"type":"module","engines":{"node":">=20"},"gitHead":"7429a1a61183f096f20fc55e05f00e2de3f48503","mcpName":"ai.sentfrom/mcp","scripts":{"start":"node server.js"},"_npmUser":{"name":"sentviaai","email":"help@brightboardai.com"},"repository":{"url":"git+https://github.com/samuelar2/sentfromai-mcp.git","type":"git"},"_npmVersion":"11.5.1","description":"MCP server for SentFromAI — email infrastructure for AI agents. Create inboxes, send and reply, search, manage threads, webhooks and allow/block rules as native agent tools.","directories":{},"_nodeVersion":"24.6.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sentfromai-mcp_0.3.0_1786388135813_0.1933456930978077","host":"s3://npm-registry-packages-npm-production"}},"0.4.0":{"name":"sentfromai-mcp","version":"0.4.0","keywords":["mcp","model-context-protocol","mcp-server","email","email-api","ai-agents","agent-tools","sentfromai","claude","openclaw","inbox","smtp","transactional-email","claude-code","claude-plugin","gemini-cli","cursor","agent-email"],"license":"MIT","_id":"sentfromai-mcp@0.4.0","maintainers":[{"name":"sentviaai","email":"help@brightboardai.com"}],"homepage":"https://docs.sentfrom.ai/guides/mcp","bugs":{"url":"https://github.com/sentfromai/sentfromai-mcp/issues"},"bin":{"sentfromai-mcp":"server.js"},"dist":{"shasum":"846b3bbf3064d11a8a295e2da9928e52e71494fc","tarball":"https://registry.npmjs.org/sentfromai-mcp/-/sentfromai-mcp-0.4.0.tgz","fileCount":6,"integrity":"sha512-Eo5cB8qIeIQ+9rPZ1K5u/LGxzEh3Bjwf90R1CP3Ft3VGkTnnF4hKy/DowXwsWXzyfeqbFFh2bksWIR2psspuvA==","signatures":[{"sig":"MEQCIDDTRoN1LQgrh6VhFlM7ZeFqwIZNdwHMdAvjgosmS+LTAiB5dWf4wQrGmdlQP5NfTSTackdQzDEA77dE3h6Mf/FUxg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEQCIDaNhCWJvxy5Ps+MJNWtGhg9nC9CJVaQGQaKY7P3COJkAiAx4gLCQ9t9xo45OPx7kc4i/hMYI7M/AiThwy/7urnheg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34020},"main":"./lib.js","type":"module","types":"./lib.d.ts","engines":{"node":">=20"},"exports":{".":"./lib.js","./package.json":"./package.json"},"gitHead":"55bfe9b35fb1c46a3c825099b3f8dd9d79cc9dec","mcpName":"ai.sentfrom/mcp","scripts":{"start":"node server.js"},"_npmUser":{"name":"sentviaai","email":"help@brightboardai.com"},"repository":{"url":"git+https://github.com/sentfromai/sentfromai-mcp.git","type":"git"},"_npmVersion":"11.5.1","description":"MCP server for SentFromAI — email infrastructure for AI agents. Create inboxes, send and reply, search, manage threads, webhooks and allow/block rules as native agent tools.","directories":{},"_nodeVersion":"24.6.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/sentfromai-mcp_0.4.0_1790259066273_0.8042845592321395","host":"s3://npm-registry-packages-npm-production"}},"0.4.1":{"_id":"sentfromai-mcp@0.4.1","bin":{"sentfromai-mcp":"server.js"},"bugs":{"url":"https://github.com/sentfromai/sentfromai-mcp/issues"},"dist":{"shasum":"ba1b965daf8cd1c1403e6d9e0d09da219538c95b","tarball":"https://registry.npmjs.org/sentfromai-mcp/-/sentfromai-mcp-0.4.1.tgz","fileCount":6,"integrity":"sha512-LrBIlbn1J3A5bPHh5ib6mN+kTrpI3dgn4mhlDFj6tp8Q0VH8MdE9Xpwtx8MN1iDziXBfzItkRlbnV/Rt6kDF4Q==","signatures":[{"sig":"MEYCIQDe4u/v8PG+kmjCYWBpgMAtV2eEBBd8nEP1d4HUmxJmJQIhAPq/3COe0LQrAFPaEHdCpjGt0x0MtCCAa+A2L9ba7QND","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIBt7nKLQMFEVN6Vs0V9TWAP8AghXcoNqPvgqCaDDy3pfAiBs/TfNH0iurPwX8T3o8+gmziYzRQOtfEkeuilgLwb45w=="}],"unpackedSize":34772},"main":"./lib.js","name":"sentfromai-mcp","type":"module","types":"./lib.d.ts","engines":{"node":">=20"},"exports":{".":"./lib.js","./package.json":"./package.json"},"gitHead":"5c8829343535430f6918b91b9771e7c8fcef586e","license":"MIT","mcpName":"ai.sentfrom/mcp","scripts":{"start":"node server.js"},"version":"0.4.1","_npmUser":{"name":"sentviaai","email":"help@brightboardai.com"},"homepage":"https://docs.sentfrom.ai/guides/mcp","keywords":["mcp","model-context-protocol","mcp-server","email","email-api","ai-agents","agent-tools","sentfromai","claude","openclaw","inbox","smtp","transactional-email","claude-code","claude-plugin","gemini-cli","cursor","agent-email"],"repository":{"url":"git+https://github.com/sentfromai/sentfromai-mcp.git","type":"git"},"_npmVersion":"11.5.1","description":"MCP server for SentFromAI — email infrastructure for AI agents. Create inboxes, send and reply, search, manage threads, webhooks and allow/block rules as native agent tools.","directories":{},"maintainers":[{"name":"sentviaai","email":"help@brightboardai.com"}],"_nodeVersion":"24.6.0","dependencies":{"@modelcontextprotocol/sdk":"^1.12.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/sentfromai-mcp_0.4.1_1790733395616_0.2849576585247724"}}},"time":{"created":"2026-08-10T18:55:35.690Z","modified":"2026-09-30T01:56:36.854Z","0.3.0":"2026-08-10T18:55:35.932Z","0.4.0":"2026-09-24T14:11:06.363Z","0.4.1":"2026-09-30T01:56:35.711Z"},"bugs":{"url":"https://github.com/sentfromai/sentfromai-mcp/issues"},"license":"MIT","homepage":"https://docs.sentfrom.ai/guides/mcp","keywords":["mcp","model-context-protocol","mcp-server","email","email-api","ai-agents","agent-tools","sentfromai","claude","openclaw","inbox","smtp","transactional-email","claude-code","claude-plugin","gemini-cli","cursor","agent-email"],"repository":{"url":"git+https://github.com/sentfromai/sentfromai-mcp.git","type":"git"},"description":"MCP server for SentFromAI — email infrastructure for AI agents. Create inboxes, send and reply, search, manage threads, webhooks and allow/block rules as native agent tools.","maintainers":[{"name":"sentviaai","email":"help@brightboardai.com"}],"readme":"# sentfromai-mcp\n\n[![npm](https://img.shields.io/npm/v/sentfromai-mcp)](https://www.npmjs.com/package/sentfromai-mcp)\n[![MCP registry](https://img.shields.io/badge/MCP_registry-ai.sentfrom%2Fmcp-2ea44f)](https://registry.modelcontextprotocol.io/v0/servers?search=ai.sentfrom)\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n\nMCP server for [SentFromAI](https://sentfrom.ai) — email infrastructure for AI agents.\n\nGives any MCP-capable agent (Claude Code, Claude Desktop, Cursor, VS Code, Gemini CLI,\nCodex, OpenClaw, or your own MCP host) email as native tools: create inboxes, send,\nreply, forward, search, read threads, manage drafts, custom domains, webhooks, and\nallow/block rules — 21 tools, each a thin wrapper over the\n[SentFromAI REST API](https://docs.sentfrom.ai/api-reference/introduction). Every tool\ncarries MCP annotations (read-only / write / send / delete) so hosts can group them\nand confirm the irreversible ones.\n\nYou need a SentFromAI API key (`sf_live_…`) from the [console](https://console.sentfrom.ai).\nFree plan: 5 inboxes, 5,000 emails/month, no card.\n\n## Let your agent install it\n\nPaste this into your agent (Claude Code, OpenClaw, Gemini CLI, any MCP-capable agent):\n\n```text\nSet up SentFromAI email for yourself: fetch https://docs.sentfrom.ai/agent-install.md\nand follow it. Ask me for the API key when you need it.\n```\n\n## Install\n\n### Claude Code\n\nAs a plugin (asks for the key when you enable it, and adds a skill that teaches Claude email etiquette):\n\n```bash\nclaude plugin marketplace add sentfromai/sentfromai-mcp\nclaude plugin install sentfromai@sentfromai\n```\n\nOr as a plain MCP server:\n\n```bash\nclaude mcp add sentfromai --env SENTFROMAI_API_KEY=sf_live_… -- npx -y sentfromai-mcp\n```\n\n### Claude Desktop, Cursor, Windsurf, Cline, any JSON-config host\n\n```json\n{\n  \"mcpServers\": {\n    \"sentfromai\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"sentfromai-mcp\"],\n      \"env\": { \"SENTFROMAI_API_KEY\": \"sf_live_…\" }\n    }\n  }\n}\n```\n\nCursor one-click (then paste your key into the generated config):\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=sentfromai&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsInNlbnRmcm9tYWktbWNwIl0sImVudiI6eyJTRU5URlJPTUFJX0FQSV9LRVkiOiJzZl9saXZlX+KApiJ9fQ==)\n\n### VS Code\n\n```bash\ncode --add-mcp '{\"name\":\"sentfromai\",\"command\":\"npx\",\"args\":[\"-y\",\"sentfromai-mcp\"],\"env\":{\"SENTFROMAI_API_KEY\":\"sf_live_…\"}}'\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/sentfromai/sentfromai-mcp\n```\n\nGemini asks for the API key on install and keeps it in your keychain.\n\n### Codex CLI\n\n```bash\ncodex mcp add sentfromai --env SENTFROMAI_API_KEY=sf_live_… -- npx -y sentfromai-mcp\n```\n\n### OpenClaw\n\n```bash\nopenclaw mcp add sentfromai --command npx --arg -y --arg sentfromai-mcp --env SENTFROMAI_API_KEY=sf_live_…\nopenclaw skills install git:sentfromai/sentfromai-mcp\n```\n\nFull guide: [docs.sentfrom.ai/frameworks/openclaw](https://docs.sentfrom.ai/frameworks/openclaw).\n\n## Hosted endpoint (no install)\n\nThe same 21 tools are served over Streamable HTTP at `https://api.sentfrom.ai/mcp` for\nhosts that only speak remote MCP (claude.ai connectors, ChatGPT apps, Meta Muse, Cursor\nremote servers, MCP Inspector). Authenticate with `Authorization: Bearer sf_live_…`\n(an `x-api-key` header also works), or let OAuth-capable hosts sign you in: the\nendpoint publishes RFC 9728 resource metadata pointing at SentFromAI's authorization server.\n\n```bash\nclaude mcp add --transport http sentfromai https://api.sentfrom.ai/mcp --header \"Authorization: Bearer sf_live_…\"\n```\n\n## Tools\n\n| Area | Tools | Annotation |\n| --- | --- | --- |\n| Inboxes | `create_inbox` · `list_inboxes` · `delete_inbox` | write · read · delete |\n| Messages | `send_message` · `reply_to_message` · `forward_message` | send (irreversible, open world) |\n| | `get_message` · `search_messages` | read |\n| Threads | `list_threads` · `get_thread` | read |\n| Drafts | `create_draft` · `send_draft` · `list_drafts` | write · send · read |\n| Domains | `add_domain` · `get_domain` | write · read |\n| Webhooks | `create_webhook` · `list_webhooks` · `delete_webhook` | write · read · delete |\n| Allow/block | `add_address_rule` · `list_address_rules` · `delete_address_rule` | write · read · delete |\n\nReplies thread correctly (In-Reply-To/References set automatically), search\nsupports keyword, semantic, and hybrid modes, and sends respect the same\nidempotency and suppression rules as the REST API. API failures come back as tool\nresults with `isError` and the HTTP status, so the model can read a `401` (bad key)\nor `402` (plan limit) and tell you instead of retrying.\n\n## Configuration\n\n| Env var | Required | Default |\n| --- | --- | --- |\n| `SENTFROMAI_API_KEY` | yes | — |\n| `SENTFROMAI_BASE_URL` | no | `https://api.sentfrom.ai` |\n\n## Programmatic use\n\nThe tools are exported so you can embed them in your own MCP host or transport:\n\n```js\nimport { createServer, TOOLS, callTool, createApi } from 'sentfromai-mcp'\n\nconst server = createServer({ apiKey: process.env.SENTFROMAI_API_KEY })\nawait server.connect(yourTransport)\n```\n\n## Privacy\n\nThis server keeps no state and stores nothing locally. Every tool call is one HTTPS\nrequest to `api.sentfrom.ai` authenticated with your API key. SentFromAI's privacy\npolicy: https://sentfrom.ai/privacy · terms: https://sentfrom.ai/terms.\n\n## Docs\n\n- [MCP guide](https://docs.sentfrom.ai/guides/mcp)\n- [API reference](https://docs.sentfrom.ai/api-reference/introduction)\n- [SentFromAI for agents](https://docs.sentfrom.ai/for-agents)\n","readmeFilename":"README.md"}