Telep MuseConnector catalog
Telep IO · PaperSend

API & MCP documentation

PDF → physical mail. Print, envelope, and First Class postage in the US.

Demo gateway: creating a job does not print, mail, or charge anything. Jobs are created with status “stubbed”. The live print-and-mail app lives in services/paper-send in this repository; provider fulfillment is not wired into this gateway.

Connecting

MCP endpoint
https://api.muse.telep.io/mcp/paper-send — streamable HTTP, JSON-RPC 2.0. Methods: initialize, tools/list, tools/call.
REST base
https://api.muse.telep.io/v1/paper-send
OpenAPI
https://api.muse.telep.io/v1/paper-send/openapi.json — exact request/response shapes for every REST route.
Auth
Authorization: Bearer <api-key> on every call. Calls are scoped to the key.

MCP tools

check_credentials

Validate PaperSend Lob (and Stripe, if set) credentials. Read-only: lists Lob addresses and does not create a letter. Demo mode skips the provider.

Takes no parameters.

create_mail_job

Create a PaperSend draft job to print and mail a PDF in the US. Returns a review URL. Does not mail anything — the human must review and pay. Demo mode stores a stub. test/live mode still does not call Lob to print.

ParameterTypeRequiredDescription
senderobjectyes—
recipientobjectyes—
documentobjectno—

get_job

Get a PaperSend job you created on this API key.

ParameterTypeRequiredDescription
idstringyes—

list_jobs

List PaperSend jobs created with this API key.

Takes no parameters.

Example: list tools over MCP

curl -X POST https://api.muse.telep.io/mcp/paper-send   -H "Authorization: Bearer $TELEP_API_KEY"   -H "Content-Type: application/json"   -H "Accept: application/json, text/event-stream"   -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/list",
  "params": {}
}'

REST example

Create via POST https://api.muse.telep.io/v1/paper-send/jobs:

curl -X POST https://api.muse.telep.io/v1/paper-send/jobs   -H "Authorization: Bearer $TELEP_API_KEY"   -H "Content-Type: application/json"   -d '{"sender":{"name":"example","address_line1":"example","address_city":"example","address_state":"example","address_zip":"example"},"recipient":{"name":"example","address_line1":"example","address_city":"example","address_state":"example","address_zip":"example"}}'

Every REST route is described exactly in the OpenAPI document.

Demo status

Demo gateway: creating a job does not print, mail, or charge anything. Jobs are created with status “stubbed”. The live print-and-mail app lives in services/paper-send in this repository; provider fulfillment is not wired into this gateway.

Pricing: $4.99 first page, $0.25 each additional page. US letter, 1–5 pages. Nothing is billed while the gateway is a stub.

Related