@saperly/mcp

@saperly/mcp

MCP server for Saperly — the phone carrier for AI agents. 16 tools that let any MCP-compatible client provision phone lines, make calls, manage consent, and query compliance.

Install

npm install @saperly/mcp

Or run directly:

SAPERLY_API_KEY=sk_live_... npx @saperly/mcp

Setup

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "saperly": {
      "command": "npx",
      "args": ["-y", "@saperly/mcp"],
      "env": { "SAPERLY_API_KEY": "sk_live_..." }
    }
  }
}

Claude Code

npx skills.sh install saperly
export SAPERLY_API_KEY=sk_live_...

Available Tools

Tool	Description
saperly_create_line	Provision a new phone line
saperly_list_lines	List all lines
saperly_get_line	Get line details
saperly_delete_line	Release a phone line
saperly_create_call	Make an outbound call
saperly_list_calls	List recent calls
saperly_get_call	Get call details
saperly_hangup_call	Terminate an active call
saperly_grant_consent	Record outbound consent
saperly_check_consent	Check consent status
saperly_revoke_consent	Revoke consent
saperly_compliance_audit	Query audit trail
saperly_create_disclosure	Create TCPA disclosure
saperly_list_disclosures	List disclosures
saperly_get_balance	Check credit balance
saperly_account_overview	Full account snapshot

Environment Variables

Variable	Required	Description
SAPERLY_API_KEY	Yes	Your Saperly API key
SAPERLY_BASE_URL	No	Override API base URL (for local dev)

Development

# Install dependencies
npm install

# Build SDK first (workspace dependency)
cd ../sdk && npm run build && cd ../mcp

# Type check
npx tsc --noEmit

# Run tests
npx vitest run

# Build
npm run build

License

MIT