Skip to main content
CallingBox ships an agent skill that coding agents like Cursor, Claude Code, and ChatGPT can load to get your project from zero to a first completed phone call without you walking them through each step. The skill detects whether to use the Python SDK, TypeScript SDK, CLI, or hosted MCP, handles API key setup, provisions a phone number, creates an outbound agent with a returns schema, dispatches the first call, and polls to a terminal status.

​
Install

/plugin marketplace add callingbox/callingbox-skills
/plugin install callingbox-install@callingbox-skills
Once installed, ask your coding agent something like “set up CallingBox in this project” or “place an AI phone call to +1…” and it will load the skill and follow the embedded playbooks.

​
What the skill does

  • Detects whether your project is Python, TypeScript, or neither, and picks the matching interface: Python SDK, TypeScript SDK, CLI, or hosted MCP.
  • Walks through API key creation at app.callingbox.io/keys and wires CALLINGBOX_API_KEY into the environment (never hardcoded in source).
  • Lists existing numbers, and if none are owned, searches and purchases one.
  • Creates an outbound agent with a flat returns schema.
  • Dispatches the first call, polls until completed | no_answer | busy | canceled | failed, and reads the structured result.
  • Falls back to a troubleshooting decision tree for auth failures, rejected from_number, calls stuck below a terminal status, or empty results.

​
Next steps

GitHub repo

Browse the SKILL.md router and the Python, TypeScript, CLI, MCP, and troubleshooting playbooks.

Manual quickstart

Prefer to do it yourself? Create an agent and place your first call in five minutes.