Koskamo

Courio MCP

An official MCP server by Courio that enables AI agents to mail real paper letters worldwide. It supports getting quotes, creating letters, and tracking status, with payment handled via Stripe links or autonomous agent payments.

Visit Courio

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

Courio MCP logo, by CourioVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-06Operated by Courio
MCP endpoint (Streamable HTTP)
https://api.courio.si/mcp
Vendor documentation

What its tools do

4 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (2)

Can change data (2)

4 of 4 have a description · 4 of 4 declare behavior hints · 1 of 4 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to courio.si ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Get a quote for mailing a letter to a specific country
  • Create and submit a letter with a PDF document
  • Track the status and delivery proof of a mailed letter

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: si.courio/courio@1.0.0Project website

Protocol and capabilities

Server
courio 1.0.0
MCP protocol negotiated in check
2025-11-25
Tools
4 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Tools

4 advertised

get_coverage — Check coverage and indicative prices
Advertised by the server during the last successful anonymous check.
Advertised read-only

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).

get_coverage input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 code, e.g. \"DE\"; omit for every country"
    }
  }
}
get_coverage annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quote_letter — Get a free quote for a letter
Advertised by the server during the last successful anonymous check.

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.

quote_letter input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "service",
    "sender",
    "recipient",
    "document"
  ],
  "properties": {
    "sender": {
      "type": "object",
      "required": [
        "name",
        "address_lines",
        "postal_code",
        "city",
        "country"
      ],
      "properties": {
        "city": {
          "type": "string",
          "maxLength": 60,
          "minLength": 1
        },
        "name": {
          "type": "string",
          "maxLength": 80,
          "minLength": 1
        },
        "email": {
          "type": "string",
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        "company": {
          "type": "string",
          "maxLength": 80
        },
        "country": {
          "type": "string"
        },
        "postal_code": {
          "type": "string",
          "maxLength": 16
        },
        "address_lines": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 80
          },
          "maxItems": 3,
          "minItems": 1
        }
      }
    },
    "options": {
      "type": "object",
      "default": {
        "color": false,
        "duplex": true
      },
      "properties": {
        "color": {
          "type": "boolean",
          "default": false
        },
        "duplex": {
          "type": "boolean",
          "default": true
        }
      }
    },
    "service": {
      "enum": [
        "standard",
        "tracked",
        "registered",
        "registered_ar"
      ],
      "type": "string"
    },
    "currency": {
      "enum": [
        "EUR",
        "USD"
      ],
      "type": "string",
      "default": "EUR"
    },
    "document": {
      "anyOf": [
        {
          "type": "object",
          "required": [
            "pdf_base64"
          ],
          "properties": {
            "pdf_base64": {
              "type": "string",
              "minLength": 1
            }
          },
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "pdf_url"
          ],
          "properties": {
            "pdf_url": {
              "type": "string",
              "format": "uri"
            }
          },
          "additionalProperties": false
        },
        {
          "type": "object",
          "required": [
            "text"
          ],
          "properties": {
            "text": {
              "type": "string",
              "minLength": 1
            },
            "format": {
              "enum": [
                "plain",
                "markdown"
              ],
              "type": "string",
              "default": "plain"
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "recipient": {
      "type": "object",
      "required": [
        "name",
        "address_lines",
        "postal_code",
        "city",
        "country"
      ],
      "properties": {
        "city": {
          "type": "string",
          "maxLength": 60,
          "minLength": 1
        },
        "name": {
          "type": "string",
          "maxLength": 80,
          "minLength": 1
        },
        "email": {
          "type": "string",
          "format": "email",
          "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
        },
        "company": {
          "type": "string",
          "maxLength": 80
        },
        "country": {
          "type": "string"
        },
        "postal_code": {
          "type": "string",
          "maxLength": 16
        },
        "address_lines": {
          "type": "array",
          "items": {
            "type": "string",
            "maxLength": 80
          },
          "maxItems": 3,
          "minItems": 1
        }
      }
    }
  }
}
quote_letter annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
send_letter — Create the letter and get the payment link
Advertised by the server during the last successful anonymous check.
Open-world

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.

send_letter input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "quote_id"
  ],
  "properties": {
    "quote_id": {
      "type": "string",
      "pattern": "^qt_[0-9A-Za-z]{24}$"
    },
    "webhook_url": {
      "type": "string",
      "format": "uri",
      "description": "Public https URL notified on each status change"
    }
  }
}
send_letter annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
get_letter_status — Follow a letter
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_letter_status input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "letter_id"
  ],
  "properties": {
    "letter_id": {
      "type": "string",
      "pattern": "^ltr_[0-9A-Za-z]{24}$"
    }
  }
}
get_letter_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (1 of 1 answered).

  1. 2026-11-07: 1 of 1 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1077 ms
95th percentile latency
1077 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1077 ms · metadata changed · 4 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http courio-mcp https://api.courio.si/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add courio-mcp --url https://api.courio.si/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable courio-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "courio-mcp": {
      "url": "https://api.courio.si/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "courio-mcp": {
      "type": "streamableHttp",
      "url": "https://api.courio.si/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start courio-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "courio-mcp": {
      "type": "http",
      "url": "https://api.courio.si/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http courio-mcp https://api.courio.si/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.courio.si/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "courio-mcp": {
      "serverUrl": "https://api.courio.si/mcp"
    }
  }
}

Let your agent find its tools

Find servers like Courio MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 5,453

Do you run Courio MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing