# Connect ChatGPT to ClawCall with remote MCP

Canonical HTML: https://clawcall.dev/docs
ChatGPT guide: https://clawcall.dev/guides/chatgpt-mcp
Remote MCP endpoint: https://api.clawcall.dev/mcp

ClawCall gives ChatGPT and compatible AI hosts 11 bounded tools for user-directed, English-language phone calls to US +1 numbers. The remote MCP path uses OAuth; do not paste a ClawCall API key into ChatGPT.

## ChatGPT quickstart

1. Confirm ChatGPT Plugins / custom MCP and Developer mode are available for your plan, region, and workspace.
2. Turn on Developer mode in ChatGPT Settings.
3. Add a custom plugin or remote MCP server named `ClawCall`.
4. Enter `https://api.clawcall.dev/mcp` and choose OAuth.
5. Leave advanced OAuth client fields empty.
6. Sign in to ClawCall and approve `calls:read` and `calls:write`.
7. Refresh the 11 actions if the tool list is stale.
8. Verify without a call: “Check my ClawCall plan and remaining trial allowance. Do not place a call.”
9. Place the first controlled call only after confirming the destination, task, and decision boundaries.
10. Poll the call and read the complete transcript before reporting task success.

## OAuth discovery and security

ClawCall supports OAuth 2.1 authorization code with PKCE S256 and Dynamic Client Registration for public clients.

- Authorization-server metadata: `https://api.clawcall.dev/.well-known/oauth-authorization-server`
- Protected-resource metadata: `https://api.clawcall.dev/.well-known/oauth-protected-resource/mcp`
- Authorization endpoint: `https://api.clawcall.dev/authorize`
- Token endpoint: `https://api.clawcall.dev/token`
- Dynamic registration endpoint: `https://api.clawcall.dev/register`
- Revocation endpoint: `https://api.clawcall.dev/revoke`

An unauthenticated MCP request should return `401` with a `WWW-Authenticate` challenge pointing to protected-resource metadata. This checks discovery without placing a call.

The AI host receives revocable OAuth tokens, not a ClawCall API key. Disconnect in the host, then use ClawCall Dashboard → Settings → Connected AI assistants → Disconnect to revoke the connection's token family.

## Scopes

- `calls:read` — plan/trial state, call settings, reserved-number status, call lifecycle and outcome, transcripts, history, and temporary recording access.
- `calls:write` — user-requested call placement, hangup, and call-setting updates.

## MCP tools

1. `get_calling_guide`
2. `get_balance`
3. `get_call_settings`
4. `update_call_settings`
5. `place_call`
6. `place_call_and_wait`
7. `get_call`
8. `get_call_transcript`
9. `list_calls`
10. `get_recording`
11. `hangup_call`

Read `get_calling_guide` before ClawCall work. A real call is an external action. Confirm the number, task, context, constraints, and decision boundaries before invoking a write tool.

## Result model

- `lifecycle` answers whether the call is still active and where it is in the pipeline.
- `outcome` describes the phone-network result.
- The complete transcript is the evidence for whether the user's task succeeded.
- Recording URLs are temporary; request a fresh URL while one remains available.

## REST fallback

Custom trusted runtimes can use `https://api.clawcall.dev` with a server-side `X-Api-Key`. Never expose the key in a consumer prompt or browser bundle.

- `POST /call` — start an outbound call and receive `call_id`.
- `GET /call/:id` — read lifecycle, outcome, transcript, and recording metadata.
- `POST /call/:id/hangup` — stop an active call.
- `GET /balance` — read trial or account allowance.

## Current limits and plan wording

- Calls are limited to US +1 destinations and English today.
- Compatible-host availability can vary by host plan, region, workspace policy, admin settings, and Developer mode.
- Unlimited Reserve adds a private reserved caller-ID number for outbound calls.
- Unlimited Reserve Plus adds AI inbound answering on an active reserved number.
- Remote MCP availability is described neutrally; do not infer inclusion in every ClawCall plan or trial.

## More

- AI host compatibility: https://clawcall.dev/for-agents
- Pricing: https://clawcall.dev/pricing
- Security: https://clawcall.dev/security
- Concise machine index: https://clawcall.dev/llms.txt
- Detailed machine context: https://clawcall.dev/llms-full.txt