# Firmable for underwriters

> Your rating engine prices the risk and your exposure tools model it. Firmable gives your underwriting agent the business behind each broker submission: its occupation, its locations, its size and the software it runs.

- Web page: https://developer.firmable.ai/solutions/underwriting
- Get a free API key: https://platform.firmable.com/sign-up
- Full API reference: https://docs.firmable.com/api-reference/overview

Works alongside: Rating engine, Broker submission inbox, Property and cyber exposure tools, Underwriting agent.

Firmable doesn't hold loss history or scan networks. It adds business context to the tools you already use.

## From broker submission to bound policy.

Commercial and SME underwriting steps, at an insurer, MGA or broker, where outside-in business data saves a referral back to the broker.

### Prefill from the submission

Your underwriting agent asks: "Fill in this insured's details from the broker's submission."

Look the insured up by website or domain, then prefill its NAICS and SIC codes, headcount, revenue band, years trading and locations.

Calls: [`GET /company`](https://docs.firmable.com/api-reference/overview)

For underwriters: Faster quotes, fewer questions back to the broker.

### Check the occupation

Your underwriting agent asks: "Is this business really in the occupation it was rated under?"

Check the declared activity, and compare the industry codes on the company record.

Calls: [`offers_service`](https://docs.firmable.com/api-reference/overview), [`GET /company`](https://docs.firmable.com/api-reference/overview)

For underwriters: Less premium leakage from misclassified risks.

### Check the schedule of locations

Your underwriting agent asks: "Does the schedule match where this insured operates?"

Compare the declared sites with the locations Firmable holds, and check for more than one site.

Calls: [`GET /company`](https://docs.firmable.com/api-reference/overview), [`has_multiple_sites`](https://docs.firmable.com/api-reference/overview), [`is_located_in`](https://docs.firmable.com/api-reference/overview)

For underwriters: Unscheduled locations caught before binding.

### Prefill the cyber proposal form

Your underwriting agent asks: "What software does this insured run?"

Answer and check the cyber questions with the technologies the insured uses, such as its email, cloud and payment tools.

Calls: [`get_tech_intel`](https://docs.firmable.com/api-reference/overview)

For underwriters: Fewer blanks on the proposal form.

### Ask about AI use

Your underwriting agent asks: "Which kinds of AI tools does this insured use?"

Read the footprint area of AI adoption: the categories of AI tools in use and the main tool in each. Add withEvidence for every tool.

Calls: [`get_ai_adoption`](https://docs.firmable.com/api-reference/overview)

For underwriters: A view of AI use for new questions and exclusions.

### Re-underwrite at renewal

Your underwriting agent asks: "What has changed since we bound this policy?"

Look the insured up again at renewal and compare headcount, revenue band and sites with the policy.

Calls: [`GET /company`](https://docs.firmable.com/api-reference/overview)

For underwriters: Renewals priced on today's business.

## Example: Check an insured's occupation

A make_decision call on the Firmable MCP server, with a placeholder domain.

```
{
  "name": "make_decision",
  "arguments": {
    "tool": "offers_service",
    "question": { "service": "commercial cleaning" },
    "domain": "insured.example",
    "withReasoning": true
  }
}
```

## Where it fits in underwriting.

- **In the submission inbox.** Call the REST API as each submission arrives, with one developer key.
- **In the rating engine.** Feed industry codes, headcount and revenue band in as rating inputs.
- **At renewal.** Repeat lookups of a profile you've paid for are free.
- **Next to exposure tools.** Keep loss history and network scans where they are. Firmable adds the business context.
