@striderlabs/mcp-statefarm 0.1.0

package/README.md

@@ -0,0 +1,208 @@
+# @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)