Skip to main content

Send a letter from Windsurf.

Add paperplane to Windsurf’s mcp_config.json and it can quote and send a real USPS letter — no account required, free sandbox mode included.

Free to preview — see the exact PDF before you pay. Sending starts at $1.99, no account required.

Set it up in Windsurf

Step 1

Add to ~/.codeium/windsurf/mcp_config.json

The field is "serverUrl", not "url".

{
  "mcpServers": {
    "paperplane": { "serverUrl": "https://sendpaperplane.com/api/mcp" }
  }
}

Try it: free, nothing mailed

Tell your agent:

Using the paperplane tools, quote a 1-page certified letter to Property LLC, 1 Main St, Richmond VA 23220, then send it in sandbox mode.

Not on Windsurf? Any surface works.

The same three calls from the CLI, any MCP client or plain REST. Sandbox is free and mails nothing.

Send a letter
{
  "mcpServers": {
    "paperplane": { "serverUrl": "https://sendpaperplane.com/api/mcp" }
  }
}

All agents · API docs

Common questions

Is Windsurf’s config field different from other clients?

Yes — Windsurf uses "serverUrl", not "url", in ~/.codeium/windsurf/mcp_config.json. Copy the exact block above rather than adapting another client’s config.

What can Windsurf do with it?

It gets three letter tools — quote_letter, send_letter, and get_letter_status — plus a buy_credits tool for pre-funding sends. Postcards (4x6/6x9/6x11, message-only, from $1.99) are live too, reachable today via the REST API’s format field — MCP tool support for them is not wired up yet.

How much does sending cost?

Letters start at $1.99 for First-Class; Certified Mail starts at $12.99. Every quote shows the exact total before you approve anything, and sandbox mode is free.