CoverForce

Returns the full list of carriers CoverForce supports (carrierId, displayName, supported policyTypes, states). Use to translate carrier names mentioned by the user into Carrier enum identifiers expected by check_appetite / create_application.

get_carriers

Returns the WC job codes whitelisted for a given naicsExtendedId + state — the narrowest, recommended way to pick a job code for WC location.employeeInformation. Prefer this over get_job_codes_by_state when the business NAICS is known.

get_job_codes_by_industry

Returns all NCCI WC class codes (job codes) valid for the given US state. Each entry includes jobCodeExtendedId (used in location.employeeInformation), description, ncciStateClassCode. Use for WC quotes when get_job_codes_by_industry returns no narrow match.

get_job_codes_by_state

Returns the list of CoverForce legal entity types accepted by the platform (e.g. LIMITED_LIABILITY_COMPANY, CORPORATION, SOLE_PROPRIETORSHIP, GENERAL_PARTNERSHIP). Use to pick a value for companyStructure.legalEntityType before sending update_application. applicationId and policyType are accepted but currently ignored by the backend: the full CoverForce legal entity list is always returned.

get_legal_entities

Search CoverForce NAICS codes by keyword (e.g. "restaurant", "plumber", "software"). Returns naicsCode (6-digit), naicsExtendedId, description, industry. Use this FIRST in every quote flow — naicsExtendedId is required on update_application, and naicsCode is required for check_appetite. Always pass a keyword: without one the backend returns the entire NAICS catalog. applicationId is accepted but ignored by the backend.

get_naics_codes

Returns the list of valid CoverForce owner/officer titles for a given legal entity type and US state (e.g. PRESIDENT, MEMBER, PARTNER). Use this to pick a value for companyStructure.ownershipDetails.owners[].title before sending update_application. Title validity depends on both legalEntityType and state.

get_cf_owner_officer_titles

Returns the required / optional / hidden field configuration for an application based on its selected carriers and policy types. Use this RIGHT AFTER create_application to know which fields you must collect from the user before submit_for_quotes (e.g. some carriers require fein, dba, building info, prior loss history, etc).

get_application_fields_config

Fetch underwriting questions for an application from the V2 endpoint. category=GENERAL returns application-level questions (no entityId). category=LOCATION returns questions scoped to a specific locationId. category=ADDITIONAL_INTEREST, OWNER_OFFICER, VEHICLE, and DRIVER each return questions scoped to a specific entityId — the additional-interest, owner, vehicle, or driver id respectively (one entity per call). Each question carries questionType, answerOptions and, when the carrier configured one, defaultAnswer; the matching answer option is tagged isDefault: true and every question has hasDefaultAnswer. defaultAnswers summarises how many questions have a default so you can tell the user before asking. Present defaults pre-selected for confirmation; questions without one need an explicit answer. After collecting answers, submit them via update_application.underwritingDetails[]. Call once per category that the application requires.

get_uw_questions

Fetch the underwriting, bind, or payment statements an application must acknowledge. type=UNDERWRITING returns the statements that must be acknowledged BEFORE submit_for_quotes; send those acknowledgements back via update_application.statementDetails[]. type=BIND and type=PAYMENT return the statements for binding and payment, which are completed in the CoverForce agent portal.

get_uw_statements

Returns the CoverForce quoting workflow guide. Without policyType: the general rules (session context, profile selection, starting an application, sharing the application link, do's and don'ts) and the list of policy types that have a step-by-step flow. With policyType: the step-by-step quoting flow for that policy type, including the BOP base flow the other flows build on. Useful at the start of a quoting session and whenever the next step for a policy type is unclear.

get_workflow_guide

List the ACTIVE agent profiles (agency, agency network, role) available to the logged-in agent, marking the one currently bound to this MCP session. Call this when any tool returns MCP_PROFILE_SELECTION_REQUIRED, or when the user asks which agencies/roles they can act under. Present the options to the user and ask them to choose; then call switch_agent_profile with the chosen agentProfileId. Never pick a profile on the user's behalf.

list_agent_profiles

Report quoting progress for an application after submit_for_quotes. Returns ONLY: quotingInProgress (true while carriers are still responding), counts per quote status (QUOTED / DECLINED / FAILED / total), the applicationStatus, an allQuotesFailedOrDeclined flag, a portalUrl deep link to the application in the CoverForce agent portal, and a nextStep sentence. It intentionally does NOT return carrier names, quote IDs, premiums, limits, bridging links, or failure reasons — carrier contracts forbid quote data in this chat. Carrier identities and premiums are not available through this connector; the counts and portalUrl are the complete result, and the portal is where quotes are reviewed and bound. Quoting is asynchronous (5-60s per carrier): quotingInProgress stays true while carriers are still responding. FAILED (technical/submission error, can be re-quoted as-is from the portal) is different from DECLINED (the carrier will not offer terms without changes to the application).

list_quotes

Search the applications of the logged-in agent's agency (or of the whole agency network, for network-level profiles) by free text and filters, with paging. searchTerm is a case-insensitive substring match on business name, account name, agency name, application id, status, source, policy type, dates, and the creating or updating agent names. Filters: applicationStatus, policyType, applicationSource, applicationIds, agencyIds (network-level profiles only), isRenewal, and created / updated date bounds. Sorted by updatedAt descending unless sortBy and sortOrder say otherwise; 10 results per page unless pageSize says otherwise. Each result carries applicationId, businessName, policyType, applicationStatus, insuranceEffectiveDate, agencyName, applicationSource, isRenewal, applicationTags, the creating agent's name, and a portalUrl deep link, plus pagination. Results are summaries: the full record for an applicationId comes from get_application. Quote data is not included.

search_applications

Submit the application to the selected carriers for quoting. Valid only when the freshly fetched applicationStatus.status is IN_PROGRESS: the application may have been edited in the agent portal in parallel, so the current state comes from get_application, not from earlier conversation turns. Not valid while the status is QUOTING, QUOTED, REFERRED, BIND_IN_PROGRESS, BIND_PENDING, PAYMENT_IN_PROGRESS, or BOUND; re-submission becomes possible once an edit (in chat or in the portal) moves the application back to IN_PROGRESS. Pre-requisites on the application: business info, locations, owners, carrier industry codes, UW answers (underwritingDetails), UNDERWRITING statement acknowledgements (statementDetails), and a brokerConfiguration entry per carrier. Quoting is asynchronous: the API returns 200 with no body when accepted, and list_quotes reports progress (status counts plus an agent-portal link; no carrier names or premiums) until quotingInProgress is false.

submit_for_quotes

Switch the active agent profile for this MCP session. Use this when the logged-in agent operates under multiple profiles (different agencies or roles) and wants subsequent tool calls to act under a different one. Validates that the target agentProfileId belongs to the same logged-in agent and is ACTIVE before switching. After switching, every subsequent CF API call (create_application, get_broker_codes, audit trail, etc.) is made under the new profile. Also the way to resolve MCP_PROFILE_SELECTION_REQUIRED: after the user has chosen from the list_agent_profiles output, call this with their choice. Only call it after the user has explicitly picked — never choose for them. Returns the previous and new profile details.

switch_agent_profile

Update an existing application. THIS IS A FULL PUT: the request replaces the whole record, so it has to carry every section that should remain (applicationStatus, applicationDetails, basicBusinessDetails, companyStructure, policyDetails, underwritingDetails, statementDetails) exactly as the current get_application response returns them, with the edits applied. A section omitted from the payload is deleted on the backend. Use this single tool to update business info (basicBusinessDetails), legal entity / owners (companyStructure.legalEntityType, companyStructure.ownershipDetails.owners[]), policy effective/expiry dates (applicationDetails.insuranceEffectiveDate / insuranceExpiryDate), underwriting question answers (underwritingDetails[]), statement acknowledgements (statementDetails[]), prior loss history (pastPolicyLossDetails[]), and per-carrier broker code assignment (brokerConfiguration[] — { carrierId, brokerConfigurationId } per carrier; REQUIRED before submit_for_quotes, see Step 9a). For location-level changes (add/update/delete) use the dedicated location tools instead — they handle PATCH semantics on locationDetails so you do not have to round-trip the entire array. PAYLOAD SIZE: a PUT carrying UW answers for several carriers at once (more than about 30 underwritingDetails entries, typical for multi-carrier BOP/WC) routinely exceeds the per-turn output-token cap and truncates mid-JSON. One PUT per carrier stays under it: each is based on a fresh get_application, keeps its existing underwritingDetails and adds that carrier's slice, and carries applicationStatus, applicationDetails, basicBusinessDetails, companyStructure, policyDetails and statementDetails unchanged (full PUT rule above).

update_application

Set the per-carrier industry / class code overrides on basicBusinessDetails.carrierIndustryCodes WITHOUT having to re-send the rest of the application. The MCP service fetches the existing application, replaces the carrierIndustryCodes array, and PUTs the application back. Each carrierIndustryCodes entry mirrors ICarrierIndustryCode and MUST include: { carrierId, policyType, industryCode, industryCodeDescription, additionalIndustryCodes }. Field name mapping from get_carrier_industry_codes output: classCodeId -> industryCode, classCodeDescription -> industryCodeDescription. Pass additionalIndustryCodes: [] (the field is required even if empty). The legacy keys classCodeId / classCodeDescription / state are rejected.

update_carrier_industry_codes

Update an existing location on an application. This is a FULL PUT of that location: the payload is the complete ILocationInfo for the location (including its locationId) as returned in get_application locationDetails[], with the edits applied; fields left out are removed.

update_location