Speko

Agentes de voz, llamadas telefónicas, TTS, STT y transcripciones de llamadas

Documentación

MCP

Conecta Speko a Claude Code, Codex, OpenCode, Cursor y otras herramientas de codificación con IA.

Speko MCP brinda a los agentes de codificación acceso autenticado a organizaciones, agentes, sesiones, llamadas, números de teléfono, bases de conocimiento, evaluaciones, implementación, asistentes de migración y datos de uso.

Las superficies de herramientas están vinculadas a nombres de host. Esta página documenta la superficie completa en mcp.speko.ai; los directorios de asistentes se publican en hosts más restringidos, enumerados en Directory hosts.

Instalar en tu herramienta

Ejecuta el instalador guiado y elige el inicio de sesión OAuth en el navegador:

npx @spekoai/mcp@latest init

El endpoint alojado es https://mcp.speko.ai/mcp. Utiliza JSON HTTP sin estado con MCP 2026-07-28. Better Auth gestiona el estado de OAuth mientras que el servicio MCP valida cada token de acceso de forma independiente, por lo que las solicitudes pueden llegar a cualquier réplica. La automatización puede usar en su lugar una clave de API de la plataforma Speko desde API keys.

MCP no expone herramientas de ciclo de vida de claves de API. Crea y revoca claves de plataforma para todo el producto desde API keys.

claude mcp add --transport http speko https://mcp.speko.ai/mcp

Añade a ~/.codex/config.toml:

[mcp_servers.speko]
url = "https://mcp.speko.ai/mcp"

Añade a opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "speko": {
      "type": "remote",
      "url": "https://mcp.speko.ai/mcp",
      "enabled": true
    }
  }
}

Abre Cursor Settings > MCP > Add new global MCP server y luego añade:

{
  "mcpServers": {
    "speko": {
      "url": "https://mcp.speko.ai/mcp"
    }
  }
}

Configura un servidor MCP HTTP remoto:

ConfiguraciónValor
Nombrespeko
URLhttps://mcp.speko.ai/mcp
AutenticaciónInicio de sesión OAuth en el navegador

Para automatización con clave de API, añade Authorization: Bearer ${SPEKO_API_KEY} usando la sintaxis de variables de entorno del cliente.

Qué pedirle a tu agente

Una vez conectado a mcp.speko.ai, pídele a tu agente que:

  • inspeccione el uso de la organización y el saldo de créditos;
  • cree, actualice, implemente o revierta agentes;
  • cree sesiones e inspeccione transcripciones o grabaciones de llamadas;
  • cree números de teléfono, bases de conocimiento y evaluaciones;
  • convierta configuraciones externas de agentes de voz con migration.workspace.inspect, migration.external_config.parse y migration.session_config.build.

Directory hosts

Los directorios de asistentes se ejecutan en sus propios hosts. Cada superficie es una propiedad del host: ningún parámetro de consulta, encabezado ni configuración de cuenta la amplía.

HostHerramientasSuperficie
mcp.speko.ai101Superficie operativa completa. Los agentes de codificación la usan.
anthropic.speko.ai35Anthropic MCP Directory. Lecturas, audio.transcribe, llamadas salientes.
chatgpt.speko.ai20OpenAI Plugin Directory.
builder-mcp.speko.ai12Creadores de aplicaciones (v0, Lovable, Bolt, Base44, Figma Make).
replit.speko.ai28Replit. Herramientas de tiempo de compilación primero, además de bases de conocimiento y números de teléfono.

Anthropic MCP Directory

https://anthropic.speko.ai/mcp ofrece 35 herramientas: lecturas en agentes, sesiones, llamadas, transcripciones, grabaciones, números de teléfono, bases de conocimiento, créditos y uso, además de audio.transcribe, docs.search, los asistentes de migración, sessions.phone.create para realizar una llamada y phone_numbers.kyb.{get,submit} para la declaración que habilita las llamadas.

Seis grupos están ausentes en ese host:

grupoausente
generación de audioaudio.synthesize
creación de sesiones/llamadas en vivosessions.create, agents.test_call
configuración e implementación de agentesagents.create, agents.update, agents.deploy, agents.rollback, agents.tools escrituras
escrituras de bases de conocimiento y números de teléfonoknowledge_bases escrituras, phone_numbers.create, phone_numbers.update
evaluación masiva y monitoreoagents.evals.*, agents.monitors.*
escrituras irreversibles y orientadas al exterioragents.delete, phone_numbers.delete, knowledge_bases.delete, share_cards.create

Configurar un agente equivale a armarlo: un agente implementado habla en el tráfico entrante sin ninguna llamada de herramienta adicional, por lo que la configuración del agente se retiene junto con la propia generación de voz. audio.transcribe permanece, porque la conversión de voz a texto no produce audio y devuelve solo texto. Llamar a una herramienta retenida devuelve Unknown tool, indistinguible de un nombre que nunca se registró.

Antes de cualquier llamada saliente, el espacio de trabajo presenta una declaración comercial: el nombre de la empresa, para qué se usa la llamada y una atestación. Son dos campos, surte efecto en el momento en que se envía, y phone_numbers.kyb.get devuelve el nombre prellenado y el texto exacto de la atestación para mostrar. Las llamadas del grupo compartido de identificador de llamadas marcan desde un número propiedad de Speko, por lo que la declaración es lo que mantiene una empresa con nombre detrás de cada llamada.

sessions.phone.create se sirve aquí. Realiza una llamada, a un número, por llamada de herramienta explícita, usando un agente que implementaste en otro lugar: ninguna ruta masiva, programada o desatendida llega a ella, y la persona que llama no puede configurar el agente que habla. Cada llamada creada en un host de directorio tiene inyección de divulgación de IA en el lado del servidor: lo primero que se dice en la línea es que la persona que llama es una IA, y ningún prompt puede anularlo.

Para crear agentes o sintetizar voz, usa mcp.speko.ai, la REST API o un SDK.

[

Quickstart

Desde el registro hasta tu primera llamada de transcripción en menos de cinco minutos.

](https://docs.speko.ai/quickstart)[

Replit

Añade voz — STT, TTS y LLM con enrutamiento de proveedores y conmutación por error — a cualquier aplicación de Replit.

](https://docs.speko.ai/quickstart/replit)