State Farm MCP server for AI agents
Let Claude, ChatGPT or your own agent read State Farm: 4 typed functions through one MCP server. No State Farm API key needed.
- Site
- statefarm.com
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for State Farm alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/statefarmOne MCP server for State Farm and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
findAgentReturns the State Farm agents near a ZIP or city.Arguments
Name Type Required query.citystringCity name ("Oklahoma City") or State Farm's own slug ("oklahoma-city").Yes query.statestringTwo-letter state code, e.g. "IL".Yes query.zipstringOptional filter on each office's OWN ZIP.No limitnumberNo Returns
StatefarmAgent[]/** One State Farm agency office, as the directory publishes it. A null means the * directory published nothing for that field, never that parsing failed. */ interface StatefarmAgent { name: string; url: string; /** The 11-char associate id at the tail of the agent's URL slug, the site's own * office key, stable across a name change. Null when the slug carries none. */ officeId: string | null; street: string | null; /** The city as the DIRECTORY spells it, which is not always what you passed. */ city: string | null; state: string | null; zip: string | null; /** The full ZIP+4 as published ("62704-1375"), or null where the directory * stated only five digits. */ zipPlus4: string | null; /** Ten digits, no punctuation, exactly as published. */ phone: string | null; description: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/statefarm/findAgentCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.statefarm.findAgent({ city: "Chicago", state: "IL" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.statefarm.findAgent({"city": "Chicago", "state": "IL"}))curl -X POST https://api.bowmark.ai/v1/sites/statefarm/findAgent \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"city":"Chicago","state":"IL"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.statefarm.findAgent({ city: "Chicago", state: "IL" });getBusinessQuoteReturns a real State Farm Business Owners Policy price for one small business.Arguments
Name Type Required identityQuoteIdentityThe CALLER's own identity.Yes businessNamestringYes businessDescriptionstringOne of the 82 trade classifications State Farm rates online, e.g. "AccountingServices".Yes organizationTypestringE.g. "Limited Liability Company".Yes yearBusinessStartedstringFour-digit year.Yes addressLine1stringYes addressLine2stringNo citystringYes statestringThe full state NAME as the engine's own allowed values spell it ("Illinois", not "IL").Yes postalCodestringFive digits; the engine normalises to ZIP+4.Yes occupancystring"tenant", "owneroccupant" or "businresidence". owneroccupant is a soft kickout.Yes annualReceiptsstringGross, whole dollars.Yes squareFeetstringOccupied floor area of the location.Yes yearBuiltstringYes businessPersonalPropertyLimitstringWhole dollars.Yes numberOfEmployeesstringYes numberOfOfficersDirectorsstringYes tenantImprovementsAmountstringTenant improvements and betterments, whole dollars.No hasPriorLossesInFiveYearsbooleanUNDERWRITING FACTS, with no defaults on purpose: State Farm treats two of them as a HARD kickout.Yes hasExistingStateFarmBusinessPolicybooleanYes hadInsuranceCancelledOrDeniedInThreeYearsbooleanYes acknowledgesPrivacyDisclosurebooleanThe caller's acknowledgement of State Farm's privacy disclosure, which its form requires before it will rate.Yes effectiveDatestringPolicy start, "MM-DD-YYYY".No Returns
StatefarmBusinessQuote/** One State Farm Business Owners Policy price. A null means State Farm * published nothing for that field, a failed parse THROWS. */ interface StatefarmBusinessQuote { quoteId: string; transactionNumber: string | null; status: string; // "QUOTED" when a price came back /** State Farm's assumed monthly instalment. */ monthlyPremium: number | null; /** The whole 12-month policy, the comparable figure. */ fullTermPremium: number | null; baseDeductible: number | null; // the policy-level deductible the price assumes effectiveDate: string | null; /** Named discounts and charges, SIGNED, negative is a discount. */ adjustments: StatefarmBusinessAdjustment[]; /** Every coverage in the bundle, whether or not it is switched on. */ coverages: StatefarmBusinessCoverage[]; /** State Farm's own words for what this number is. A price, not an offer. */ disclaimer: string; } interface StatefarmBusinessAdjustment { description: string; category: string; amount: number; } interface StatefarmBusinessCoverage { name: string; category: string; selected: boolean; required: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/statefarm/getBusinessQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.statefarm.getBusinessQuote({ identity: {}, businessName: "<businessName>", businessDescription: "<businessDescription>", organizationType: "<organizationType>", yearBusinessStarted: "<yearBusinessStarted>", addressLine1: "<addressLine1>", city: "<city>", state: "<state>", postalCode: "<postalCode>", occupancy: "<occupancy>", annualReceipts: "<annualReceipts>", squareFeet: "<squareFeet>", yearBuilt: "<yearBuilt>", businessPersonalPropertyLimit: "<businessPersonalPropertyLimit>", numberOfEmployees: "<numberOfEmployees>", numberOfOfficersDirectors: "<numberOfOfficersDirectors>", hasPriorLossesInFiveYears: true, hasExistingStateFarmBusinessPolicy: true, hadInsuranceCancelledOrDeniedInThreeYears: true, acknowledgesPrivacyDisclosure: true });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.statefarm.getBusinessQuote({ "identity": {}, "businessName": "<businessName>", "businessDescription": "<businessDescription>", "organizationType": "<organizationType>", "yearBusinessStarted": "<yearBusinessStarted>", "addressLine1": "<addressLine1>", "city": "<city>", "state": "<state>", "postalCode": "<postalCode>", "occupancy": "<occupancy>", "annualReceipts": "<annualReceipts>", "squareFeet": "<squareFeet>", "yearBuilt": "<yearBuilt>", "businessPersonalPropertyLimit": "<businessPersonalPropertyLimit>", "numberOfEmployees": "<numberOfEmployees>", "numberOfOfficersDirectors": "<numberOfOfficersDirectors>", "hasPriorLossesInFiveYears": True, "hasExistingStateFarmBusinessPolicy": True, "hadInsuranceCancelledOrDeniedInThreeYears": True, "acknowledgesPrivacyDisclosure": True }))curl -X POST https://api.bowmark.ai/v1/sites/statefarm/getBusinessQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"identity":{},"businessName":"<businessName>","businessDescription":"<businessDescription>","organizationType":"<organizationType>","yearBusinessStarted":"<yearBusinessStarted>","addressLine1":"<addressLine1>","city":"<city>","state":"<state>","postalCode":"<postalCode>","occupancy":"<occupancy>","annualReceipts":"<annualReceipts>","squareFeet":"<squareFeet>","yearBuilt":"<yearBuilt>","businessPersonalPropertyLimit":"<businessPersonalPropertyLimit>","numberOfEmployees":"<numberOfEmployees>","numberOfOfficersDirectors":"<numberOfOfficersDirectors>","hasPriorLossesInFiveYears":true,"hasExistingStateFarmBusinessPolicy":true,"hadInsuranceCancelledOrDeniedInThreeYears":true,"acknowledgesPrivacyDisclosure":true}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.statefarm.getBusinessQuote({ identity: {}, businessName: "<businessName>", businessDescription: "<businessDescription>", organizationType: "<organizationType>", yearBusinessStarted: "<yearBusinessStarted>", addressLine1: "<addressLine1>", city: "<city>", state: "<state>", postalCode: "<postalCode>", occupancy: "<occupancy>", annualReceipts: "<annualReceipts>", squareFeet: "<squareFeet>", yearBuilt: "<yearBuilt>", businessPersonalPropertyLimit: "<businessPersonalPropertyLimit>", numberOfEmployees: "<numberOfEmployees>", numberOfOfficersDirectors: "<numberOfOfficersDirectors>", hasPriorLossesInFiveYears: true, hasExistingStateFarmBusinessPolicy: true, hadInsuranceCancelledOrDeniedInThreeYears: true, acknowledgesPrivacyDisclosure: true });getLifeQuoteReturns State Farm's own term life rate table for a date of birth, sex, self-rated health band, tobacco recency, coverage amount and term.Arguments
Name Type Required dobstringDate of birth, "MM-DD-YYYY" (ISO "YYYY-MM-DD" is accepted too).Yes sex"Male" | "Female""Male" or "Female", the only two values the rate table carries.Yes health"best" | "better" | "good" | "okay"Self-rated health band: "best" | "better" | "good" | "okay".Yes coverageAmountnumberDeath benefit in whole dollars, e.g. 500000.Yes termYears10 | 20 | 30Term in years, 10, 20 or 30, the three State Farm publishes here.Yes heightFeetnumberHeight, feet part (4-7).Yes heightInchesnumberHeight, inches part (0-11).Yes weightPoundsnumberYes statestringYes tobaccoLastUsed{ month: number; year: number }When the applicant last used tobacco.No Returns
StatefarmLifeQuote[]/** One priced row of State Farm's term rate table. */ interface StatefarmLifeQuote { termYears: number; coverageAmount: number; /** Monthly premium for the base policy alone, in dollars. */ monthlyPremium: number; /** Annual premium for the base policy. NOT monthlyPremium * 12, paying * annually is cheaper and both numbers come from the engine. */ annualPremium: number; /** Monthly premium including every rider the engine attached. Null when it * returned no total, never silently equal to monthlyPremium. */ monthlyPremiumWithRiders: number | null; annualPremiumWithRiders: number | null; /** State Farm's internal rate class. Opaque, but it is the field that MOVES * when tobacco or health changes, so it cross-checks that a differing premium * came from the risk. */ rateClass: number | null; productType: string | null; productKindCode: string | null; productId: string | null; /** True on the row matching the coverage and term you asked for, the engine * always returns the whole table around the request. */ requested: boolean; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/statefarm/getLifeQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.statefarm.getLifeQuote({ dob: "01-15-1991", sex: "Male", health: "best", coverageAmount: 500000, termYears: 20, state: "IL", heightFeet: 5, heightInches: 10, weightPounds: 175 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.statefarm.getLifeQuote({ "dob": "01-15-1991", "sex": "Male", "health": "best", "coverageAmount": 500000, "termYears": 20, "state": "IL", "heightFeet": 5, "heightInches": 10, "weightPounds": 175 }))curl -X POST https://api.bowmark.ai/v1/sites/statefarm/getLifeQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"dob":"01-15-1991","sex":"Male","health":"best","coverageAmount":500000,"termYears":20,"state":"IL","heightFeet":5,"heightInches":10,"weightPounds":175}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.statefarm.getLifeQuote({ dob: "01-15-1991", sex: "Male", health: "best", coverageAmount: 500000, termYears: 20, state: "IL", heightFeet: 5, heightInches: 10, weightPounds: 175 });getRentersQuoteReturns State Farm's own monthly renters insurance estimate for a US ZIP.Arguments
Name Type Required queryStatefarmRentersQuoteQuery | stringYes /** What getRentersQuote takes. A bare ZIP string is accepted too. There is * deliberately no name, date of birth, address or coverage amount: State Farm * publishes this estimate off the ZIP alone, and supplying an identity would * turn a price lookup into a sales lead. */ interface StatefarmRentersQuoteQuery { /** Five-digit US ZIP. */ zip: string; }Returns
StatefarmRentersQuote/** State Farm's own published monthly renters estimate for one ZIP. A null means * State Farm published nothing for that field, never that parsing failed. */ interface StatefarmRentersQuote { zip: string; /** The city State Farm resolved the ZIP to, its spelling, not the caller's. */ city: string | null; state: string | null; /** Low and high ends of the monthly estimate, in whole US dollars. */ monthlyPremiumLow: number; monthlyPremiumHigh: number; /** The range exactly as State Farm publishes it, e.g. "9 - 16". */ monthlyPremiumRange: string; currency: "USD"; /** State Farm's own statement of what this number is and is not, returned * because a price without it invites being read as a binding offer. */ priceDisclaimer: string | null; /** The policy start window the flow offers for this ZIP, "MM-DD-YYYY". */ effectiveDateEarliest: string | null; effectiveDateLatest: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/statefarm/getRentersQuoteCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.statefarm.getRentersQuote({ zip: "33101" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.statefarm.getRentersQuote({"zip": "33101"}))curl -X POST https://api.bowmark.ai/v1/sites/statefarm/getRentersQuote \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":{"zip":"33101"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.statefarm.getRentersQuote({ zip: "33101" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/statefarm/<function> - OpenAPI
/v1/sites/statefarm/openapi.json