API & MCP documentation
Robot-handwritten letters and cards, mailed for you.
Demo gateway: letters are drafts only — nothing is mailed. Planned provider: Handwrytten (not wired; resale terms unconfirmed).
Connecting
- MCP endpoint
https://api.muse.telep.io/mcp/ink-send— streamable HTTP, JSON-RPC 2.0. Methods:initialize,tools/list,tools/call.- REST base
https://api.muse.telep.io/v1/ink-send- OpenAPI
https://api.muse.telep.io/v1/ink-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 the Handwrytten API key via getUser. Does not order a card. Demo mode skips the provider.
Takes no parameters.
create_letter
Create an InkSend draft letter — a handwritten-style note mailed via a handwritten-mail provider. Does not mail anything: the human must review the exact message, recipient address, card choice, and $3.99 price and pay before mailing. Status 'sent' means accepted for mailing, not delivered (First Class is untracked). Gateway fulfillment is currently stubbed.
| Parameter | Type | Required | Description |
|---|---|---|---|
message | string | yes | Letter text, max 5000 characters |
to | object | yes | Recipient name and postal address |
card | string | no | — |
handwriting_style | string | no | — |
get_letter
Get an InkSend letter you created on this API key (status: draft, paid, sent).
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | — |
list_letters
List InkSend letters created with this API key.
Takes no parameters.
Example: list tools over MCP
curl -X POST https://api.muse.telep.io/mcp/ink-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/ink-send/letters:
curl -X POST https://api.muse.telep.io/v1/ink-send/letters -H "Authorization: Bearer $TELEP_API_KEY" -H "Content-Type: application/json" -d '{"message":"example","to":{"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: letters are drafts only — nothing is mailed. Planned provider: Handwrytten (not wired; resale terms unconfirmed).
Pricing: $3.99 per letter (planned). Nothing is billed while the gateway is a stub.
Related
- InkSend overview — https://muse.telep.io/connectors/ink-send
- Privacy policy
- Terms of service