{"_id":"@aurorasendcloud/mcp-server","_rev":"8-567f9bde4a273da3d00a7caae959899c","name":"@aurorasendcloud/mcp-server","dist-tags":{"latest":"0.1.7"},"versions":{"0.1.0":{"name":"@aurorasendcloud/mcp-server","version":"0.1.0","keywords":[],"author":"","license":"ISC","_id":"@aurorasendcloud/mcp-server@0.1.0","maintainers":[{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"}],"bin":{"asc-mcp-server":"dist/index.js","aurorasendcloud-mcp-server":"dist/index.js"},"dist":{"shasum":"5b3b808157e202605b9eac67acd858fd85017a9b","tarball":"https://registry.npmjs.org/@aurorasendcloud/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":11,"integrity":"sha512-NDWwpjHTZ5+MzE5dCJQx+VGOXrZOU70sf2LqARIEHccL02P0O34bfk6YDayF8bFs7DXteH14ZcGCN/Vsjq0FDA==","signatures":[{"sig":"MEUCIQD0BkQTDGlwsjh/v132LYklspF/BYmBAR/U4AhdowVguAIgWlWPmTjsYrXnIZloxdiD1NmjU04U5/36FfBrMLrirgE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24123},"main":"index.js","type":"module","engines":{"node":">=18.17.0"},"scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js"},"_npmUser":{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"},"_npmVersion":"11.11.0","description":"Aurora SendCloud MCP server (local stdio deployment)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^4.3.6","dotenv":"^17.3.1","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.0_1774425778480_0.5780800995137716","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@aurorasendcloud/mcp-server","version":"0.1.1","keywords":[],"author":"","license":"ISC","_id":"@aurorasendcloud/mcp-server@0.1.1","maintainers":[{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"}],"bin":{"asc-mcp-server":"dist/index.js","aurorasendcloud-mcp-server":"dist/index.js"},"dist":{"shasum":"15a4af7e973783971a522e1e6fe33ca1730cfbdb","tarball":"https://registry.npmjs.org/@aurorasendcloud/mcp-server/-/mcp-server-0.1.1.tgz","fileCount":11,"integrity":"sha512-/291kvSDqVQfBFjUhSs4tXhOcdkSPNoQq2QqVitU0/SEfyPYO1xUxMa9MWOs7rH8kOEWMGK9JRGxdHrsd1nHjQ==","signatures":[{"sig":"MEUCIDRzinAQXkqqtXzcIM1I3QIGq9el01YLgvOs3HFmVc82AiEAmMC37V4q3kjJvE+Rnd0kNBfQ/kIpfB8c6Tsi4lM8uRE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24299},"main":"index.js","type":"module","engines":{"node":">=18.17.0"},"scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js"},"_npmUser":{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"},"_npmVersion":"11.11.0","description":"Aurora SendCloud MCP server (local stdio deployment)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^4.3.6","dotenv":"^17.3.1","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.1_1774510566777_0.5836131298838223","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@aurorasendcloud/mcp-server","version":"0.1.2","keywords":[],"author":"","license":"ISC","_id":"@aurorasendcloud/mcp-server@0.1.2","maintainers":[{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"}],"bin":{"asc-mcp-server":"dist/index.js","aurorasendcloud-mcp-server":"dist/index.js"},"dist":{"shasum":"600e4ab7b44ad69ba3a27dea032e5b3e845c04a0","tarball":"https://registry.npmjs.org/@aurorasendcloud/mcp-server/-/mcp-server-0.1.2.tgz","fileCount":11,"integrity":"sha512-8pbd7wjszesMHCToqtW4TGgjBmzt5yDsr4/vMZKXN6YZobyww9zdb1slPAhmywf1g1ufslhiTXtTyNeazI0dfg==","signatures":[{"sig":"MEUCIFtnLzXm17bxYf7URVgyoWtSaU8F28SAs7/yvHVkAMCyAiEAp6gF18Hc6JTbsRCOMZ7qQgB1ECHus/6+5Kf/7yHVumU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":24295},"main":"index.js","type":"module","engines":{"node":">=18.17.0"},"scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js"},"_npmUser":{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"},"_npmVersion":"11.11.0","description":"Aurora SendCloud MCP server (local stdio deployment)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^4.3.6","dotenv":"^17.3.1","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.2_1774511060931_0.75161075942158","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"@aurorasendcloud/mcp-server","version":"0.1.3","keywords":[],"author":"","license":"ISC","_id":"@aurorasendcloud/mcp-server@0.1.3","maintainers":[{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"}],"bin":{"asc-mcp-server":"dist/index.js","aurorasendcloud-mcp-server":"dist/index.js"},"dist":{"shasum":"05cea70a44c331ce4d3dc6718655947642e0f347","tarball":"https://registry.npmjs.org/@aurorasendcloud/mcp-server/-/mcp-server-0.1.3.tgz","fileCount":11,"integrity":"sha512-vucxdqg2Iuss29kCVXmBnfyqIMGv9XPCL9+NPuznudxSHNCBXw0BhcTVHruvTWTkkGIT5ljEDmADfC9YXGRS+Q==","signatures":[{"sig":"MEYCIQDLsIBc8eWD3WrWbXx6SACY2K1nJbbnZffaPhHT5fIHTwIhALrjGGOCRW6mIDWUHw6sFLUUKZ4haeDyfEaAK+dJ1ejU","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43510},"main":"index.js","type":"module","engines":{"node":">=18.17.0"},"scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js"},"_npmUser":{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"},"_npmVersion":"11.11.0","description":"Aurora SendCloud MCP server (local stdio deployment)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^4.3.6","dotenv":"^17.3.1","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.3_1774514292504_0.05474488243662057","host":"s3://npm-registry-packages-npm-production"}},"0.1.4":{"name":"@aurorasendcloud/mcp-server","version":"0.1.4","keywords":[],"author":"","license":"ISC","_id":"@aurorasendcloud/mcp-server@0.1.4","maintainers":[{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"}],"bin":{"asc-mcp-server":"dist/index.js","aurorasendcloud-mcp-server":"dist/index.js"},"dist":{"shasum":"4dc152caafa537a26efaecce5ac61f4725f098bd","tarball":"https://registry.npmjs.org/@aurorasendcloud/mcp-server/-/mcp-server-0.1.4.tgz","fileCount":11,"integrity":"sha512-/LH+DwY646rYnnI57DiIM3HjsL0RchSRpWI8xFm4Li2NhV1DCmNbSsoYs8J4j1MXqqBLNjhxXea8PcIwI9rThQ==","signatures":[{"sig":"MEUCIQCGDPA2PFB7l/q8RRYxlsLft8GSs202QUlzSzDl37OHgwIgOWQ5N+ONjZG2ehY3hhn1knUFVV78HwrYfq3KRsl0thQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42852},"main":"index.js","type":"module","engines":{"node":">=18.17.0"},"scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js"},"_npmUser":{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"},"_npmVersion":"11.11.0","description":"Aurora SendCloud MCP server (local stdio deployment)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^4.3.6","dotenv":"^17.3.1","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.4_1774515394655_0.6658213886060664","host":"s3://npm-registry-packages-npm-production"}},"0.1.5":{"name":"@aurorasendcloud/mcp-server","version":"0.1.5","keywords":[],"author":"","license":"ISC","_id":"@aurorasendcloud/mcp-server@0.1.5","maintainers":[{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"}],"bin":{"asc-mcp-server":"dist/index.js","aurorasendcloud-mcp-server":"dist/index.js"},"dist":{"shasum":"032e08dee9a210951543a12047540c1ce34d54ba","tarball":"https://registry.npmjs.org/@aurorasendcloud/mcp-server/-/mcp-server-0.1.5.tgz","fileCount":11,"integrity":"sha512-lA9Xx5HqaqEKV0xEFm8em2qME8zKPxH8NeDJVIqPgwSblQmYS2LNkOXR6tvwEbcfVT46CQcf68uzc6lwbu4URw==","signatures":[{"sig":"MEYCIQCx0TyjEj9TI6Iklg7TPvvGuRLhrL3BpZ1z9S8fVmIChAIhAJwlWKFMtWiwem5pIn1UWFzem/7WDLgEFPxvLMZZqZ5h","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":42858},"main":"index.js","type":"module","engines":{"node":">=18.17.0"},"scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js"},"_npmUser":{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"},"_npmVersion":"11.11.0","description":"Aurora SendCloud MCP server (local stdio deployment)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^4.3.6","dotenv":"^17.3.1","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.5_1774519817886_0.5066976590149126","host":"s3://npm-registry-packages-npm-production"}},"0.1.6":{"name":"@aurorasendcloud/mcp-server","version":"0.1.6","keywords":[],"author":"","license":"ISC","_id":"@aurorasendcloud/mcp-server@0.1.6","maintainers":[{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"}],"bin":{"asc-mcp-server":"dist/index.js","aurorasendcloud-mcp-server":"dist/index.js"},"dist":{"shasum":"29cc70eadf5aba4696a861094d01c854417e6745","tarball":"https://registry.npmjs.org/@aurorasendcloud/mcp-server/-/mcp-server-0.1.6.tgz","fileCount":11,"integrity":"sha512-Rlh+jy0JZZ5147TY7CjQ9WZ7XEqWPjbtDvZ79g12QMULk6RUI9xEr6dq7bINvphdvqRxRCMXIrf8gCheRvgSbQ==","signatures":[{"sig":"MEYCIQC12nw1k+Fvk3nKnCOpjC60hUqYZk3p1LyOrQxd3ukAugIhAMiDQfOyZcpKptUu63vUd96jkqf8pA2btX69tjzwI0GF","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":43274},"main":"index.js","type":"module","engines":{"node":">=18.17.0"},"scripts":{"dev":"node --loader ts-node/esm src/index.ts","build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js"},"_npmUser":{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"},"_npmVersion":"11.11.0","description":"Aurora SendCloud MCP server (local stdio deployment)","directories":{},"_nodeVersion":"22.14.0","dependencies":{"zod":"^4.3.6","dotenv":"^17.3.1","@modelcontextprotocol/sdk":"^1.26.0"},"_hasShrinkwrap":false,"devDependencies":{"ts-node":"^10.9.2","typescript":"^5.9.3","@types/node":"^24.5.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp-server_0.1.6_1774854007036_0.036233203825886795","host":"s3://npm-registry-packages-npm-production"}},"0.1.7":{"name":"@aurorasendcloud/mcp-server","version":"0.1.7","description":"Aurora SendCloud MCP server (local stdio deployment)","type":"module","bin":{"aurorasendcloud-mcp-server":"dist/index.js","asc-mcp-server":"dist/index.js"},"scripts":{"build":"tsc && node -e \"require('fs').chmodSync('dist/index.js', '755')\"","start":"node dist/index.js","dev":"node --loader ts-node/esm src/index.ts"},"dependencies":{"@modelcontextprotocol/sdk":"^1.26.0","dotenv":"^17.3.1","zod":"^4.3.6"},"devDependencies":{"@types/node":"^24.5.2","ts-node":"^10.9.2","typescript":"^5.9.3"},"engines":{"node":">=18.17.0"},"main":"index.js","keywords":[],"author":"","license":"ISC","_id":"@aurorasendcloud/mcp-server@0.1.7","_nodeVersion":"22.14.0","_npmVersion":"11.11.0","dist":{"integrity":"sha512-yBI+g2Qk0uwSuCZNMBUPyrqxN7Q2oCcjK41Aqou1bKdJL1wJgQ40gYpILphrGz+5nwFjHN5xnSG1v7Dnroxr5Q==","shasum":"bc56ee12d139399f8086a6a77ffe66521444d9cc","tarball":"https://registry.npmjs.org/@aurorasendcloud/mcp-server/-/mcp-server-0.1.7.tgz","fileCount":11,"unpackedSize":43266,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIH9UI9U2aToedvYX3+2DT6nN7hMlimd8VDmRCY5gs9eRAiEA5teAcwpX1tyiryYGtYwgj4L01swhoCc0VxeVI4cZTKc="}]},"_npmUser":{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"},"directories":{},"maintainers":[{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.7_1774854198507_0.9060755549370592"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-25T08:02:58.373Z","modified":"2026-03-30T07:03:18.772Z","0.1.0":"2026-03-25T08:02:58.657Z","0.1.1":"2026-03-26T07:36:07.001Z","0.1.2":"2026-03-26T07:44:21.049Z","0.1.3":"2026-03-26T08:38:12.648Z","0.1.4":"2026-03-26T08:56:34.800Z","0.1.5":"2026-03-26T10:10:18.048Z","0.1.6":"2026-03-30T07:00:07.176Z","0.1.7":"2026-03-30T07:03:18.654Z"},"license":"ISC","keywords":[],"description":"Aurora SendCloud MCP server (local stdio deployment)","maintainers":[{"name":"aurorasendcloud","email":"fuqiang@sendcloud.im"}],"readme":"# [Aurora SendCloud](https://www.aurorasendcloud.com/) MCP Server\n[![MCP](https://img.shields.io/badge/MCP-Server-blue.svg)](https://github.com/modelcontextprotocol)\n\n## Overview\nA [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server for [Aurora SendCloud](https://www.aurorasendcloud.com/), enabling MCP-compatible AI clients to send emails and query deliverability analytics.\n\n> **Note:** This MCP server runs locally on your machine. [Aurora SendCloud](https://www.aurorasendcloud.com/) does not currently provide a hosted MCP server.\n\n## What can it do?\n\nThis MCP server keeps the tool surface small (`send_email`, `get_email_status`, `get_send_statistics`, `get_account_quota`) but each tool supports multiple operation modes and richer analysis output.\n\n### Capabilities\n\n- **Messaging** - Send transactional emails\n- **Message Tracking** - Query per-message delivery status\n- **Statistics** - Query daily/hourly/invalid classification metrics by period or date range\n- **Account Quota** - Query account daily quota and usage\n\n## Prerequisites\n\n- Node.js (v18.17 or higher)\n- [Aurora SendCloud](https://www.aurorasendcloud.com/) account ([API_USER](https://docs.aurorasendcloud.com/docs/api-user) + [API_KEY](https://docs.aurorasendcloud.com/docs/api-user))\n\n## Quick Start\n\n### Configuration\n\nAdd the following to your MCP client configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"aurorasendcloud\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@aurorasendcloud/mcp-server\"],\n      \"env\": {\n        \"SENDCLOUD_API_USER\": \"YOUR_API_USER\",\n        \"SENDCLOUD_API_KEY\": \"YOUR_API_KEY\",\n        \"SENDCLOUD_REGION\": \"sg\"\n      }\n    }\n  }\n}\n```\n\n#### Environment Variables\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `SENDCLOUD_API_USER` | Yes | N/A | [Aurora SendCloud](https://www.aurorasendcloud.com/) [API_USER](https://docs.aurorasendcloud.com/docs/api-user) |\n| `SENDCLOUD_API_KEY` | Yes | N/A | [Aurora SendCloud](https://www.aurorasendcloud.com/) [API_KEY](https://docs.aurorasendcloud.com/docs/api-user) |\n| `SENDCLOUD_REGION` | No | `sg` | Region: `sg` / `us` / `hk` |\n| `SENDCLOUD_BASE_URL` | No | N/A | Custom API base URL (highest priority) |\n\n#### Region Mapping\n\n- `sg` => `https://api.aurorasendcloud.com`\n- `us` => `https://api-us.aurorasendcloud.com`\n- `hk` => `https://api-hk.aurorasendcloud.com`\n\n#### Client-Specific Config Paths\n\n- **Claude Desktop** (macOS): `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Claude Desktop** (Windows): `%APPDATA%/Claude/claude_desktop_config.json`\n- **Claude Code**: Run `claude mcp add` or edit `~/.claude.json`\n\n## Tools\n\n- `send_email`\n- `get_email_status`\n- `get_send_statistics`\n- `get_account_quota`\n\n## What does it look like in action?\n\nTypical workflow in an MCP client:\n\n1. Send a campaign or template email with `send_email`.\n2. Track delivery/opens/clicks with `get_email_status` (`include_tracking=true`).\n3. Pull daily or hourly trends with `get_send_statistics`.\n4. Check quota risk with `get_account_quota` (`include_health=true`).\n\n## Sample Prompts\n\n#### Send an Email\n```\nSend an email from postmaster@example.com to user@example.com with subject \"Welcome\" and a short HTML body.\n```\n\n#### Fetch Statistics\n```\nGet send statistics for the last 7 days for domain example.com and summarize delivery, open, and bounce trends.\n```\n\n#### Compare Domains\n```\nGet last month statistics grouped by domain and compare deliveredNum and bounceNum.\n```\n\n#### Check Quota\n```\nCheck my account quota and tell me if I'm at risk of hitting limits today.\n```\n\n## Development\n\nTo run from source:\n\n```bash\ngit clone <your-repository-url>\ncd aurorasendcloud-mcp\nnpm install\nnpm run build\nnpm run start\n```\n\nIn MCP client config, use:\n\n```json\n{\n  \"mcpServers\": {\n    \"aurorasendcloud\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/aurorasendcloud-mcp/dist/index.js\"],\n      \"env\": {\n        \"SENDCLOUD_API_USER\": \"YOUR_API_USER\",\n        \"SENDCLOUD_API_KEY\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\n## Security Considerations\n\n### API credential isolation\n\nCredentials are provided through environment variables or per-tool inputs and only used by the local MCP server process for Aurora API requests.\n\n### Local execution\n\nThe server runs locally and communicates with Aurora APIs over HTTPS.\n\n### Least-privilege credentials\n\nUse dedicated API credentials with minimal required permissions.\n\n### Prompt injection\n\nAs with any MCP server, untrusted prompts could induce unintended tool calls. Review tool call confirmations in your MCP client.\n\n## Debugging\n\nThe MCP server communicates over `stdio`. Refer to the [MCP Debugging Guide](https://modelcontextprotocol.io/docs/tools/debugging).\n\n## License\n\nISC\n","readmeFilename":"README.md"}