# Saperly **Canonical:** https://apis.io/providers/saperly/ **Website:** https://saperly.com **APIs profiled:** 3 Saperly is the phone carrier for AI agents: one API call gives an agent a real phone number with inbound and outbound voice and SMS, routing to a hosted in-network voice agent or to your own runtime (manual mode), and TCPA compliance enforced in the carrier layer — AI disclosure, consent records, 10DLC brand/campaign registration and an append-only audit trail. The v2 REST API at api.saperly.com (48 operations, OpenAPI 3.2) covers numbers, connections, messaging, voice, voices, consent, pricing quotes, usage and ceiling-bounded scoped API keys; a remote MCP server at api.saperly.com/mcp (Streamable HTTP, OAuth 2.1 or sap_sk_ bearer) exposes the same surface as tools, with official Node and Python SDKs, signed webhooks and prepaid usage-based pricing. ## Kin Score — 57.7 / 100 (strong) Scored 2026-10-09 under rubric 0.23.0. | Facet | Score | |---|---| | Discoverability | 70.0 | | Contract Quality | 59.9 | | Contract Governance | 35.6 | | Operational Transparency | 23.7 | | Developer Ergonomics | 61.3 | | Access Clarity | 65.8 | Regulatory layer — **Telecommunications**: 40.0 (matched via tags). ## Agent readiness — 56.9 (agent-native) | Dimension | Value | |---|---| | Spec Presence | yes | | Agentic Access | derived | | Reversibility Documented | no | | MCP Server | documented | | Auth Clarity | served | | Idempotency | verified | | Error Semantics | verified | | OpenAPI Examples | no | | Rate Limit Signal | documented | | Event Surface Described | yes | | Agent Skills | derived | | Well Known Catalog | no | | Consent Identity | no | | Agent Card | no | | Dry Run Mode | no | | Delegated Identity | served | | Protected Resource Metadata | verified | | Dynamic Client Registration | yes | | Agentic Commerce | no | ## APIs (16) - **Saperly API Token Registry API** — Manage the scoped `sk_` API keys agents use to call Saperly. Each key carries a set of scopes, an optional number allow-list, and an optional spend cap; revoke a key when it is ... - **Saperly Assistant API** — Ask the built-in workspace assistant a natural-language question and get a text answer back. Backed by an in-network model; availability depends on the operator configuration. - **Saperly Connections API** — Connections — the handler bound to a phone number that answers and talks. Hosted lines run an in-network voice assistant (pick the model, voice, language, and MCP tools); manual... - **Saperly Consent API** — Track opt-in consent for contacts on your numbers. Record, revoke, list, and check the consent that backs your outbound messaging compliance. (Inbound STOP/START opt-out is hand... - **Saperly Custom Voices API** — The customVoices API from Saperly — 2 operation(s) for customvoices. - **Saperly Health API** — Service liveness. A lightweight, unauthenticated probe for uptime checks and load balancers. - **Saperly Keys API** — Provision and manage scoped `sk_` API keys for the workspace. The workspace is always read from the calling key, never from client input. A key holding the `keys:admin` scope ca... - **Saperly Languages API** — Discover the spoken languages a connection can use (its `language` field). The list is derived from the voice catalogue — every language here has at least one voice that speaks ... - **Saperly Messaging API** — Send and list SMS messages on your numbers. Outbound sends are billed per segment and pass through opt-out (STOP) and spend-limit enforcement before reaching the carrier; inboun... - **Saperly Numbers API** — Phone numbers — provision, list, release, and configure the lines in your workspace. Bind a connection to a number to make it answer calls and messages, set a per-number webhook... - **Saperly Pricing API** — Pricing — get a live quote for what a phone number will cost before you provision it. Returns the customer-facing monthly and upfront prices for a given country and number type,... - **Saperly Usage API** — Read metered usage for the workspace — call and message counts, total call cost and duration, and the current prepaid balance. Aggregated over an optional time window; the balan... - **Saperly Voice API** — Place and control outbound calls and fetch call records. Audio always stays in-network — there is no live media-control surface here by design. Funds are reserved on start and s... - **Saperly Voices API** — Discover the in-network text-to-speech voices a hosted connection can speak with. Each voice carries its language, so this endpoint also doubles as the catalogue of supported sp... - **Saperly Workspace API** — Workspace administration — read the members, API tokens, webhook endpoints, and audit log for a workspace. Dashboard/management routes keyed by the workspace slug in the path. - **Saperly Workspace Invitations API** — Invite teammates to a workspace by email address. ## MCP servers (1) - **Saperly MCP Server** — Saperly operates a remote MCP server at https://api.saperly.com/mcp (Streamable HTTP, JSON-RPC 2.0) authenticated with a scoped sap_sk_ bearer key or an MCP OAuth 2.1 access tok... ## Agentic access (1) - **Saperly Agentic Access** — 48 operations · 24 acting · 3 human-in-the-loop ## Security (3) - **Saperly Authentication** — 2 schemes - **Saperly Domain Security** — TLSv1.3 · DMARC - **Saperly Vulnerability Disclosure** — no policy recorded ## Plans (1) - **Saperly Plans Pricing** ## Tags Telephony, Voice, SMS, Phone Numbers, AI Agents, Consent, Compliance, MCP, Messaging, Communications --- Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/saperly/). Scores are computed from the provider's own public artifacts under a published rubric.