@thisispamela/mcp

MCP (Model Context Protocol) server for the Pamela Voice API. Exposes tools so AI assistants (e.g. Claude Desktop) can create and manage AI-powered phone calls.

Tools

| Tool | Description | |------|-------------| | pamela_create_call | Make an AI-powered phone call (to, task, optional voice, agentName, callerName, etc.) | | pamela_get_call | Fetch a call by ID (status, transcript, summary) | | pamela_list_calls | List recent calls (optional limit, status, offset, startDate, endDate) | | pamela_cancel_call | Cancel an in-progress call |

Setup

1. Install

   npm install -g @thisispamela/mcp
   # or from repo
   cd sdk/mcp && npm install && npm run build

2. Configure

   Set your Pamela API key (required): Get your API key from developer.thisispamela.com.

   export PAMELA_API_KEY=your_api_key

   Optional:

   • PAMELA_BASE_URL — API base URL (default: https://api.thisispamela.com)
   • PAMELA_MCP_TRANSPORT — stdio (default) or http
   • PAMELA_MCP_PORT — HTTP port when using PAMELA_MCP_TRANSPORT=http (default: 8033)

3. Run

   npx @thisispamela/mcp
   # or
   node dist/index.js

   HTTP mode:

   PAMELA_MCP_TRANSPORT=http PAMELA_MCP_PORT=8033 node dist/index.js

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent config path on your system:

{
  "mcpServers": {
    "pamela": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/sdk/mcp/dist/index.js"],
      "env": {
        "PAMELA_API_KEY": "your_api_key"
      }
    }
  }
}

Use the absolute path to sdk/mcp/dist/index.js after building. Restart Claude Desktop after changing the config.

HTTP Transport

When PAMELA_MCP_TRANSPORT=http, the server listens on http://localhost:8033 by default (Streamable HTTP transport).

OAuth Token Support

The MCP server supports both API keys and OAuth access tokens:

# API key (default)
export PAMELA_API_KEY=pk_live_xxx

# OR OAuth token
export PAMELA_ACCESS_TOKEN=at_xxx

If both are set, OAuth token takes precedence.

Development

cd sdk/mcp
npm install
npm run build

Then run with node dist/index.js and ensure PAMELA_API_KEY or PAMELA_ACCESS_TOKEN is set.

Requirements

• Node.js 18+
• Pamela API key or OAuth access token
• @thisispamela/sdk ^1.1.3 or higher