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

# MCP Server

> Connect the Phonovation developer docs directly to your AI coding tool.

The Phonovation docs include a **Model Context Protocol (MCP) server**. Add it to your AI tool and it will be able to search and read the Phonovation API documentation in real time — no copy-pasting, no stale context, no guessing.

<Info>
  Instead of relying on training data, your AI assistant will query the live Phonovation docs to answer questions, generate accurate code snippets, and keep up with any changes.
</Info>

## MCP server URL

```http theme={"dark"}
https://developers.phonovation.com/mcp
```

```text title="MCP server URL" icon=plug wrap theme={"dark"}
https://developers.phonovation.com/mcp
```

## Add to your tool

<Tabs>
  <Tab title="Claude Code">
    Run this in your terminal:

    ```bash title="Claude Code" icon=terminal wrap theme={"dark"}
    claude mcp add --transport http phonovation-docs https://developers.phonovation.com/mcp
    ```

    Claude Code will now search the Phonovation docs when you ask it questions about the API.
  </Tab>

  <Tab title="Cursor">
    Add to your `~/.cursor/mcp.json` (or project-level `.cursor/mcp.json`):

    ```json title=".cursor/mcp.json" highlight={4} icon=code lines wrap theme={"dark"}
    {
      "mcpServers": {
        "phonovation-docs": {
          "url": "https://developers.phonovation.com/mcp"
        }
      }
    }
    ```

    Then restart Cursor and the server will appear in **Settings → MCP**.
  </Tab>

  <Tab title="VS Code">
    Add to `.vscode/mcp.json` in your project:

    ```json title=".vscode/mcp.json" highlight={5} icon=code lines wrap theme={"dark"}
    {
      "servers": {
        "phonovation-docs": {
          "type": "http",
          "url": "https://developers.phonovation.com/mcp"
        }
      }
    }
    ```
  </Tab>

  <Tab title="Windsurf">
    Add to your Windsurf MCP config:

    ```json title="Windsurf MCP config" highlight={4} icon=code lines wrap theme={"dark"}
    {
      "mcpServers": {
        "phonovation-docs": {
          "serverUrl": "https://developers.phonovation.com/mcp"
        }
      }
    }
    ```

    Then open **Windsurf Settings → MCP Servers** and enable `phonovation-docs`.
  </Tab>

  <Tab title="Codex app">
    Add the server with the Codex CLI first, then enable it in the Codex desktop app:

    ```bash title="Codex CLI setup" icon=terminal wrap theme={"dark"}
    codex mcp add phonovation-docs --url https://developers.phonovation.com/mcp
    ```

    Then open the Codex app:

    1. Open **Settings** from the app menu.
    2. Go to **Integrations & MCP**.
    3. Find `phonovation-docs`.
    4. Enable the server.

    The Codex app stores MCP configuration in `config.toml`, so the same server is also available to the Codex CLI and IDE extension.

    <Note>
      If you add the server from the app form instead, use **Streamable HTTP** with URL `https://developers.phonovation.com/mcp`. Leave bearer token, HTTP headers, environment variables, environment variable passthrough, and working directory blank.
    </Note>
  </Tab>

  <Tab title="Codex CLI">
    Add the server using the Codex CLI:

    ```bash title="Add MCP server" icon=terminal wrap theme={"dark"}
    codex mcp add phonovation-docs --url https://developers.phonovation.com/mcp
    ```

    Verify that the server is configured:

    ```bash title="List configured MCP servers" icon=terminal wrap theme={"dark"}
    codex mcp list
    ```

    You can also add it directly to `~/.codex/config.toml`:

    ```toml title="~/.codex/config.toml" highlight={2} icon=file-code lines wrap theme={"dark"}
    [mcp_servers.phonovation-docs]
    url = "https://developers.phonovation.com/mcp"
    ```
  </Tab>

  <Tab title="Claude.ai">
    1. Go to [claude.ai](https://claude.ai) and open **Settings → Connectors**
    2. Click **Add custom connector**
    3. Enter the name `Phonovation Docs` and URL `https://developers.phonovation.com/mcp`
    4. Save — then use the attachments button in any chat to connect it
  </Tab>
</Tabs>

## What it can do

Once connected, your AI tool can:

<CardGroup cols={2}>
  <Card title="Search the docs" icon="magnifying-glass">
    Find relevant pages across authentication, campaigns, DLRs, inbound messages, and more.
  </Card>

  <Card title="Read full pages" icon="book-open">
    Pull the complete content of any page for accurate, up-to-date answers.
  </Card>

  <Card title="Generate accurate code" icon="code">
    Write correct API calls, token refresh logic, DLR handlers, and more — based on the real spec.
  </Card>

  <Card title="Stay up to date" icon="rotate">
    Queries the live docs, so your AI always has the latest information.
  </Card>
</CardGroup>

## Example prompts

Once connected, try asking your AI assistant:

```text title="Prompt example" icon=message wrap theme={"dark"}
How do I authenticate with the Phonovation API and send an SMS campaign?
```

```text title="Prompt example" icon=message wrap theme={"dark"}
What happens if I include invalid numbers in my recipient list?
```

```text title="Prompt example" icon=message wrap theme={"dark"}
Write a Node.js function that handles DLR callbacks and verifies the payload.
```

```text title="Prompt example" icon=message wrap theme={"dark"}
What are the ComReg requirements for Sender IDs in Ireland?
```