# @striderlabs/mcp-statefarm

> State Farm Insurance connector for personal AI agents — get quotes, manage policies, file claims, and more.

Built by [Strider Labs](https://striderlabs.ai) using the [Model Context Protocol](https://modelcontextprotocol.io).

---

## Features

- **Insurance Quotes** — Get auto, home, life, and renters quotes with estimated premiums
- **Policy Management** — Look up policy details, coverage, and renewal dates
- **Claims** — File new claims and check status on existing ones
- **Payments** — View balances, make payments, and manage autopay
- **Digital ID Cards** — Access and share your auto insurance ID card
- **Find Local Agents** — Locate State Farm agents near any address
- **Roadside Assistance** — Request towing, battery jumps, lockout help, and more
- **Bundle Recommendations** — Get personalized multi-policy bundle suggestions with savings estimates

---

## Installation

```bash
npm install -g @striderlabs/mcp-statefarm
```

Or run directly with npx:

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

---

## MCP Client Configuration

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "statefarm": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-statefarm"]
    }
  }
}
```

### Generic MCP Client

```json
{
  "servers": {
    "statefarm": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-statefarm"],
      "transport": "stdio"
    }
  }
}
```

---

## Available Tools

| Tool | Description |
|------|-------------|
| `statefarm_get_quote` | Get insurance quotes for auto, home, life, or renters |
| `statefarm_policy_details` | View policy coverage, deductibles, and renewal info |
| `statefarm_file_claim` | Initiate a new insurance claim |
| `statefarm_claim_status` | Check status on an existing claim |
| `statefarm_payment` | View balance, make payments, manage autopay |
| `statefarm_digital_id_card` | Get your auto insurance ID card |
| `statefarm_find_agent` | Find State Farm agents near a location |
| `statefarm_roadside_assistance` | Request or check roadside assistance |
| `statefarm_bundle_recommendations` | Get personalized bundle savings recommendations |

---

## Usage Examples

### Get an Auto Insurance Quote

```
Get me an auto insurance quote for a 2021 Toyota Camry in ZIP code 90210 for 2 drivers.
```

The agent will call `statefarm_get_quote` with:
```json
{
  "insurance_type": "auto",
  "zip_code": "90210",
  "vehicle_year": 2021,
  "vehicle_make": "Toyota",
  "vehicle_model": "Camry",
  "drivers_count": 2
}
```

### File a Claim

```
I was in a car accident today at 3pm at 123 Main St. My policy number is 123-4567-A01. Another driver was involved.
```

The agent will call `statefarm_file_claim` with the incident details and return a reference number plus step-by-step filing instructions.

### Get Bundle Recommendations

```
I own a home and a car in ZIP 60601. I have 3 kids and make about $120k/year. What should I bundle?
```

The agent will call `statefarm_bundle_recommendations` and return prioritized bundle options with estimated savings.

### Request Roadside Assistance

```
My car battery died. I'm at 456 Oak Ave, Chicago. My callback number is 312-555-0100.
```

The agent will call `statefarm_roadside_assistance` with `action: "request_service"` and `service_type: "battery_jump"`.

### Find a Local Agent

```
Find me a Spanish-speaking State Farm agent near Dallas, TX.
```

The agent will call `statefarm_find_agent` with location and language filter, returning a link to the agent locator pre-filtered for your search.

---

## Tool Reference

### `statefarm_get_quote`

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `insurance_type` | `"auto" \| "home" \| "life" \| "renters"` | ✅ | Type of insurance |
| `zip_code` | string | ✅ | Quote location |
| `vehicle_year` | number | Auto only | Model year |
| `vehicle_make` | string | Auto only | Manufacturer |
| `vehicle_model` | string | Auto only | Model name |
| `drivers_count` | number | Auto only | Number of drivers |
| `home_value` | number | Home only | Estimated home value (USD) |
| `home_year_built` | number | Home only | Year built |
| `home_sq_ft` | number | Home only | Square footage |
| `coverage_amount` | number | Life only | Desired coverage (USD) |
| `applicant_age` | number | Life only | Applicant age |
| `life_type` | `"term" \| "whole" \| "universal"` | Life only | Policy type |
| `personal_property_value` | number | Renters only | Belongings value (USD) |

### `statefarm_roadside_assistance`

| Action | Description |
|--------|-------------|
| `request_service` | Dispatch roadside help to your location |
| `check_coverage` | Verify if your policy includes roadside |
| `track_service` | Track a dispatched service provider |

Available service types: `towing`, `battery_jump`, `flat_tire`, `fuel_delivery`, `lockout`, `winching`

### `statefarm_payment`

| Action | Description |
|--------|-------------|
| `view_balance` | See current amount due |
| `payment_history` | View past payments |
| `make_payment` | Pay your bill |
| `setup_autopay` | Enable automatic payments |
| `cancel_autopay` | Disable automatic payments |
| `update_payment_method` | Change bank account or card |

---

## Notes

- This connector provides guidance and structured information to help AI agents assist with State Farm insurance tasks
- Actions that require account access (payments, policy details) include direct links and instructions for completing them through State Farm's secure portal
- For emergencies, always call **1-800-STATE-FARM (1-800-782-8332)** or **911** directly
- Digital ID cards are legally accepted in all 50 US states

---

## Development

```bash
git clone https://github.com/striderlabs/mcp-statefarm
cd mcp-statefarm
npm install
npm run build
node dist/index.js
```

---

## Links

- [Strider Labs](https://striderlabs.ai)
- [Model Context Protocol](https://modelcontextprotocol.io)
- [State Farm](https://www.statefarm.com)
- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)