Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,8 @@ Straight from this repository, without the npm registry: `npx skills add didww/a

### Requirements

- [Claude Code](https://docs.claude.com/en/docs/claude-code) with the [DIDWW MCP](https://doc.didww.com/mcp/index.html) connected (`claude mcp add --scope user --transport http didww https://api.didww.com/mcp`, then `/mcp` to sign in). The skills do all carrier-side work through it, under your own account permissions.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) with the [DIDWW MCP](https://doc.didww.com/mcp/index.html) connected (`claude mcp add --scope user --transport http didww https://api.didww.com/mcp`, then `/mcp` to sign in). The skills configure the number and the inbound trunk through it, under your own account permissions. The MCP has no outbound trunk tools, so for agents that place calls the skills walk you through creating the outbound trunk and its 24-hour spend limit in the DIDWW User Panel.
- For outbound calls, access to [DIDWW outbound trunks](https://doc.didww.com/voice/outbound-trunks/get-access.html) on the account (an application DIDWW approves within 48 business hours).
- Node.js 16.7 or later for the installer; Python 3 for the skill scripts, which use the standard library only.
- An account on the voice platform you pair with. Each skill's README lists what it needs.

Expand Down
16 changes: 14 additions & 2 deletions docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,8 +12,20 @@ Draft pages for a new **AI agent skills** section of https://doc.didww.com/, one

- Plain Markdown. Convert to the site's source format (reStructuredText or MyST) as usual; the structure maps one to one.
- Admonitions use the GitHub syntax: `> [!NOTE]`, `> [!IMPORTANT]`, `> [!WARNING]`. They correspond to Sphinx `note`, `important` and `warning` directives.
- Cross-links between these pages are relative (`didww-to-vapi.md`); links into the existing site are absolute `https://doc.didww.com/...` URLs and were checked on 2026-10-01. Replace them with internal references when placing the pages.
- Cross-links between these pages are relative (`didww-to-vapi.md`); links into the existing site are absolute `https://doc.didww.com/...` URLs and were checked on 2026-10-01 (the outbound trunk links added on 2026-10-12). Replace them with internal references when placing the pages.
- No screenshots are included. Suggested ones: the `npx <skill>` installer output, Claude Code showing a skill triggering, and the DIDWW User Panel trunk form for one platform.
- Third-party prices are deliberately left out; the pages point to each provider's billing page instead. Platform details were verified in August 2026 (LiveKit in September 2026); the skills themselves carry the same date.
- Third-party prices are deliberately left out; the pages point to each provider's billing page instead. Platform details were verified in August 2026, LiveKit end to end on LiveKit Cloud in October 2026, and the DIDWW outbound trunk rules against the outbound trunk documentation on 2026-10-12.

## Changes since the first draft (2026-10-12)

If an earlier copy of these pages was already handed over, every page changed. Replace them all.

- **Outbound trunk.** The DIDWW MCP has no outbound trunk tools, so every page now says you create the outbound trunk in the User Panel (**Voice**, **Outbound Trunks**, **Create New**). The earlier draft said the MCP created it.
- **Spend limit.** The earlier draft recommended a 24-hour limit of 10 to 50 USD, below the trunk's minimum of 50. The pages now say: **24 Hour Limit (USD)** at 50 (the default is 3000), a capacity limit, the usage notification, caller ID limited to the DID and destinations limited to the countries called.
- **Outbound access.** A new "Before you begin" item on the pages that place calls: outbound trunk access must be approved first. On the Vapi page it is required even for inbound calls.
- **Allowed SIP IP addresses.** Each page gives the platform's source addresses for the outbound trunk, or says to contact DIDWW support where the platform publishes none.
- **Hosts.** The full list of outbound hosts: `nyc.us`, `lac.us`, `mia.us`, `fra.eu`, `ams.eu`, `sg` and `hk` `.out.didww.com`.
- **LiveKit page.** Trunks are encrypted by default (TLS on port 5061 plus SRTP SDES). The SIP URI is copied from the project settings rather than derived. `--outbound-only` is new, and the failure map is rewritten from tested calls.
- **OpenAI Realtime and xAI pages.** These pages handle inbound calls only, so they no longer ask for a 24-hour limit, just a capacity limit on the inbound trunk.

The content is generated from the skills in `../skills/<name>/SKILL.md` and the scripts' usage text. When a skill changes, update its page here in the same commit.
3 changes: 2 additions & 1 deletion docs/didww-connect.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,13 +20,14 @@ A skill is a folder of instructions and scripts that Claude Code reads when the

- An active [DIDWW account](https://my.didww.com/) with at least one DID number, or a balance to buy one. Numbers in registration-required countries add a verification wait.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in.
- The DIDWW MCP connected in Claude Code, so the agent can manage trunks and numbers under your account:
- The DIDWW MCP connected in Claude Code, so the agent can manage numbers and inbound trunks under your account:

```bash
claude mcp add --scope user --transport http didww https://api.didww.com/mcp
```

Then run `/mcp` inside Claude Code and sign in to the DIDWW User Panel when the browser opens. See [Getting started with DIDWW MCP](https://doc.didww.com/mcp/getting-started.html).
- For outbound calls, access to DIDWW outbound trunks on the account. If **Voice**, **Outbound Trunks** in the DIDWW User Panel shows **Get Access**, apply there first ([Get access to outbound trunks](https://doc.didww.com/voice/outbound-trunks/get-access.html)): it needs a business account with a company name and VAT/TAX ID, and DIDWW replies within 48 business hours. Inbound calls work without it.
- An idea of what the agent should do and what matters most: ease of setup, voice quality, EU region, bring-your-own model, developer control, or enterprise procurement.

## Step 1. Install the skill
Expand Down
3 changes: 2 additions & 1 deletion docs/didww-to-elevenlabs.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,13 +21,14 @@ This skill automates the steps described in the [ElevenLabs integration guide](h

- An active [DIDWW account](https://my.didww.com/) with at least one DID number, or a balance to buy one. Numbers in registration-required countries add a verification wait.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in.
- The DIDWW MCP connected in Claude Code, so the agent can manage trunks and numbers under your account:
- The DIDWW MCP connected in Claude Code, so the agent can manage numbers and inbound trunks under your account:

```bash
claude mcp add --scope user --transport http didww https://api.didww.com/mcp
```

Then run `/mcp` inside Claude Code and sign in to the DIDWW User Panel when the browser opens. See [Getting started with DIDWW MCP](https://doc.didww.com/mcp/getting-started.html).
- For outbound calls, access to DIDWW outbound trunks on the account. If **Voice**, **Outbound Trunks** in the DIDWW User Panel shows **Get Access**, apply there first ([Get access to outbound trunks](https://doc.didww.com/voice/outbound-trunks/get-access.html)): it needs a business account with a company name and VAT/TAX ID, and DIDWW replies within 48 business hours. Inbound calls work without it.
- An ElevenLabs account with an agent, or a description of the agent you want created.
- The ElevenLabs MCP connected in Claude Code (`claude mcp add --scope user --transport http elevenlabs https://api.elevenlabs.io/v1/mcp`, then `/mcp` to sign in), or an ElevenLabs API key for the import script only.

Expand Down
3 changes: 2 additions & 1 deletion docs/didww-to-livekit.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,13 +23,14 @@ LiveKit has no MCP; the script covers the whole SIP API in one run.

- An active [DIDWW account](https://my.didww.com/) with at least one DID number, or a balance to buy one. Numbers in registration-required countries add a verification wait.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in.
- The DIDWW MCP connected in Claude Code, so the agent can manage trunks and numbers under your account:
- The DIDWW MCP connected in Claude Code, so the agent can manage numbers and inbound trunks under your account:

```bash
claude mcp add --scope user --transport http didww https://api.didww.com/mcp
```

Then run `/mcp` inside Claude Code and sign in to the DIDWW User Panel when the browser opens. See [Getting started with DIDWW MCP](https://doc.didww.com/mcp/getting-started.html).
- For outbound calls, access to DIDWW outbound trunks on the account. If **Voice**, **Outbound Trunks** in the DIDWW User Panel shows **Get Access**, apply there first ([Get access to outbound trunks](https://doc.didww.com/voice/outbound-trunks/get-access.html)): it needs a business account with a company name and VAT/TAX ID, and DIDWW replies within 48 business hours. Inbound calls work without it.
- A LiveKit Cloud project, or a self-hosted LiveKit server with the SIP service.
- An API key and secret from the Cloud project's **Settings**, **API keys**. The secret is shown once. Note the **Project URL** (`wss://<project>.livekit.cloud`) and the **SIP URI** (`sip:<sip-subdomain>.sip.livekit.cloud`) on the same settings page. Their subdomains differ, so copy each value; do not derive one from the other.
- The `agent_name` your worker registers in its worker options (explicit dispatch).
Expand Down
2 changes: 1 addition & 1 deletion docs/didww-to-openai-realtime.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Use the **didww-to-openai-realtime** skill with **Claude Code** to point a DIDWW

- An active [DIDWW account](https://my.didww.com/) with at least one DID number, or a balance to buy one. Numbers in registration-required countries add a verification wait.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in.
- The DIDWW MCP connected in Claude Code, so the agent can manage trunks and numbers under your account:
- The DIDWW MCP connected in Claude Code, so the agent can manage numbers and inbound trunks under your account:

```bash
claude mcp add --scope user --transport http didww https://api.didww.com/mcp
Expand Down
3 changes: 2 additions & 1 deletion docs/didww-to-retell.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,13 +21,14 @@ This skill automates the steps described in the [Retell AI integration guide](ht

- An active [DIDWW account](https://my.didww.com/) with at least one DID number, or a balance to buy one. Numbers in registration-required countries add a verification wait.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in.
- The DIDWW MCP connected in Claude Code, so the agent can manage trunks and numbers under your account:
- The DIDWW MCP connected in Claude Code, so the agent can manage numbers and inbound trunks under your account:

```bash
claude mcp add --scope user --transport http didww https://api.didww.com/mcp
```

Then run `/mcp` inside Claude Code and sign in to the DIDWW User Panel when the browser opens. See [Getting started with DIDWW MCP](https://doc.didww.com/mcp/getting-started.html).
- For outbound calls, access to DIDWW outbound trunks on the account. If **Voice**, **Outbound Trunks** in the DIDWW User Panel shows **Get Access**, apply there first ([Get access to outbound trunks](https://doc.didww.com/voice/outbound-trunks/get-access.html)): it needs a business account with a company name and VAT/TAX ID, and DIDWW replies within 48 business hours. Inbound calls work without it.
- A Retell account and an API key from the dashboard's API Keys tab. The same key powers the Retell MCP.
- Optionally, the Retell MCP connected in Claude Code (`claude mcp add --scope user --transport http retell https://mcp.retellai.com` with your Bearer key).

Expand Down
3 changes: 2 additions & 1 deletion docs/didww-to-ultravox.md
Original file line number Diff line number Diff line change
Expand Up @@ -23,13 +23,14 @@ Ultravox has no official MCP. Two routing shapes exist, and the skill asks which

- An active [DIDWW account](https://my.didww.com/) with at least one DID number, or a balance to buy one. Numbers in registration-required countries add a verification wait.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in.
- The DIDWW MCP connected in Claude Code, so the agent can manage trunks and numbers under your account:
- The DIDWW MCP connected in Claude Code, so the agent can manage numbers and inbound trunks under your account:

```bash
claude mcp add --scope user --transport http didww https://api.didww.com/mcp
```

Then run `/mcp` inside Claude Code and sign in to the DIDWW User Panel when the browser opens. See [Getting started with DIDWW MCP](https://doc.didww.com/mcp/getting-started.html).
- For outbound calls, access to DIDWW outbound trunks on the account. If **Voice**, **Outbound Trunks** in the DIDWW User Panel shows **Get Access**, apply there first ([Get access to outbound trunks](https://doc.didww.com/voice/outbound-trunks/get-access.html)): it needs a business account with a company name and VAT/TAX ID, and DIDWW replies within 48 business hours. Inbound calls work without it.
- An Ultravox account with an agent, and an API key from `app.ultravox.ai`, Settings, API Keys, Generate New Key.
- For the fallback shape, somewhere to run a small public HTTPS endpoint.

Expand Down
3 changes: 2 additions & 1 deletion docs/didww-to-vapi.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,13 +24,14 @@ This skill automates the steps described in the [Vapi integration guide](https:/

- An active [DIDWW account](https://my.didww.com/) with at least one DID number, or a balance to buy one. Numbers in registration-required countries add a verification wait.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in.
- The DIDWW MCP connected in Claude Code, so the agent can manage trunks and numbers under your account:
- The DIDWW MCP connected in Claude Code, so the agent can manage numbers and inbound trunks under your account:

```bash
claude mcp add --scope user --transport http didww https://api.didww.com/mcp
```

Then run `/mcp` inside Claude Code and sign in to the DIDWW User Panel when the browser opens. See [Getting started with DIDWW MCP](https://doc.didww.com/mcp/getting-started.html).
- Access to DIDWW outbound trunks on the account, needed here even for inbound calls, because the Vapi credential that defines the inbound address carries the outbound trunk's credentials. If **Voice**, **Outbound Trunks** in the DIDWW User Panel shows **Get Access**, apply there first ([Get access to outbound trunks](https://doc.didww.com/voice/outbound-trunks/get-access.html)): it needs a business account with a company name and VAT/TAX ID, and DIDWW replies within 48 business hours.
- A Vapi account with an assistant, or its ID, and a Vapi API key from `dashboard.vapi.ai/org/api-keys` (shown once at creation).
- A decision on region: US or EU.

Expand Down
3 changes: 2 additions & 1 deletion docs/didww-to-vogent.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,13 +19,14 @@ Use the **didww-to-vogent** skill with **Claude Code** to connect a DIDWW phone

- An active [DIDWW account](https://my.didww.com/) with at least one DID number, or a balance to buy one. Numbers in registration-required countries add a verification wait.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in.
- The DIDWW MCP connected in Claude Code, so the agent can manage trunks and numbers under your account:
- The DIDWW MCP connected in Claude Code, so the agent can manage numbers and inbound trunks under your account:

```bash
claude mcp add --scope user --transport http didww https://api.didww.com/mcp
```

Then run `/mcp` inside Claude Code and sign in to the DIDWW User Panel when the browser opens. See [Getting started with DIDWW MCP](https://doc.didww.com/mcp/getting-started.html).
- For outbound calls, access to DIDWW outbound trunks on the account. If **Voice**, **Outbound Trunks** in the DIDWW User Panel shows **Get Access**, apply there first ([Get access to outbound trunks](https://doc.didww.com/voice/outbound-trunks/get-access.html)): it needs a business account with a company name and VAT/TAX ID, and DIDWW replies within 48 business hours. Inbound calls work without it.
- A Vogent account with an agent, and an API key from the API Keys page in the `app.vogent.ai` sidebar.

## Step 1. Install the skill
Expand Down
2 changes: 1 addition & 1 deletion docs/didww-to-xai.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,7 +21,7 @@ Use the **didww-to-xai** skill with **Claude Code** to point a DIDWW phone numbe

- An active [DIDWW account](https://my.didww.com/) with at least one DID number, or a balance to buy one. Numbers in registration-required countries add a verification wait.
- [Claude Code](https://docs.claude.com/en/docs/claude-code) installed and signed in.
- The DIDWW MCP connected in Claude Code, so the agent can manage trunks and numbers under your account:
- The DIDWW MCP connected in Claude Code, so the agent can manage numbers and inbound trunks under your account:

```bash
claude mcp add --scope user --transport http didww https://api.didww.com/mcp
Expand Down
1 change: 1 addition & 0 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,7 @@ DIDWW publishes a family of **agent skills** for **Claude Code** that put an AI
```

Then run `/mcp` inside Claude Code and sign in to the DIDWW User Panel. See [Getting started with DIDWW MCP](https://doc.didww.com/mcp/getting-started.html).
- For outbound calls, access to DIDWW outbound trunks on the account. If **Voice**, **Outbound Trunks** in the DIDWW User Panel shows **Get Access**, apply there first ([Get access to outbound trunks](https://doc.didww.com/voice/outbound-trunks/get-access.html)): it needs a business account with a company name and VAT/TAX ID, and DIDWW replies within 48 business hours. Inbound calls work without it.

- An account on the voice platform you intend to use. Each skill page lists what it needs.

Expand Down
5 changes: 3 additions & 2 deletions skills/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,8 +3,9 @@
The nine skills, one folder each. The table of skills, install instructions and requirements are in the [root README](../README.md); this page covers the folder itself.

Claude Code skills that put an AI voice agent on a DIDWW phone number. One hub skill picks
the platform and does the universal DIDWW wiring (number, inbound and outbound SIP trunks,
digest auth, spend limits, verification calls); eight pairing skills cover one voice platform
the platform and does the universal DIDWW wiring (number and inbound SIP trunk through the
DIDWW MCP, digest auth, the outbound trunk and its 24-hour spend limit guided in the DIDWW
User Panel, verification calls); eight pairing skills cover one voice platform
each, as automatically as that platform's API and MCP allow.

## Install
Expand Down
Loading