Superscribe

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

Superscribe para desarrolladores

Cuelga. El JSON está listo.

Cada llamada y reunión en tu propio número sale como datos: transcripción, resumen, turnos de hablantes, números, duración. Léelo con la API REST, o entrégaselo a un agente a través de MCP. Sin sistema telefónico que adoptar, sin bot en la línea.

API REST

Cuatro lecturas. Esa es toda la superficie.

URL base https://superscribe.io/api/v1. Cada solicitud lleva tu clave. El contrato completo está en la especificación OpenAPI y en la referencia de la API.

1. Listar grabaciones

   GET /api/v1/recordings. Filtra por fecha, fuente (phone_call, meeting, microphone, file) y número de teléfono. Añade includeTranscript=false para una lista compacta y recórrela con page y limit.

2. Una grabación

   GET /api/v1/recordings/:id. La transcripción, el resumen, la duración, la dirección, ambos números y, para llamadas telefónicas, los turnos etiquetados por hablante con marcas de tiempo.

3. Búsqueda

   GET /api/v1/recordings/search?q=. Búsqueda semántica en las transcripciones primero, búsqueda de texto plano como respaldo. La respuesta indica cuál respondió.

4. Un informe de uso

   GET /api/v1/reports/usage?dateFrom=&dateTo=. Llamadas, reuniones y dictados con minutos, cuántos fueron resumidos, seguimientos sugeridos, entradas de CRM, tiempo facturado por proyecto y actividad de GitHub para repositorios vinculados. Un solo JSON para todo el rango.

Cómo se ve una llamada

Una grabación, recortada.

La persona al otro lado se nombra desde tus contactos cuando se conoce el número. Los turnos con is_owner: true son tuyos. Las listas pueden omitir la transcripción y los 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

Los mismos datos, para un agente.

Endpoint https://superscribe.io/mcp, HTTP transmisible, tu clave en el encabezado x-api-key. Funciona con Claude Desktop, Claude Code, Cursor y cualquier otra cosa que hable MCP.

get_recordings

lista grabaciones, las más recientes primero, con filtros de fecha y fuente, compactas sin transcripciones, paginadas con next_cursor

get_recording

una grabación por id, con la transcripción y los turnos

search_recordings

busca en las transcripciones

get_report

el informe de uso para un rango de fechas, el mismo JSON que el 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"

Cómo se ve un mes

El informe de uso, recortado.

Números reales de una cuenta, un mes. El tiempo facturado sigue las mismas ventanas de precisión que la página de Informes, y los conteos de GitHub provienen de repositorios vinculados a un proyecto.

{
  "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 } }]
}

La letra pequeña

Claves

Las claves comienzan con ss_ y solo ven la cuenta que las creó. Envíalas como x-api-key o como token Bearer. Revoca cualquier clave desde el panel y deja de funcionar de inmediato.

Sesiones

El servidor MCP habla HTTP transmisible. Una sesión expira después de 30 minutos de inactividad, y una sesión desconocida responde 404, así que un cliente solo tiene que enviar initialize de nuevo.

Webhooks

Aún no. Superscribe no envía eventos. Consulta GET /recordings con dateFrom, o deja que un agente revise a través de MCP. Si el envío de eventos cambiara algo para ti, dilo en hello@superscribe.io.

Cuándo aparecen los datos

Una grabación aparece una vez que la llamada o reunión ha terminado y la transcripción está lista, generalmente dentro de un minuto. Las grabaciones ocultas se omiten de todas las listas.

Para modelos

Una versión en texto plano de esta página para LLMs y agentes: llms.txt y llms-full.txt.