convez.ai
MCP ServerIntegração & APIsIntermediário
Saperly

Saperly MCP Server

Saperly/saperly-mcp

Provisione telefones e automatize chamadas/SMS com IA

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server que integra a plataforma Saperly, permitindo que agentes de IA provisionem números de telefone, façam e recebam chamadas, enviem SMS e gerenciem credenciais. Oferece 32 ferramentas organizadas em 12 grupos, com suporte para Claude Desktop, Claude Code, Cursor e outras plataformas compatíveis.

Instalação

$npx convez-ai Saperly/saperly-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
3
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 5 meses
Versão
v0.1.1
Issues abertas
0
Contribuidores
3

Casos de uso

  • Automatizar campañas de outreach telefônico via agentes de IA
  • Integrar VoIP e SMS em workflows de atendimento ao cliente
  • Gerenciar números de telefone e compliance TCPA programaticamente

Veredito

Ferramenta robusta para conectar comunicações telefônicas a agentes de IA, com autenticação flexível (API key, service key, OAuth). Excelente para uso em Claude Desktop e serverless; documentação clara e suporte a múltiplas plataformas.

README

A tradução para o português deste README ainda está na fila.

@saperly/mcp

Model Context Protocol server for Saperly. Gives any MCP-compatible AI agent (Claude Desktop, Claude Code, Cursor) the ability to provision phone numbers, place calls, send SMS, and manage credentials.

32 tools across 12 groups, all backed by the public Saperly API.

Install

npm install -g @saperly/mcp

Or run on demand with npx @saperly/mcp.

Quickstart

Register the server with Claude Desktop. Add this block to claude_desktop_config.json:

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

For Claude Code:

claude mcp add saperly -- npx -y @saperly/mcp
export SAPERLY_API_KEY=sk_live_...

Get an API key at saperly.com/settings/keys. For key-management tools (saperly_key_*) set SAPERLY_API_KEY to a service key instead.

Use as a hosted connector

Same auth model, no local install — the hosted connector serves the OAuth-usable surface (the service-key saperly_key_* tools stay local-only). The hosted endpoint at https://saperly.com/api/v1/mcp speaks the streamable HTTP transport and accepts three credential types: API-key bearer, opaque connector URL, and OAuth 2.1 access token (Saperly is the issuer).

  • Anthropic Messages API (mcp_servers): point at https://saperly.com/api/v1/mcp and pass your API key as authorization_token.
  • Claude.ai custom connector — OAuth tab: paste https://saperly.com/api/v1/mcp. Claude does the discovery + dynamic registration + PKCE dance and lands the user on a consent screen at saperly.com.
  • Claude.ai custom connector — No auth tab: mint a connector URL at saperly.com/settings/connectors and paste it with auth set to None.
  • ChatGPT — custom connector: add https://saperly.com/api/v1/mcp; ChatGPT runs the same OAuth discovery + registration flow as Claude.ai.
  • CrewAI: pip install "saperly[crewai]" then wrap with SaperlyTools(api_key=…). See the Python SDK.

Tool groups

The canonical tool list lives in manifest.json. One sentence per group:

  • lines: Provision and manage phone numbers (modes: webhook, audio, hosted).
  • calls: Start and control calls, wait for inbound calls, retrieve history, run hosted AI conversation calls.
  • messages: Send outbound SMS and read inbound conversation history.
  • keys: Mint, rotate, and revoke child API keys (service-key auth required).
  • consent: Grant, check, and revoke TCPA outbound consent per phone number.
  • disclosures: Configure TCPA disclosure scripts played at call start.
  • billing: Read account balance and transactions.
  • account: Whole-account snapshot covering lines, balance, usage, and recent calls.
  • webhooks: List delivery attempts, read aggregate stats, send test webhooks.
  • usage: Aggregate call minutes, SMS counts, and costs by day or month.
  • settings: Read or update account-level configuration (e.g. default webhook URL).
  • voices: List TTS voices available for hosted-mode calls.

Auth

Saperly uses a two-tier credential model. Both authenticate via SAPERLY_API_KEY on the MCP server's environment.

CredentialUse case
API key (sk_live_…, sk_test_…)Place calls, send SMS, manage lines, read usage.
Service key (sk_svc_live_…, sk_svc_test_…)Mint, rotate, and revoke child API keys via the saperly_key_* tools. Credential management only.

Full reference at docs.saperly.com/service-keys.

Resources

License

MIT. See LICENSE.

Contact

hello@saperly.com or open an issue.

Ver o original no GitHub

Bom para

Relacionados