Dial x402

Claude Code

Use Dial x402 telephony primitives directly from Claude Code.

Claude Code Integration

One-click setup — review the prompt in your editor, then confirm. Manual config snippets are on each page.

Add skill →Connect hub

The Dial skill (/dial) lets Claude Code send SMS, look up phone numbers, and search breach data — all paid via x402. Pair it with MCP for tool calls in any Claude Code session.

One-click install: Connect skill · Connect MCP

Setup

1. Set environment variables

export DIAL_API_URL=https://x402.dial.wtf
export DIAL_PRIVATE_KEY=0xYOUR_EVM_PRIVATE_KEY   # For x402 payments
export DIAL_EVM_NETWORK=eip155:8453              # Base mainnet

2. Install the skill (plugin)

From a clone of Dial-WTF/x402-dial:

claude /plugin install ./packages/skill

Or use the Claude Code deep link from /connect/skill — opens Claude Code with install steps prefilled (claude-cli://open?...).

Once installed, use the /dial slash command.

3. MCP (optional)

Add remote MCP at https://x402.dial.wtf/mcp — see MCP integration.

Usage examples

Send SMS

/dial send SMS to +1234567890 saying "Server is back online"

Look up a phone number

/dial look up +1234567890 — get carrier, line type, and caller name

Search breach data

/dial search breaches for email:admin@example.com

How payment works

  1. Claude Code uses your DIAL_PRIVATE_KEY to create an x402-wrapped fetch
  2. When calling a Dial endpoint, the 402 response is handled automatically
  3. Your wallet signs a USDC authorization (EIP-3009)
  4. Payment settles on Base mainnet (~1 second)
  5. The resource is returned to Claude Code

Environment variables

VariableRequiredDescription
DIAL_API_URLYesDial API base URL
DIAL_PRIVATE_KEYFor x402EVM private key for signing payments
DIAL_PRIVY_ACCESS_TOKENFor creditsPrivy Bearer token for credit-based calls
DIAL_EVM_NETWORKNoDefault: eip155:84532 (Base Sepolia)

Security notes

  • Never expose your private key in logs or commit it to git
  • Breach search results with passwords are redacted by default
  • x402 payments are on-chain and irreversible

On this page