Dial x402

MCP (Model Context Protocol)

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

MCP Integration

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

Add MCP →Connect hub

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

One-click install: Connect MCP — black Add to Cursor / Claude / Codex buttons with deeplinks plus copy-paste config.

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

Remote server (Streamable HTTP)

Hosted MCP at https://x402.dial.wtf/mcpPOST only (do not open in a browser).

Configuration by client

Cursor (remote URL)

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "dial": {
      "url": "https://x402.dial.wtf/mcp"
    }
  }
}

Paid tools require x402 payment on Base; use withPayment() from x402-mcp in code, or a client that signs USDC for tool calls.

Local stdio server

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 (stdio)

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