Magpipe

magpipe-mcp-server

Servidor MCP para Magpipe — gerencie agentes, chamadas, SMS, contatos e números de telefone a partir de ferramentas de codificação de IA como Claude Code e Cursor.

Instalação

npm install -g magpipe-mcp-server

Ou execute diretamente com npx:

npx magpipe-mcp-server

Configuração

1. Obtenha uma chave de API

Acesse magpipe.ai/settings → aba API → Generate New Key.

2. Configure sua ferramenta de IA

Claude Code

Adicione em ~/.claude.json:

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

Cursor

Adicione em .cursor/mcp.json:

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

Variáveis de Ambiente

Variável	Obrigatória	Descrição
MAGPIPE_API_KEY	Sim	Chave de API começando com mgp_
MAGPIPE_API_URL	Não	Substituir URL base da API (padrão: https://api.magpipe.ai/functions/v1)

Ferramentas Disponíveis

Agentes

• list_agents — Lista todos os agentes com filtros opcionais
• get_agent — Obtém detalhes completos do agente, incluindo números de telefone atribuídos, funções personalizadas, fontes de conhecimento e variáveis dinâmicas
• create_agent — Cria um novo agente
• update_agent — Atualiza a configuração do agente
• delete_agent — Exclui um agente

Chamadas

• list_calls — Lista registros de chamadas com filtros
• get_call — Obtém detalhes da chamada, transcrição e resumo
• initiate_call — Realiza uma chamada de saída
• terminate_call — Encerra uma chamada ativa
• get_recording — Obtém uma URL de gravação assinada

Mensagens

• list_messages — Lista mensagens SMS
• get_message — Obtém uma única mensagem
• send_sms — Envia um SMS

Números de Telefone

• list_phone_numbers — Lista números provisionados
• search_phone_numbers — Busca números disponíveis para compra
• provision_phone_number — Compra um número
• release_phone_number — Libera um número

Contatos

• list_contacts — Lista contatos com busca e filtros
• get_contact — Obtém detalhes do contato
• create_contact — Cria um contato
• update_contact — Atualiza um contato
• delete_contact — Exclui um contato

Base de Conhecimento

• list_knowledge_sources — Lista fontes de conhecimento de um agente
• add_knowledge_source — Adiciona conhecimento baseado em URL
• add_knowledge_manual — Adiciona conhecimento de texto manual
• delete_knowledge_source — Exclui uma fonte de conhecimento
• sync_knowledge_source — Re-executa o rastreamento de uma fonte de URL

Vozes

• list_voices — Lista vozes disponíveis
• delete_voice — Exclui uma voz clonada

Calendário

• get_calendar_slots — Obtém horários de reserva disponíveis
• create_booking — Cria uma reserva
• cancel_booking — Cancela uma reserva

Chaves de API

• manage_api_keys — Gera, lista, revoga ou atualiza chaves de API

Outros

• list_models — Lista modelos LLM disponíveis
• chat_with_agent — Envia uma mensagem de texto para um agente
• list_chat_sessions — Lista sessões de chat
• list_custom_functions — Lista funções personalizadas
• create_custom_function — Cria uma função personalizada
• manage_dynamic_variables — Gerencia variáveis de extração de dados
• list_scheduled_actions — Lista ações agendadas

Desenvolvimento

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

Licença

MIT