API & MCP documentation
Send faxes from a PDF, with an optional cover page.
Demo gateway: fax jobs are drafts only — nothing transmits. Planned provider: Sinch Fax API v3 (not wired).
Connecting
- MCP endpoint
https://api.muse.telep.io/mcp/fax-send— streamable HTTP, JSON-RPC 2.0. Methods:initialize,tools/list,tools/call.- REST base
https://api.muse.telep.io/v1/fax-send- OpenAPI
https://api.muse.telep.io/v1/fax-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 fax provider credentials. Does not transmit a fax. Demo mode skips the provider.
Takes no parameters.
create_fax
Create a FaxSend draft for transmitting a fax to a phone number ($0.99 per transmitted page, up to 10 PDF pages, optional billable cover page). Returns a review URL. Does not transmit anything — the human must review the document, destination, page count, and price and pay. Gateway fulfillment is currently stubbed.
| Parameter | Type | Required | Description |
|---|---|---|---|
to | string | yes | Destination phone number in E.164 format (e.g. +15550100) |
document | object | yes | — |
coverPage | boolean | no | Include a reviewed cover page (counts as a billable page) |
get_fax
Get a FaxSend fax you created on this API key (status: draft, paid, sending, delivered, failed).
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | — |
list_faxes
List FaxSend faxes created with this API key.
Takes no parameters.
Example: list tools over MCP
curl -X POST https://api.muse.telep.io/mcp/fax-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/fax-send/faxes:
curl -X POST https://api.muse.telep.io/v1/fax-send/faxes -H "Authorization: Bearer $TELEP_API_KEY" -H "Content-Type: application/json" -d '{"to":"+15555550100","document":{"pages":1}}'Every REST route is described exactly in the OpenAPI document.
Demo status
Demo gateway: fax jobs are drafts only — nothing transmits. Planned provider: Sinch Fax API v3 (not wired).
Pricing: $0.99 per page (planned). Nothing is billed while the gateway is a stub.
Related
- FaxSend overview — https://muse.telep.io/connectors/fax-send
- Privacy policy
- Terms of service