Skip to main content

​
Overview

The Magpipe MCP server lets AI coding tools (Claude Code, Cursor, Windsurf, etc.) manage your agents, calls, SMS, contacts, and phone numbers directly. It wraps the Magpipe REST API as discoverable MCP tools.

​
Installation

npm install -g magpipe-mcp-server
Or run via npx (no install required): 
npx magpipe-mcp-server

​
Configuration

​
Claude Code

Add to ~/.claude.json: 
{
  "mcpServers": {
    "magpipe": {
      "command": "npx",
      "args": ["-y", "magpipe-mcp-server"],
      "env": {
        "MAGPIPE_API_KEY": "mgp_your_key_here"
      }
    }
  }
}

​
Cursor

Add to .cursor/mcp.json: 
{
  "mcpServers": {
    "magpipe": {
      "command": "npx",
      "args": ["-y", "magpipe-mcp-server"],
      "env": {
        "MAGPIPE_API_KEY": "mgp_your_key_here"
      }
    }
  }
}

​
Generic MCP Client

The server uses stdio transport. Launch it as a subprocess with the MAGPIPE_API_KEY environment variable set: 
MAGPIPE_API_KEY=mgp_xxx npx magpipe-mcp-server

​
Environment Variables

VariableRequiredDescription
MAGPIPE_API_KEYYesYour API key (starts with mgp_). Generate at Settings → API.
MAGPIPE_API_URLNoOverride the API base URL. Default: https://api.magpipe.ai/functions/v1

​
Available Tools

​
Agents

ToolDescription
list_agentsList all agents with optional filters
get_agentGet full agent details including assigned phone numbers, custom functions, knowledge sources, and dynamic variables
create_agentCreate a new agent. Supports full config: voice, model, language, recording, memory, knowledge sources, call behaviour, VAD, audio, and more
update_agentUpdate any agent config field: name, prompt, voice, model, recording_enabled, memory_enabled, dynamic_variables, knowledge_source_ids, VAD settings, and more. See Update Agent for the full field list
delete_agentDelete an agent

​
Calls

ToolDescription
list_callsList call records with direction, status, date, and agent filters
get_callGet call details including transcript, summary, and recording
initiate_callPlace an outbound call via an agent
terminate_callEnd an active call
get_recordingGet a signed URL to download a call recording

​
Messages

ToolDescription
list_messagesList SMS messages with thread, direction, and date filters
get_messageGet a single message
send_smsSend an SMS from a service number

​
Phone Numbers

ToolDescription
list_phone_numbersList provisioned phone numbers
search_phone_numbersSearch available numbers by area code, city, or type
provision_phone_numberPurchase a phone number
release_phone_numberRelease a phone number

​
Contacts

ToolDescription
list_contactsList contacts with search, tags, and sorting
get_contactGet contact details
create_contactCreate a contact
update_contactUpdate a contact
delete_contactDelete a contact

​
Knowledge Base

ToolDescription
list_knowledge_sourcesList knowledge sources for an agent
add_knowledge_sourceAdd URL-based knowledge (crawled and indexed)
add_knowledge_manualAdd manual text knowledge
delete_knowledge_sourceDelete a knowledge source
sync_knowledge_sourceRe-crawl a URL knowledge source

​
Voices

ToolDescription
list_voicesList available ElevenLabs voices
delete_voiceDelete a cloned voice

​
Calendar

ToolDescription
get_calendar_slotsGet available Cal.com booking slots
create_bookingCreate a booking
cancel_bookingCancel a booking

​
API Keys

ToolDescription
manage_api_keysGenerate, list, revoke, or update API keys

​
Other

ToolDescription
list_modelsList available LLM models
chat_with_agentSend a text chat message to an agent
list_chat_sessionsList chat widget sessions
list_custom_functionsList custom functions
create_custom_functionCreate a custom function
manage_dynamic_variablesManage agent data extraction variables
list_scheduled_actionsList scheduled actions