Skip to main content

CONNECT

Use paperplane in Dust

Justin WinterBy · Updated August 26, 2026

Dust supports remote MCP servers as workspace tools: a workspace admin goes to Spaces → Tools → Add Tool → Add MCP Server, pastes https://sendpaperplane.com/api/mcp, and Dust syncs the three paperplane tools (quote_letter, send_letter, get_letter_status). Any agent the tool is assigned to can then send real USPS mail from $1.99 — with a free sandbox mode for testing.

Dust workspaces can attach remote MCP servers as first-class tools, and paperplane’s endpoint is public and keyless — so giving your Dust agents the ability to mail real letters is a two-minute admin task. To frame it honestly: this is user-side setup. paperplane has no native listing in Dust’s tool catalog yet; you are adding our standard MCP server — the same endpoint every MCP-speaking client uses — through Dust’s bring-your-own-server flow.

Connect it (workspace admin)

  • In Dust, go to Spaces → Tools and click Add Tool, then Add MCP Server.
  • Enter the server URL: https://sendpaperplane.com/api/mcp.
  • Authentication: none needed — the server supports anonymous access, so skip the OAuth and bearer-token options.
  • Let Dust sync; the tool appears with paperplane’s three tools.
  • Assign the tool to the space(s) whose agents should be able to mail letters, then enable it on the agents themselves in their configuration.

What the agent gets

  • quote_letter — free, read-only. Itemized pricing (First-Class $1.99, Certified $12.99, Certified + electronic Return Receipt $14.99, Priority $24.99). Given the real recipient and content, it also mints a single-use confirmation_token bound to that exact letter and price.
  • send_letter — the one write tool: real money, real paper, irreversible once printed. It requires the token and rejects any send that drifted from the quote. Live sends return a Stripe payment link (or draw on a prepaid credit code); sandbox: true runs the whole pipeline free with nothing mailed.
  • get_letter_status — read-only tracking: screening → printing → mailed → delivered.

Sandbox-first walkthrough

After assigning the tool to an agent, test in a conversation with it:

"Quote a one-page certified letter to Maria Alvarez, 1 Main St,
Richmond VA 23220 with the text 'Dust integration test.' Show me the
quote, then send it in sandbox mode and give me the order id."

Expected behavior: the agent calls quote_letter and shows a $12.99 quote with a confirmation_token, then calls send_letter with the identical letter plus sandbox: true, returning a completed ord_test_… order. Address verification, content screening, simulated printing, and tracking all ran; nothing was printed, mailed, or charged. Once the behavior looks right, real sends are the same call without sandbox — a human approves the payment link, or a prepaid credit code makes it hands-off.

Where this fits

Dust agents typically sit on company knowledge and workflows — which is exactly where physical mail shows up as a last mile: a support agent escalating a billing dispute to a certified letter, an ops agent mailing contract termination notices, an assistant that turns a CRM record into a posted welcome note. For flows that would rather call HTTP directly, the same backend is REST (POST /v1/quotes, POST /v1/orders, GET /v1/orders/:id) — see the developer docs. The confirmation-token contract is documented in how AI agents mail letters via MCP and runs live in the no-signup demo.

Related guides

Common questions

Is paperplane an official Dust integration?

No — paperplane is not in Dust’s catalog of one-click tools today. You add it through Dust’s generic remote-MCP-server support, which exists precisely so workspaces can bring their own tools. Setup is one URL, done by a workspace admin.

Who in the workspace can set this up?

Adding a remote MCP server is an admin action. Once added, the admin controls which spaces the tool lives in and therefore which agents and members can use it — a sensible way to keep the send capability scoped to the team that needs it.

Can a Dust agent spend money without a human?

Not by accident. send_letter demands a confirmation_token that only a matching free quote_letter call mints, and live sends return a Stripe payment link for a person to approve. For deliberately unattended sending, a prepaid credit code covers orders from a balance you funded in advance.

What authentication does the connection need?

None — choose the no-auth path. The endpoint supports anonymous access: no OAuth app, no bearer token. Payment happens per order (Stripe link or credit code), not via connection credentials, and sandbox orders need nothing at all.

Use paperplane in Dust

First-Class $1.99 · Certified $12.99 · Certified + Return Receipt $14.99

Read the developer docs