Send Letters from Cursor
Cursor's MCP support means your IDE-resident agent can take real-world actions. Here's how to wire Mailsnail in so Cursor can put a letter in the mail.
· Updated
Setup
Add Mailsnail to ~/.cursor/mcp.json (or your project's .cursor/mcp.json):
{
"mcpServers": {
"mailsnail": {
"url": "https://api.mailsnail.dev/mcp"
}
}
}
Cursor prompts you to sign in the first time the server is used. Approve it in the browser and the agent has send_letter and friends available. Nothing to install and no API key.
What this enables
- Customer success workflows where an agent drafts a piece of mail in response to an event in your codebase (a closed support ticket, a successful onboarding milestone).
- Personal assistant flows: ask Cursor to mail a thank-you note based on a meeting transcript in your repo.
- Onboarding kits: Cursor watches for a new user signup in your test data and the agent mails them a welcome letter.
Tips
- Keep recipient addresses in a small JSON file the agent can read. Your prompts get shorter and the agent's tool calls get more reliable.
- For multi-piece flows, have the agent write each
receipt_tokenfromsend_letterto a log file, and check it before queuing more.get_letteron a token tells you where that piece is. - Keep
send_letterbehind Cursor's tool-approval prompt.preview_letteris free, so the agent can show you the proof and price first.
Full setup walkthrough: /setup. Tool reference: /llms-full.txt.
Wire Mailsnail into your agent
Add one URL and sign in. Nothing to install and no API key. In Claude Code:
claude mcp add -t http mailsnail https://api.mailsnail.dev/mcpThen run /mcp and choose Authenticate. In Claude Desktop or ChatGPT, add https://api.mailsnail.dev/mcp as a custom connector. Cursor and other JSON-config clients take:
{
"mcpServers": {
"mailsnail": {
"url": "https://api.mailsnail.dev/mcp"
}
}
}A one-page letter is from $1.21, and preview_letter shows the proof and exact price before anything is charged. Setup for every app →
See also
Send Physical Mail from Claude Code
Wire Mailsnail into Claude Code with one command and your agent can drop letters in the mail. End-to-end setup, tool reference, and a worked example.
MCP Server for Direct Mail
Mailsnail is the Model Context Protocol server that lets any MCP agent send physical letters and certified mail. Connection details, tool list, and pricing.
OpenAI Agents SDK + Physical Mail
Connect Mailsnail to the OpenAI Agents SDK as a stdio MCP server. Code snippet, gotchas, and a practical autonomous-mail example.