{"_id":"@codespar/mcp-sendgrid","_rev":"5-63bf38c4ca61ca5eb1ee9d957957b3e1","name":"@codespar/mcp-sendgrid","dist-tags":{"latest":"0.2.2"},"versions":{"0.1.0":{"name":"@codespar/mcp-sendgrid","version":"0.1.0","keywords":["mcp","sendgrid","twilio","email","transactional-email","marketing-email","smtp","contacts","templates","suppressions","communication"],"license":"MIT","_id":"@codespar/mcp-sendgrid@0.1.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-sendgrid":"dist/index.js"},"dist":{"shasum":"156b2ede74f1a967c2410fdd53f3571546c464e2","tarball":"https://registry.npmjs.org/@codespar/mcp-sendgrid/-/mcp-sendgrid-0.1.0.tgz","fileCount":6,"integrity":"sha512-MXMUMkkyPxvaC+36pSic8JKfRZM02q3U9FoEn7pAAxYKnO+WD00i23RXSqYF5hDbKldr1ssuTGWKatw2Flh5mQ==","signatures":[{"sig":"MEQCIFBHqtz4gi0QWGF/5CoTbOOLMOKfQrREloTzBzaWhVk2AiANSc7li6XgulecYc5kW7UiiRRfCkhrroGYSAQq0b7bcg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45200},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"b2ef93b78816f2643cd387941a09940b2d7619e9","mcpName":"io.github.codespar/mcp-sendgrid","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for SendGrid — global transactional + marketing email (Twilio-owned). Pairs with @codespar/mcp-twilio for full messaging coverage.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-sendgrid_0.1.0_1776996454984_0.3087126484845095","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@codespar/mcp-sendgrid","version":"0.2.0","keywords":["mcp","sendgrid","twilio","email","transactional-email","marketing-email","smtp","contacts","templates","suppressions","communication"],"license":"MIT","_id":"@codespar/mcp-sendgrid@0.2.0","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-sendgrid":"dist/index.js"},"dist":{"shasum":"fb518b15b9fce8292f91dbe4a1e8e7260a2b2c18","tarball":"https://registry.npmjs.org/@codespar/mcp-sendgrid/-/mcp-sendgrid-0.2.0.tgz","fileCount":6,"integrity":"sha512-HCdQ/W1NdEEtYJMTlWG/DSz3k+uMTbc1IFFrjvRulW92o1dhV2DM5GsWU6M8CW0umBSn1fO7JFf9H8mtNs6hPA==","signatures":[{"sig":"MEQCIGdmJ+UzT0rnOCtDRyih0L1SjjTn5D8OZRI7+OI7LfeDAiBZejGuSbG5PaJnoAlZugKNdSsMHrgPT/6v3fQkjlc64w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":60672},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"475d6a412c639d70728792f31d502e9268bb06bb","mcpName":"io.github.codespar/mcp-sendgrid","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for SendGrid — global transactional + marketing email (Twilio-owned). Pairs with @codespar/mcp-twilio for full messaging coverage.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-sendgrid_0.2.0_1777042999300_0.13610792667245342","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"name":"@codespar/mcp-sendgrid","version":"0.2.1","keywords":["mcp","sendgrid","twilio","email","transactional-email","marketing-email","smtp","contacts","templates","suppressions","communication"],"license":"MIT","_id":"@codespar/mcp-sendgrid@0.2.1","maintainers":[{"name":"codespar-npm","email":"contact@codespar.dev"}],"bin":{"mcp-sendgrid":"dist/index.js"},"dist":{"shasum":"13a8c4bbc5640d98f3e0135cf7f04d3322d96533","tarball":"https://registry.npmjs.org/@codespar/mcp-sendgrid/-/mcp-sendgrid-0.2.1.tgz","fileCount":6,"integrity":"sha512-GdHW+vlujencsjRqyLcAL2nigoKPjFL3J1/Px4QWU3/QNjPJbok5AOWEpCvATLK4VsRwY5ao0ucqVpRHYytFMg==","signatures":[{"sig":"MEUCIQCwvAjfawPCQX24P1KruxsDQhkn9jmhhLQWo5hrg6NrpgIgFqCZsFejKG9CX+TE3NhZcJ4O8ZgWhhhVDGa4ZbxVhF0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":61498},"main":"./dist/index.js","type":"module","types":"./dist/index.d.ts","gitHead":"0ab801a863239f0cb986bbda65abbaee3c621b44","mcpName":"io.github.codespar/mcp-sendgrid","scripts":{"build":"tsc","start":"node dist/index.js"},"_npmUser":{"name":"codespar-npm","email":"contact@codespar.dev"},"_npmVersion":"11.8.0","description":"MCP server for SendGrid — global transactional + marketing email (Twilio-owned). Pairs with @codespar/mcp-twilio for full messaging coverage.","directories":{},"_nodeVersion":"25.5.0","dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^5.8.0","@types/node":"^25.5.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp-sendgrid_0.2.1_1777122978009_0.9363282882508182","host":"s3://npm-registry-packages-npm-production"}},"0.2.2":{"name":"@codespar/mcp-sendgrid","version":"0.2.2","description":"MCP server for SendGrid — global transactional + marketing email (Twilio-owned). Pairs with @codespar/mcp-twilio for full messaging coverage.","type":"module","main":"./dist/index.js","bin":{"mcp-sendgrid":"dist/index.js"},"scripts":{"build":"tsc","start":"node dist/index.js"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0"},"devDependencies":{"@types/node":"^25.5.0","typescript":"^5.8.0"},"license":"MIT","keywords":["mcp","sendgrid","twilio","email","transactional-email","marketing-email","smtp","contacts","templates","suppressions","communication"],"mcpName":"io.github.codespar/mcp-sendgrid","_id":"@codespar/mcp-sendgrid@0.2.2","gitHead":"e8f2ad023876683538fe7b66a2fc88ab8d8ef92f","types":"./dist/index.d.ts","_nodeVersion":"22.22.3","_npmVersion":"10.9.8","dist":{"integrity":"sha512-yX9+cZcGkfqWB1s+9iD1BCezWerZfLLIUY3+865CTRkvekMaNeHM7DCr8HroqQl9Y5L71TtC9+wH+i6g3aszqA==","shasum":"160d89dbda77b3cf9b63661df535fe4dc3c78eba","tarball":"https://registry.npmjs.org/@codespar/mcp-sendgrid/-/mcp-sendgrid-0.2.2.tgz","fileCount":6,"unpackedSize":62936,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIHanII16Xlg8Phi68QdIcED9vHmEAXcvN3/AQeRddZtPAiEA/czNGDs3MfgIgtfPgM+biyWWKiTDzwoMrnOPpn1xz2M="}]},"_npmUser":{"name":"codespar-npm","email":"fabiano@codespar.dev"},"directories":{},"maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-sendgrid_0.2.2_1782153456920_0.5656916666650862"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T02:07:34.881Z","modified":"2026-06-22T18:37:37.196Z","0.1.0":"2026-04-24T02:07:35.135Z","0.2.0":"2026-04-24T15:03:19.444Z","0.2.1":"2026-04-25T13:16:18.200Z","0.2.2":"2026-06-22T18:37:37.066Z"},"license":"MIT","keywords":["mcp","sendgrid","twilio","email","transactional-email","marketing-email","smtp","contacts","templates","suppressions","communication"],"description":"MCP server for SendGrid — global transactional + marketing email (Twilio-owned). Pairs with @codespar/mcp-twilio for full messaging coverage.","maintainers":[{"name":"codespar-npm","email":"fabiano@codespar.dev"},{"name":"dangazineu","email":"daniel.gazineu@gmail.com"}],"readme":"# @codespar/mcp-sendgrid\n\nMCP server for [SendGrid](https://sendgrid.com) — global transactional and marketing email.\n\nSendGrid is Twilio-owned (acquired 2019). Together with [`@codespar/mcp-twilio`](../twilio) this package closes the messaging loop:\n\n- **Twilio** — SMS, WhatsApp, Voice, Verify\n- **SendGrid** — email (transactional + marketing)\n\nAgents building commerce notification flows — order confirmations, shipping updates, abandoned-cart nudges, promos — can now cover every channel through two packages.\n\n## Tools (20)\n\n| Tool | Purpose |\n|---|---|\n| `send_mail` | Send an email via POST /mail/send. |\n| `send_template` | Convenience wrapper for POST /mail/send with a dynamic template. |\n| `add_contact` | Upsert contacts in Marketing Campaigns via PUT /marketing/contacts. |\n| `list_contacts` | List Marketing Campaigns contacts via GET /marketing/contacts. |\n| `delete_contact` | Delete contacts by id via DELETE /marketing/contacts?ids=.... |\n| `search_contacts` | Search contacts with an SGQL query via POST /marketing/contacts/search. |\n| `get_contact` | Retrieve a single Marketing Campaigns contact by id via GET /marketing/contacts/{id}. |\n| `list_lists` | List all Marketing Campaigns contact lists via GET /marketing/lists. |\n| `create_list` | Create a Marketing Campaigns contact list via POST /marketing/lists. |\n| `delete_list` | Delete a Marketing Campaigns contact list via DELETE /marketing/lists/{id}. |\n| `list_templates` | List transactional templates via GET /templates. |\n| `create_template` | Create a transactional template via POST /templates. |\n| `list_suppressions` | List all suppressed recipients for an unsubscribe group via GET /asm/groups/{group_id}/suppressions. |\n| `add_suppression` | Add recipients to a suppression group via POST /asm/groups/{group_id}/suppressions. |\n| `list_unsubscribe_groups` | List all unsubscribe groups on the account via GET /asm/groups. |\n| `get_bounces` | Retrieve bounced recipients via GET /suppression/bounces. |\n| `delete_bounce` | Remove a bounced address from the bounce suppression list via DELETE /suppression/bounces/{email}. |\n| `cancel_scheduled_send` | Cancel or pause a scheduled send by batch_id via POST /user/scheduled_sends. |\n| `get_event_webhook_settings` | Retrieve the Event Webhook configuration via GET /user/webhooks/event/settings. |\n| `get_stats` | Global email stats via GET /stats. |\n\n## Install\n\n```bash\nnpm install @codespar/mcp-sendgrid\n```\n\n## Environment\n\n```bash\nSENDGRID_API_KEY=\"SG....\"         # required (secret)\nSENDGRID_FROM_EMAIL=\"no-reply@yourdomain.com\"   # optional default sender\n```\n\nThe `SENDGRID_FROM_EMAIL` must be either a Verified Sender or belong to an authenticated domain.\n\n## Authentication\n\nBearer-token auth. The server handles this automatically.\n\n```\nAuthorization: Bearer <SENDGRID_API_KEY>\n```\n\n## API surface\n\n- Base URL: `https://api.sendgrid.com/v3`\n- All requests/responses are `application/json`\n- `POST /mail/send` returns `202 Accepted` on success (no body)\n\n## Send with a dynamic template\n\n```json\n{\n  \"to\": \"buyer@example.com\",\n  \"template_id\": \"d-abc123...\",\n  \"dynamic_template_data\": {\n    \"order_id\": \"1001\",\n    \"total_brl\": \"R$ 249,90\",\n    \"tracking_url\": \"https://example.com/track/1001\"\n  }\n}\n```\n\n## Run\n\n```bash\n# stdio (default — for Claude Desktop, Cursor, etc)\nnpx @codespar/mcp-sendgrid\n\n# HTTP (for server-to-server testing)\nMCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-sendgrid\n```\n\n## Pairs with\n\n- [`@codespar/mcp-twilio`](../twilio) — SMS, WhatsApp, Voice, Verify, Lookup\n\n## Enterprise\n\nNeed governance, budget limits, and audit trails for agent payments? [CodeSpar Enterprise](https://codespar.dev/enterprise) adds policy engine, payment routing, and compliance templates on top of these MCP servers.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}