# @striderlabs/mcp-xfinity

MCP server for Xfinity/Comcast ISP account management. Automates common account tasks via browser automation using Playwright and Browserbase.

## Tools

| Tool | Description |
|------|-------------|
| `get_account_overview` | Current plan, balance, due date, and service summary |
| `get_usage_details` | Internet data usage — GB used, cap, days remaining |
| `pay_bill` | Make a one-time bill payment |
| `get_bill_history` | View past bills (up to 24 months) |
| `check_outages` | Check for service outages in an area |
| `restart_equipment` | Remotely restart modem/router |

## Requirements

- [Browserbase](https://www.browserbase.com/) account with a CDP-enabled session URL
- Xfinity account credentials

## Environment Variables

| Variable | Required | Description |
|----------|----------|-------------|
| `BROWSERBASE_CDP_URL` | Yes | Browserbase CDP WebSocket URL |
| `XFINITY_USERNAME` | Yes | Xfinity account username or email |
| `XFINITY_PASSWORD` | Yes | Xfinity account password |

## Installation

```bash
npm install @striderlabs/mcp-xfinity
```

Or use directly with `npx`:

```bash
npx @striderlabs/mcp-xfinity
```

## Claude Desktop Configuration

Add to your `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "xfinity": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-xfinity"],
      "env": {
        "BROWSERBASE_CDP_URL": "wss://connect.browserbase.com?apiKey=YOUR_API_KEY&sessionId=YOUR_SESSION_ID",
        "XFINITY_USERNAME": "your@email.com",
        "XFINITY_PASSWORD": "yourpassword"
      }
    }
  }
}
```

## Usage Examples

Once configured, you can ask Claude:

- *"What's my current Xfinity balance and due date?"*
- *"How much internet data have I used this month?"*
- *"Pay my Xfinity bill for $85"*
- *"Show me my last 3 months of Xfinity bills"*
- *"Are there any Xfinity outages at 123 Main St, Chicago?"*
- *"Restart my Xfinity modem"*

## How It Works

Each tool call:
1. Connects to a Browserbase remote Chrome instance via CDP
2. Authenticates to xfinity.com using your credentials
3. Navigates to the relevant page and extracts or submits data
4. Returns structured JSON results

## Security Notes

- Credentials are passed via environment variables, never hardcoded
- Each tool call uses a fresh browser context
- Browserbase isolates sessions in secure cloud environments
- The `pay_bill` tool requires explicit confirmation before submitting payment

## License

MIT