Connect Cursor
Use Rampsend from Cursor
Cursor reads MCP servers from an mcp.json file, globally or per project. Add the Rampsend endpoint and the agent can send test emails, check deliveries and verify your domain while it builds your email flows.
Paste as the server url in ~/.cursor/mcp.json
https://app.rampsend.com/api/mcpSet it up
- 1
Open the MCP settings
Open Customize in the sidebar, then click MCPs. Older builds put it under Cursor Settings → Tools & Integrations.
- 2
Add a custom MCP server
The Add button opens mcp.json for editing. You can also edit it directly: ~/.cursor/mcp.json for every project, or <project>/.cursor/mcp.json for one.
- 3
Paste the entry
Use the block below. For sign-in instead of a key, delete the headers object so Cursor sees the 401 and starts the OAuth flow.
- 4
Save and connect
The server appears in the list. If it needs sign-in, click Connect and approve in the browser. A green dot and a visible tool list mean it is live.
The config
File: ~/.cursor/mcp.json
{ "mcpServers": { "rampsend": { "url": "https://app.rampsend.com/api/mcp", "headers": { "Authorization": "Bearer ${env:RAMPSEND_API_KEY}" } } }}Export RAMPSEND_API_KEY in the environment Cursor itself was launched from — a launch from the Dock or Start menu often does not read your shell profile.
Check it works
Ask “How many Rampsend credits do I have left?”. A number back means you are connected. That call only reads your account, so testing costs nothing.
What trips people up
- The field is url. serverUrl is another editor’s spelling and Cursor will not pick it up — the usual cause of a server that never connects.
- Remote entries have no type field. The presence of url is what makes it remote; adding "type": "stdio" breaks it.
- If the Connect button does nothing, use the bearer header form above. There have been recurring reports of the OAuth button not opening a browser for remote servers.
- Never commit .cursor/mcp.json with a literal key in it. Keep the ${env:RAMPSEND_API_KEY} form and have each person export their own key.
- Cursor caps how many MCP tools can be on at once. If you run several servers, switch off the tools you do not need.
Try asking
- “Send a test of this welcome template to me@acme.com from hello@acme.com.”
- “Did the password-reset email to ada@example.com get delivered?”
- “Check whether acme.com is ready to send from and list any missing DNS records.”
- “How many Rampsend credits do I have left?”