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.

Functions
4
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just State Farm

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/statefarm
Every site

One 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/mcp
Set it up in your client

Both 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.

Read 4
  • findAgentReturns the State Farm agents near a ZIP or city.

    Arguments

    NameTypeRequired
    query.citystring
    City name ("Oklahoma City") or State Farm's own slug ("oklahoma-city").
    Yes
    query.statestring
    Two-letter state code, e.g. "IL".
    Yes
    query.zipstring
    Optional 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/findAgent

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.statefarm.findAgent({ city: "Chicago", state: "IL" });
  • getBusinessQuoteReturns a real State Farm Business Owners Policy price for one small business.

    Arguments

    NameTypeRequired
    identityQuoteIdentity
    The CALLER's own identity.
    Yes
    businessNamestringYes
    businessDescriptionstring
    One of the 82 trade classifications State Farm rates online, e.g. "AccountingServices".
    Yes
    organizationTypestring
    E.g. "Limited Liability Company".
    Yes
    yearBusinessStartedstring
    Four-digit year.
    Yes
    addressLine1stringYes
    addressLine2stringNo
    citystringYes
    statestring
    The full state NAME as the engine's own allowed values spell it ("Illinois", not "IL").
    Yes
    postalCodestring
    Five digits; the engine normalises to ZIP+4.
    Yes
    occupancystring
    "tenant", "owneroccupant" or "businresidence". owneroccupant is a soft kickout.
    Yes
    annualReceiptsstring
    Gross, whole dollars.
    Yes
    squareFeetstring
    Occupied floor area of the location.
    Yes
    yearBuiltstringYes
    businessPersonalPropertyLimitstring
    Whole dollars.
    Yes
    numberOfEmployeesstringYes
    numberOfOfficersDirectorsstringYes
    tenantImprovementsAmountstring
    Tenant improvements and betterments, whole dollars.
    No
    hasPriorLossesInFiveYearsboolean
    UNDERWRITING FACTS, with no defaults on purpose: State Farm treats two of them as a HARD kickout.
    Yes
    hasExistingStateFarmBusinessPolicybooleanYes
    hadInsuranceCancelledOrDeniedInThreeYearsbooleanYes
    acknowledgesPrivacyDisclosureboolean
    The caller's acknowledgement of State Farm's privacy disclosure, which its form requires before it will rate.
    Yes
    effectiveDatestring
    Policy 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/getBusinessQuote

    Call 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
    });
  • 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

    NameTypeRequired
    dobstring
    Date 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
    coverageAmountnumber
    Death benefit in whole dollars, e.g. 500000.
    Yes
    termYears10 | 20 | 30
    Term in years, 10, 20 or 30, the three State Farm publishes here.
    Yes
    heightFeetnumber
    Height, feet part (4-7).
    Yes
    heightInchesnumber
    Height, 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/getLifeQuote

    Call 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
    });
  • getRentersQuoteReturns State Farm's own monthly renters insurance estimate for a US ZIP.

    Arguments

    NameTypeRequired
    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/getRentersQuote

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.statefarm.getRentersQuote({ zip: "33101" });

Use it from code