ThunderPhone for developers

Build phone agents from your coding agent.

Give Claude Code, Codex, or Cursor the product knowledge and tools it needs. Then build against the same API directly.

Skills

npx skills add thunderphone/skills

Teaches your coding agent ThunderPhone setup patterns, API workflows, testing, webhooks, and production checks.

Browse the skills repository

MCP

The docs server lists, searches, and reads pages. The authenticated API server covers agents, phone numbers, calls and transcripts, test scenarios and grades, knowledge, tools and webhooks, campaigns, voices, and imports from other platforms.

Claude Code

claude mcp add --transport http thunderphone-docs https://thunderphone.com/docs/mcp

Codex

[mcp_servers.thunderphone-docs]
url = "https://thunderphone.com/docs/mcp"

Cursor

{"mcpServers":{"thunderphone-docs":{"url":"https://thunderphone.com/docs/mcp"}}}

Configure the docs MCP server

API + SDK

Use the REST API directly, or generate a typed client from the OpenAPI schema. Python and TypeScript SDKs are in progress.

# Create an agent
curl -X POST https://api.thunderphone.com/v1/agents \
  -H "Authorization: Bearer $THUNDERPHONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Customer Support","prompt":"You are a friendly support agent for Acme Corp. Help with orders, returns, and product info. Be concise and helpful.","voice":"john","product":"spark"}'

# Provision an inbound ThunderPhone number
curl -X POST https://api.thunderphone.com/v1/phone-numbers \
  -H "Authorization: Bearer $THUNDERPHONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code":"415"}'

# Place a call from an outbound-enabled VoIP number
curl -X POST https://api.thunderphone.com/v1/call \
  -H "Authorization: Bearer $THUNDERPHONE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"from_number":"+15551234567","to_number":"+14155550199","agent_id":12}'

# Read the transcript
curl https://api.thunderphone.com/v1/calls/{call_id}/transcript \
  -H "Authorization: Bearer $THUNDERPHONE_API_KEY"

Open the OpenAPI schema

Start with context

Paste this into your agent

Help me build a ThunderPhone phone agent.
1. Read https://thunderphone.com/llms.txt.
2. Read https://thunderphone.com/docs/guides/coding-agents.
3. Add https://thunderphone.com/docs/mcp as a read-only MCP server.
4. Install the skills with: npx skills add thunderphone/skills
5. Ask me what the agent should do and which calls it will handle.
6. Create the smallest working agent configuration.
7. Keep API keys in environment variables, never source files.
8. Use the OpenAPI spec when an endpoint detail is unclear.
9. Test before placing a real outbound call.
10. Show me the exact commands and files you changed.