> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://agentphone.to/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://agentphone.to/docs/_mcp/server.

# Claude Code Skill

> Use AgentPhone directly from Claude Code with the official skill

The **AgentPhone Skill** for [Claude Code](https://claude.com/claude-code) gives you phone numbers, voice calls, and SMS right from the command line — no setup beyond an API key.

## Installation

```bash
npx skills add AgentPhone-AI/skills
```

Select Claude Code and the desired project/global scope in the installer. Cloning the repository alone does not install it into the client’s skill directory. Verify that `/agentphone` appears in the client before continuing.

## Configuration

Set your API key as an environment variable:

```bash
export AGENTPHONE_API_KEY=your_key_here
```

Get your API key from [agentphone.ai/settings](https://agentphone.ai/settings).

## Features

The skill gives the assistant instructions and references for AgentPhone workflows:

| Capability              | Description                                                  |
| ----------------------- | ------------------------------------------------------------ |
| **Account Overview**    | Get a snapshot of agents, numbers, webhooks, and usage       |
| **Agents**              | Create, update, delete, and list AI voice agents             |
| **Phone Numbers**       | Buy, list, release numbers, and attach to agents             |
| **Voice Calls**         | Make AI-powered outbound calls with autonomous conversations |
| **SMS & Conversations** | Read messages, view conversation threads                     |
| **Webhooks**            | Set up project-level and per-agent webhook endpoints         |
| **Usage & Billing**     | Check usage counts and limits; use Billing for balance       |
| **Voices**              | List available voices for agent configuration                |

## Example Usage

```
> /agentphone create an agent called Support Bot

> /agentphone buy a US phone number with area code 415

> /agentphone call +14155551234 and ask about their return policy

> /agentphone show me recent calls and transcripts

> /agentphone check my SMS conversations

> /agentphone set up a webhook at https://my-server.com/hook

> /agentphone show my usage stats

> /agentphone what voices are available?
```

## How It Works

The skill is an instruction package with REST API and MCP references. The assistant can call the REST API with your key, or use an MCP server you have configured separately. Installing the skill does not start a server or grant new credentials.

Resource purchases, messages, and calls have the same [pricing](/docs/usage) and channel requirements as direct API requests. Start with a read-only request such as listing your agents to verify setup.

## Resources

* [GitHub Repository](https://github.com/AgentPhone-AI/skills)
* [MCP Server Docs](/docs/mcp)
* [API Reference](/docs/api-reference)
* [AgentPhone Console](https://agentphone.ai)