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

# Connect your AI app

> Add the Plivo MCP server to Claude, Claude Code, ChatGPT, Cursor, VS Code or any app that supports remote MCP servers.

Every app uses the same URL. After you add it, the app opens a Plivo sign-in page. Log in as usual and click **Allow**.

```text MCP server URL theme={null}
https://mcp.plivo.com/mcp
```

## Claude

Works in Claude on the web and in the Claude desktop app.

1. Go to **Settings → Connectors** and click **Add custom connector**.
2. Enter the name `Plivo` and the URL `https://mcp.plivo.com/mcp`, then click **Add**.
3. Click **Connect**, log in to Plivo and click **Allow**.

## Claude Code

```bash theme={null}
claude mcp add --transport http plivo https://mcp.plivo.com/mcp
```

Then run `/mcp` inside Claude Code, choose `plivo` and sign in.

## ChatGPT

1. Go to **Settings → Apps & Connectors → Advanced settings** and turn on **Developer mode**.
2. Under **Apps & Connectors**, click **Create**.
3. Enter the name `Plivo` and the URL `https://mcp.plivo.com/mcp`, choose **OAuth** for authentication, and click **Create**.
4. Log in to Plivo and click **Allow**.

## Cursor

Add this to `~/.cursor/mcp.json`, or to `.cursor/mcp.json` in a project:

```json theme={null}
{
  "mcpServers": {
    "plivo": {
      "url": "https://mcp.plivo.com/mcp"
    }
  }
}
```

Open **Settings → MCP**, then click **Connect** next to `plivo` to sign in.

## VS Code

Add this to `.vscode/mcp.json`:

```json theme={null}
{
  "servers": {
    "plivo": {
      "type": "http",
      "url": "https://mcp.plivo.com/mcp"
    }
  }
}
```

Click **Start** above the server entry and sign in when asked.

## Other apps

Any app that supports remote MCP servers over HTTP with OAuth sign-in works. Add `https://mcp.plivo.com/mcp` as a remote server and sign in when asked.

## Try it

Once connected, ask:

* "What's my Plivo balance?"
* "List the calls on my account from yesterday."
* "Find a US local number in area code 415 and buy it."
* "Send an SMS from my number to +14155550123 saying the order shipped."
* "Create a SIP trunk for my LiveKit agent."

Anything that costs money or changes your account asks you first. See [Approvals](https://plivo.com/docs/mcp/approvals.md).

## Disconnect

The connection shows in the console as **Plivo MCP**. Revoke it there, or remove the server from your app. A token also expires after 30 days; the app then asks you to sign in again.

## Troubleshooting

| Issue | What to do |
| - | - |
| The app asks you to sign in again | The token expired or was revoked. Sign in and click **Allow**. |
| A sub-account action isn't available | Sub-account operations are left out on purpose. Use the [console](https://cx.plivo.com/) or the [API](https://plivo.com/docs/account/api/subaccount.md). |
| `list_calls` misses older calls | Without an end time filter, Plivo searches the last 7 days. Ask for a date range of up to 30 days, within the last 90. |
| A tool isn't listed | Restart the app or reconnect the server. |
