@striderlabs/mcp-verizon

MCP server for Verizon Wireless account management. Automates account interactions via Playwright + Browserbase.

Tools

| Tool | Description | |------|-------------| | get_account_overview | Current plan, balance, usage summary | | get_usage_details | Detailed data/call/text breakdown | | pay_bill | One-time payment (dry-run by default) | | get_bill_history | Past bills and payment history | | check_upgrade_eligibility | Device upgrade eligibility per line |

Setup

Environment Variables

# Required
BROWSERBASE_CDP_URL=wss://connect.browserbase.com?apiKey=YOUR_KEY&sessionId=SESSION_ID
[email protected]
VERIZON_PASSWORD=yourpassword

# Optional — set to enable real payments (disabled by default for safety)
VERIZON_PAYMENT_ENABLED=true

Install & Build

npm install
npm run build

Usage with Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "verizon": {
      "command": "node",
      "args": ["/path/to/mcp-verizon/dist/index.js"],
      "env": {
        "BROWSERBASE_CDP_URL": "wss://...",
        "VERIZON_USERNAME": "[email protected]",
        "VERIZON_PASSWORD": "yourpassword"
      }
    }
  }
}

Usage with npx (from tarball)

BROWSERBASE_CDP_URL=wss://... VERIZON_USERNAME=... VERIZON_PASSWORD=... \
  npx @striderlabs/mcp-verizon

Tool Details

get_account_overview

No parameters. Returns plan name, monthly charge, current balance, due date, autopay status, and active lines.

get_usage_details

• lineNumber (optional): Filter to a specific line (e.g. "2125551234")

Returns data used/remaining, call minutes, text messages for the current billing cycle.

pay_bill

• amount (required): Payment amount in USD
• paymentMethodLast4 (optional): Last 4 digits of payment method

Safety: Payment submission is disabled by default. Set VERIZON_PAYMENT_ENABLED=true to enable real payments.

get_bill_history

• months (optional): Number of months to retrieve (default: 12)

check_upgrade_eligibility

• lineNumber (optional): Check a specific line; omit for all lines

Architecture

Uses Browserbase for cloud browser sessions via Chrome DevTools Protocol (CDP). The server connects with chromium.connectOverCDP(BROWSERBASE_CDP_URL) and automates verizon.com flows using Playwright.

Each tool call opens a browser session, authenticates if needed, navigates to the relevant page, scrapes the data, and closes the session.