@mailagent/mcp
v0.2.16
Published
MailAgent MCP server (stdio) for Cursor and AI agents — email verification inboxes
Maintainers
Readme
@mailagent/mcp
MCP server (stdio) for Cursor and other MCP clients.
Cursor: recommendations
| What | Recommendation |
|-----|----------------|
| Protocol | MCP — open standard, Cursor = client |
| SDK | @modelcontextprotocol/sdk + zod |
| Transport for local dev | stdio (Cursor spawns the process) |
| Config | .cursor/mcp.json (project) or ~/.cursor/mcp.json (global) |
| Secrets | env / envFile in mcp.json, not in chat |
| Logs | stderr only |
Cursor docs: Model Context Protocol (Settings → MCP → Add server).
There is no separate «Cursor SDK for MCP» — you write a normal MCP server; Cursor connects it as a subprocess.
Build
npm install
npm run buildVariables
MAILAGENT_API_URL— Worker base URL (defaulthttp://127.0.0.1:8787)MAILAGENT_API_KEY— Bearer token (= WorkerAPI_KEY)
Local run (debug)
MAILAGENT_API_URL=http://127.0.0.1:8787 MAILAGENT_API_KEY=xxx node dist/index.jsProcess waits for JSON-RPC on stdin; for testing use Cursor MCP logs.
OpenAI Codex
Codex reads MCP from ~/.codex/config.toml or plugin (bundled .mcp.json).
| Method | File | |--------|------| | config.toml (stdio / remote HTTP) | examples/codex/config.toml.example | | Local plugin | examples/codex/plugin/ | | Full plan | docs/CODEX.md |
codex mcp add mailagent -- npx -y -p @mailagent/[email protected] mailagent-mcp
export MAILAGENT_API_KEY=...
export MAILAGENT_API_URL=https://api.webmailagent.comRemote (no subprocess): url = "https://api.webmailagent.com/mcp" + Authorization: Bearer ….
