Magpipe

magpipe-mcp-server

Servidor MCP para Magpipe — gestiona agentes, llamadas, SMS, contactos y números de teléfono desde herramientas de codificación con IA como Claude Code y Cursor.

Instalación

npm install -g magpipe-mcp-server

O ejecútalo directamente con npx:

npx magpipe-mcp-server

Configuración

1. Obtén una clave de API

Ve a magpipe.ai/settings → pestaña API → Generate New Key.

2. Configura tu herramienta de IA

Claude Code

Añade a ~/.claude.json:

{
  "mcpServers": {
    "magpipe": {
      "command": "npx",
      "args": ["-y", "magpipe-mcp-server"],
      "env": {
        "MAGPIPE_API_KEY": "mgp_your_key_here"
      }
    }
  }
}

Cursor

Añade a .cursor/mcp.json:

{
  "mcpServers": {
    "magpipe": {
      "command": "npx",
      "args": ["-y", "magpipe-mcp-server"],
      "env": {
        "MAGPIPE_API_KEY": "mgp_your_key_here"
      }
    }
  }
}

Variables de Entorno

Variable	Requerida	Descripción
MAGPIPE_API_KEY	Sí	Clave de API que comienza con mgp_
MAGPIPE_API_URL	No	Sobrescribe la URL base de la API (por defecto: https://api.magpipe.ai/functions/v1)

Herramientas Disponibles

Agentes

• list_agents — Lista todos los agentes con filtros opcionales
• get_agent — Obtén detalles completos del agente, incluidos números de teléfono asignados, funciones personalizadas, fuentes de conocimiento y variables dinámicas
• create_agent — Crea un nuevo agente
• update_agent — Actualiza la configuración del agente
• delete_agent — Elimina un agente

Llamadas

• list_calls — Lista registros de llamadas con filtros
• get_call — Obtén detalles de la llamada, transcripción y resumen
• initiate_call — Realiza una llamada saliente
• terminate_call — Finaliza una llamada activa
• get_recording — Obtén una URL firmada de la grabación

Mensajes

• list_messages — Lista mensajes SMS
• get_message — Obtén un mensaje individual
• send_sms — Envía un SMS

Números de Teléfono

• list_phone_numbers — Lista números aprovisionados
• search_phone_numbers — Busca números disponibles para comprar
• provision_phone_number — Compra un número
• release_phone_number — Libera un número

Contactos

• list_contacts — Lista contactos con búsqueda y filtros
• get_contact — Obtén detalles del contacto
• create_contact — Crea un contacto
• update_contact — Actualiza un contacto
• delete_contact — Elimina un contacto

Base de Conocimiento

• list_knowledge_sources — Lista fuentes de conocimiento para un agente
• add_knowledge_source — Añade conocimiento basado en URL
• add_knowledge_manual — Añade conocimiento de texto manual
• delete_knowledge_source — Elimina una fuente de conocimiento
• sync_knowledge_source — Vuelve a rastrear una fuente URL

Voces

• list_voices — Lista voces disponibles
• delete_voice — Elimina una voz clonada

Calendario

• get_calendar_slots — Obtén espacios de reserva disponibles
• create_booking — Crea una reserva
• cancel_booking — Cancela una reserva

Claves de API

• manage_api_keys — Genera, lista, revoca o actualiza claves de API

Otros

• list_models — Lista modelos LLM disponibles
• chat_with_agent — Envía un mensaje de texto a un agente
• list_chat_sessions — Lista sesiones de chat
• list_custom_functions — Lista funciones personalizadas
• create_custom_function — Crea una función personalizada
• manage_dynamic_variables — Gestiona variables de extracción de datos
• list_scheduled_actions — Lista acciones programadas

Desarrollo

cd packages/mcp-server
npm install
npm run build
MAGPIPE_API_KEY=mgp_xxx node dist/index.js

Licencia

MIT