Dial x402

MCP (Model Context Protocol)

Use Dial x402 as an MCP server for any AI agent framework.

MCP Integration

Dial can be used as an MCP server, giving any MCP-compatible agent (Claude Desktop, Cursor, OpenClaw, etc.) access to telephony and OSINT primitives.

MCP Tools

ToolDescriptionx402 Price
dial_send_smsSend SMS to a phone number$0.10
dial_lookup_phoneReverse phone number lookup$0.05
dial_breach_searchSearch breach data$0.05
dial_buy_creditsBuy prepaid credits$0.10
dial_check_balanceCheck credit balanceFree

Configuration

Claude Desktop

Add to ~/.claude/mcp.json:

{
  "mcpServers": {
    "dial": {
      "command": "npx",
      "args": ["@dial/mcp"],
      "env": {
        "DIAL_API_URL": "https://x402.dial.wtf",
        "DIAL_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json in your project:

{
  "mcpServers": {
    "dial": {
      "command": "npx",
      "args": ["@dial/mcp"],
      "env": {
        "DIAL_API_URL": "https://x402.dial.wtf",
        "DIAL_PRIVATE_KEY": "0xYOUR_PRIVATE_KEY"
      }
    }
  }
}

x402 Payment Flow in MCP

When an MCP tool requires payment:

  1. The MCP server calls the Dial API
  2. If the response is 402, it automatically signs an x402 payment
  3. Payment settles on Base in ~1 second
  4. The result is returned to the agent

The agent never needs to handle payment logic — it's all transparent.

On this page