MCP.so
Sign In

Courio MCP ServerVerifiedFeatured

@Benoit

Basic information

Transport

Streamable HTTP

Authentication

None

Category

Other

Author

Benoit

Submitted by

Ben

About Courio MCP Server

Mail a real postal letter worldwide from a PDF or text. No account, pay per letter.

Connection details

https://api.sendcourio.com/mcp

Setup

claude mcp add courio --transport http https://api.sendcourio.com/mcp

Courio MCP Server tools

5

Lists which destination countries and service levels Courio can mail a physical paper letter to, with an indicative "from" price (EUR including VAT, 1 black-and-white page), typical delivery time and the legal product name. No account or API key is needed. Call it before quote_letter to check a destination is served; pass a country (ISO 3166-1 alpha-2, e.g. "DE") to narrow the answer. Service levels: "standard" (ordinary mail, no proof), "tracked" (tracking only), "registered" (registered mail: proof of deposit), "registered_ar" (registered with acknowledgement of receipt: proof of delivery, the one to use for legal notices).

Prices a physical letter (printed, enveloped and posted by Courio) and returns a quote_id. Free and commits to nothing: no account, no payment, nothing is mailed. Give the service level, sender and recipient postal addresses, and the document (pdf_base64, pdf_url, or plain/markdown text). The price is in EUR including VAT (set currency to "USD" to also see a USD price), fixed for 24 hours. The document is checked and content-moderated; a problem comes back as an error with a hint. Quotes are capped per day (limit_exceeded with retry_after): reuse a quote_id rather than re-quoting. Service levels: "standard" (ordinary mail, no proof), "tracked" (tracking only), "registered" (registered mail: proof of deposit), "registered_ar" (registered with acknowledgement of receipt: proof of delivery, the one to use for legal notices). The quote gives the estimated delivery time (estimated_delivery_days). Next step: show the price, the legal product and the terms of sale (terms_url) to the human, then call send_letter if they agree.

Creates the letter for a quote and returns a payment link (Stripe Checkout). No account is needed. YOU CANNOT PAY: show the price and the payment link to the human and ask them to open it and pay. The letter is mailed right after payment and cannot be cancelled or recalled once paid, so paying is the point of no return: make sure the human has seen the price, the recipient and the document first. Calling it again with the same quote_id returns the same letter and link (or its current status once it has been paid). The link expires after about 24 hours. Optionally pass webhook_url (public https) to be notified of status changes. Poll get_letter_status to follow the letter. Autonomous agents whose owner gave them a card through a Stripe Shared Payment Token (e.g. Link) can pay by card themselves with MPP through the REST API (POST /v1/letters with payment_method "mpp", which may be disabled: 422 payment_method_unavailable). Agents that can sign crypto payments can instead pay with x402 through the REST API (POST /v1/letters with payment_method "x402", which may be disabled on this deployment: 422 payment_method_unavailable); official x402 clients cap a payment at $1 by default, so raise the spend limit to cover the quoted price first.

Returns the current status of a letter (awaiting_payment, paid, submitted, in_transit, delivered, failed, expired, ...), its timeline and, once available, proof links (proof of deposit for "registered", proof of delivery for "registered_ar"). No account is needed; the letter_id is the credential. Recipient details are partially redacted unless the request carries the API key that created the letter.

Send feedback to the developers of this server: a feature request, or something the user asked for that these tools can't do. The user can also ask you to send feedback directly.

Overview

Courio prints a PDF (or plain/markdown text) and mails it as a real postal letter to supported countries worldwide: standard, tracked, registered, or registered with acknowledgement of receipt (proof of delivery, for legal notices).

No account, no API key, no subscription. The agent checks coverage, gets a free quote (price fixed for 24 hours), creates the letter and shows the human a Stripe Checkout link. The letter is printed and posted right after payment, and the agent can follow it until delivery.

Agents allowed to pay on their own can use the REST API instead: card via Stripe Shared Payment Tokens (Machine Payments Protocol), or USDC on Base via x402.

Tools:

  • get_coverage: destinations, service levels and indicative prices (read-only)
  • quote_letter: free quote, nothing is mailed
  • send_letter: creates the letter and returns the payment link
  • get_letter_status: follow the letter (read-only)

Docs: https://sendcourio.com/agents

Frequently asked questions

1

What is the Courio remote MCP server?

The Courio remote MCP server is a hosted Model Context Protocol endpoint at https://api.sendcourio.com/mcp, so AI assistants can connect to it without installing or running anything locally.

2

How do I connect to the Courio MCP server?

Add the endpoint https://api.sendcourio.com/mcp to any MCP-compatible client such as Claude Code, Cursor, or VS Code. The setup snippets on this page configure each client in one step.

3

Does the Courio MCP server require authentication?

No. Courio's MCP server does not require authentication — you can connect directly with the endpoint URL.

4

Which transport does the Courio MCP server use?

Courio exposes a Streamable HTTP endpoint, the transport used by remote MCP servers and supported by all major MCP clients.

Comments