> ## Documentation Index
> Fetch the complete documentation index at: https://docs.magpipe.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP Server

> Connect AI coding tools to Magpipe via the Model Context Protocol

## 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

```bash theme={null}
npm install -g magpipe-mcp-server
```

Or run via npx (no install required):

```bash theme={null}
npx magpipe-mcp-server
```

## Configuration

### Claude Code

Add to `~/.claude.json`:

```json theme={null}
{
  "mcpServers": {
    "magpipe": {
      "command": "npx",
      "args": ["-y", "magpipe-mcp-server"],
      "env": {
        "MAGPIPE_API_KEY": "mgp_your_key_here"
      }
    }
  }
}
```

### Cursor

Add to `.cursor/mcp.json`:

```json theme={null}
{
  "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:

```bash theme={null}
MAGPIPE_API_KEY=mgp_xxx npx magpipe-mcp-server
```

## Environment Variables

| Variable          | Required | Description                                                               |
| ----------------- | -------- | ------------------------------------------------------------------------- |
| `MAGPIPE_API_KEY` | Yes      | Your API key (starts with `mgp_`). Generate at **Settings → API**.        |
| `MAGPIPE_API_URL` | No       | Override the API base URL. Default: `https://api.magpipe.ai/functions/v1` |

## Available Tools

### Agents

| Tool           | Description                                                                                                                                                                                                                                              |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `list_agents`  | List all agents with optional filters                                                                                                                                                                                                                    |
| `get_agent`    | Get full agent details including assigned phone numbers, custom functions, knowledge sources, and dynamic variables                                                                                                                                      |
| `create_agent` | Create a new agent. Supports full config: voice, model, language, recording, memory, knowledge sources, call behaviour, VAD, audio, and more                                                                                                             |
| `update_agent` | Update any agent config field: name, prompt, voice, model, `recording_enabled`, `memory_enabled`, `dynamic_variables`, `knowledge_source_ids`, VAD settings, and more. See [Update Agent](/api-reference/endpoints/update-agent) for the full field list |
| `delete_agent` | Delete an agent                                                                                                                                                                                                                                          |

### Calls

| Tool             | Description                                                       |
| ---------------- | ----------------------------------------------------------------- |
| `list_calls`     | List call records with direction, status, date, and agent filters |
| `get_call`       | Get call details including transcript, summary, and recording     |
| `initiate_call`  | Place an outbound call via an agent                               |
| `terminate_call` | End an active call                                                |
| `get_recording`  | Get a signed URL to download a call recording                     |

### Messages

| Tool            | Description                                                                                                                           |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `list_messages` | List messages (filters: direction, phone number, date range). Each message includes `thread_id` and a `media[]` array of attachments. |
| `get_message`   | Get a single message, including `thread_id` and re-signed `media[]` (24h URLs).                                                       |
| `send_sms`      | Send an SMS from a service number                                                                                                     |

### Phone Numbers

| Tool                     | Description                                          |
| ------------------------ | ---------------------------------------------------- |
| `list_phone_numbers`     | List provisioned phone numbers                       |
| `search_phone_numbers`   | Search available numbers by area code, city, or type |
| `provision_phone_number` | Purchase a phone number                              |
| `release_phone_number`   | Release a phone number                               |

### Contacts

| Tool             | Description                                  |
| ---------------- | -------------------------------------------- |
| `list_contacts`  | List contacts with search, tags, and sorting |
| `get_contact`    | Get contact details                          |
| `create_contact` | Create a contact                             |
| `update_contact` | Update a contact                             |
| `delete_contact` | Delete a contact                             |

### Knowledge Base

| Tool                      | Description                                   |
| ------------------------- | --------------------------------------------- |
| `list_knowledge_sources`  | List knowledge sources for an agent           |
| `add_knowledge_source`    | Add URL-based knowledge (crawled and indexed) |
| `add_knowledge_manual`    | Add manual text knowledge                     |
| `delete_knowledge_source` | Delete a knowledge source                     |
| `sync_knowledge_source`   | Re-crawl a URL knowledge source               |

### Voices

| Tool           | Description                      |
| -------------- | -------------------------------- |
| `list_voices`  | List available ElevenLabs voices |
| `delete_voice` | Delete a cloned voice            |

### Calendar

| Tool                 | Description                         |
| -------------------- | ----------------------------------- |
| `get_calendar_slots` | Get available Cal.com booking slots |
| `create_booking`     | Create a booking                    |
| `cancel_booking`     | Cancel a booking                    |

### API Keys

| Tool              | Description                                |
| ----------------- | ------------------------------------------ |
| `manage_api_keys` | Generate, list, revoke, or update API keys |

### Other

| Tool                       | Description                            |
| -------------------------- | -------------------------------------- |
| `list_models`              | List available LLM models              |
| `chat_with_agent`          | Send a text chat message to an agent   |
| `list_chat_sessions`       | List chat widget sessions              |
| `list_custom_functions`    | List custom functions                  |
| `create_custom_function`   | Create a custom function               |
| `manage_dynamic_variables` | Manage agent data extraction variables |
| `list_scheduled_actions`   | List scheduled actions                 |