Superscribe

npx add-mcp 'https://superscribe.io/mcp'

Superscribe para desenvolvedores

Desligou. O JSON está pronto.

Toda chamada e reunião no seu próprio número sai como dados: transcrição, resumo, turnos de fala, números, duração. Leia com a API REST, ou entregue a um agente via MCP. Sem sistema telefônico para adotar, sem bot na linha.

API REST

Quatro leituras. Essa é toda a superfície.

URL base https://superscribe.io/api/v1. Toda requisição carrega sua chave. O contrato completo está na especificação OpenAPI e na referência da API.

1. Listar gravações

   GET /api/v1/recordings. Filtre por data, fonte (phone_call, meeting, microphone, file) e número de telefone. Adicione includeTranscript=false para uma lista compacta e navegue pelas páginas com page e limit.

2. Uma gravação

   GET /api/v1/recordings/:id. A transcrição, o resumo, duração, direção, ambos os números e, para chamadas telefônicas, os turnos rotulados por falante com carimbos de tempo.

3. Busca

   GET /api/v1/recordings/search?q=. Busca semântica nas transcrições primeiro, busca por texto simples como fallback. A resposta indica qual delas respondeu.

4. Um relatório de uso

   GET /api/v1/reports/usage?dateFrom=&dateTo=. Chamadas, reuniões e ditados com minutos, quantos foram resumidos, acompanhamentos sugeridos, entradas de CRM, tempo cobrado por projeto e atividade do GitHub para repositórios vinculados. Um JSON para todo o intervalo.

Como é uma chamada

Uma gravação, resumida.

A pessoa do outro lado é nomeada a partir dos seus contatos quando o número é conhecido. Turnos com is_owner: true são seus. Listas podem omitir a transcrição e os turnos.

curl "https://superscribe.io/api/v1/recordings?source=phone_call&includeTranscript=false&limit=20" \
  -H "x-api-key: ss_YOUR_KEY"

{
  "id": "507f1f77bcf86cd799439011",
  "source": "phone_call",
  "direction": "inbound",
  "caller_number": "+12025551234",
  "callee_number": "+18335522205",
  "caller_name": "Alice",
  "duration_seconds": 142,
  "language": "en",
  "summary": "Alice asked for a quote for 200 units. Send it by Friday.",
  "transcript": "Alice: Hello?\nYou: Hi, how can I help?",
  "turns": [
    { "speaker": "caller", "speaker_label": "Alice", "is_owner": false,
      "text": "Hello?", "start_time": 0.0, "end_time": 0.8 },
    { "speaker": "agent", "speaker_label": "You", "is_owner": true,
      "text": "Hi, how can I help?", "start_time": 1.2, "end_time": 2.4 }
  ],
  "created_at": "2026-09-14T09:30:00.000Z"
}

MCP

Os mesmos dados, para um agente.

Endpoint https://superscribe.io/mcp, HTTP com streaming, sua chave no cabeçalho x-api-key. Funciona com Claude Desktop, Claude Code, Cursor e qualquer outra coisa que fale MCP.

get_recordings

lista gravações, mais recentes primeiro, com filtros de data e fonte, compactas sem transcrições, paginadas com next_cursor

get_recording

uma gravação por id, com a transcrição e os turnos

search_recordings

busca nas transcrições

get_report

o relatório de uso para um intervalo de datas, o mesmo JSON do endpoint REST

Claude Desktop

{
  "mcpServers": {
    "superscribe": {
      "url": "https://superscribe.io/mcp",
      "headers": { "x-api-key": "ss_YOUR_KEY" }
    }
  }
}

Claude Code

claude mcp add --transport http superscribe https://superscribe.io/mcp --header "x-api-key: ss_YOUR_KEY"

Como é um mês

O relatório de uso, resumido.

Números reais de uma conta, um mês. O tempo cobrado segue as mesmas janelas de precisão da página de Relatórios, e as contagens do GitHub vêm de repositórios vinculados a um projeto.

{
  "date_from": "2026-08-14T00:00:00.000Z",
  "date_to": "2026-09-13T23:59:59.999Z",
  "recordings": {
    "phone_calls": { "count": 238, "minutes": 558, "summarized": 138,
      "over_two_minutes": 51, "incoming": 115, "outgoing": 77,
      "per_week": [{ "week_start": "2026-09-07", "count": 69 }] },
    "meetings": { "count": 73, "minutes": 102, "summarized": 41 },
    "dictations": { "count": 486, "minutes": 276, "summarized": 0 }
  },
  "follow_ups": { "suggested": 74, "recordings_with_follow_ups": 56,
    "by_kind": { "reminder": 51, "calendar_event": 12, "call_back": 8 } },
  "crm": { "entries_synced": 77, "synced_by_provider": { "pipedrive": 77 } },
  "projects": [{ "project_name": "V2", "billed_minutes": 12240,
    "github": { "commits": 70, "issues_opened": 104, "issues_closed": 64,
      "issues_from_recordings_opened": 72 } }]
}

As letras miúdas

Chaves

As chaves começam com ss_ e só enxergam a conta que as criou. Envie-as como x-api-key ou como token Bearer. Revogue qualquer chave pelo painel e ela para de funcionar na hora.

Sessões

O servidor MCP fala HTTP com streaming. Uma sessão expira após 30 minutos ociosos, e uma sessão desconhecida responde 404, então um cliente só precisa enviar initialize novamente.

Webhooks

Ainda não. Superscribe não envia eventos. Faça polling em GET /recordings com dateFrom, ou deixe um agente verificar via MCP. Se push mudaria algo para você, avise em hello@superscribe.io.

Quando os dados aparecem

Uma gravação aparece assim que a chamada ou reunião termina e a transcrição está pronta, geralmente em menos de um minuto. Gravações ocultas ficam de fora de toda lista.

Para modelos

Uma versão em texto simples desta página para LLMs e agentes: llms.txt e llms-full.txt.