Telep IO · FaxSend

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.

ParameterTypeRequiredDescription
tostringyesDestination phone number in E.164 format (e.g. +15550100)
documentobjectyes—
coverPagebooleannoInclude 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).

ParameterTypeRequiredDescription
idstringyes—

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