Cursor — Dial Agent

Dial Agent is Payphone's agent-native product for Cursor: SMS, number provisioning, telephony/OSINT tools, and optional milestone texts to the operator. Setup uses DIAL_API_KEY credits by default — not wallet x402 for every send.

Quick setup

One-click deeplinks: Connect → Dial Agent

What the plugin includes

Install copies packages/cursor-plugin → ~/.cursor/plugins/local/dial. Uninstall: pnpm cursor:plugin:uninstall.

Environment (credits mode)

export DIAL_API_URL=https://payphone.wtf
export DIAL_API_KEY=dial_live_…          # dashboard → Cursor / agent key
export DIAL_NOTIFY_PHONE=+1XXXXXXXXXX    # optional — milestone SMS to you

Mint keys at dashboard billing. Default scopes: account:read, sms:send, numbers:read, numbers:buy.

HTTP 200 on POST /api/v1/sms/send = queued, not delivered. Confirm via messages.status, inbox, or dashboard threads before claiming SMS works.

MCP OAuth

The plugin registers MCP at https://payphone.wtf/mcp. In Cursor:

1. Plugin MCP Servers → dial → Login
2. Sign in with the Payphone account that holds credits
3. Paid tools can use credits or x402 USDC on Base per tool policy

Logout in Cursor revokes the refresh token.

MCP-only (without plugin)

If you prefer project-level MCP only, paste into .cursor/mcp.json:

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

Reload MCP servers and Login when prompted. The Dial Agent plugin is still recommended — it bundles rules, skills, and commands.

Deeplinks

Cursor supports prompt and rule deeplinks. The connect pages generate links that pre-fill a setup prompt — you review and confirm before anything runs.

• Web: https://cursor.com/link/prompt?text=...
• App: cursor://anysphere.cursor-deeplink/prompt?text=...

See also

• Agent quickstart
• MCP integration
• Connect hub — /connect/skill and /connect/mcp