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. 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. The tool reads the stored application and writes it back with the sections you send: each section you send replaces the stored section in full, and every section you leave out is kept as stored. Send applicationId plus only the sections you are changing, each complete: its current content with your edits applied, and for a list section every existing entry you want to keep. 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). locationDetails is not part of this update. PAYLOAD SIZE: underwriting answers for several carriers at once (more than about 30 underwritingDetails entries, typical for multi-carrier BOP/WC) can exceed the per-turn output-token cap and truncate mid-JSON. Send one update per carrier instead, each carrying only underwritingDetails: the stored entries plus that carrier's answers.

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