# AI adoption

> See how far a company has got with AI: an overall level, which way it's heading, and five areas you can check.

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

## What you can do

- Find accounts ready to buy AI
- Open meetings with each account's AI gaps
- Compare a whole portfolio on one scale

Key facts: Close to 21M companies, 5 cents per company found.

## How it works

1. **Send companies.** A domain or Firmable ID, or up to 100 companies.
2. **Get levels.** An overall level, momentum and five areas.
3. **Add evidence.** Turn on withEvidence only when you need the rows.

Fields in every response:

- `overall_level`: One of NONE, BASIC, MEANINGFUL, MODERATE, STRONG or ADVANCED.
- `momentum`: A label and the recent signals behind it.
- `dimensions`: Five areas, each with a level and a headline.
- `observability`: How much Firmable can see of each area.
- `evidence_available`: How many evidence items each area holds.
- `as_of, framework_version`: Data date and scoring version.

## How the score is built

- **From things we can count.** AI roles advertised, people in AI roles, news and posts about the company's AI work, AI tools it uses and the AI technology it builds with.
- **The same five areas for every company.** Every company is scored on the same five areas, in the same level words.
- **Thin evidence is flagged.** Each area has an observability rating. Low means there was little to see, which isn't the same as no AI.
- **Versioned.** Each result carries framework_version and as_of, so you know which scoring rules and data date produced it.

## What the levels and areas mean

The level words the API returns. New levels can be added, so don't fail on one you don't recognize.

### Overall level

- `NONE · BASIC · MEANINGFUL · MODERATE · STRONG · ADVANCED`: The level words the API can return.

### The five areas

- `architecture`: AI and data technology it builds with, such as model serving and data pipelines
- `footprint`: AI tools it uses, such as AI assistants and coding assistants
- `hiring`: AI roles it has advertised
- `initiatives`: News and posts about its AI work
- `workforce`: People in AI roles, and how senior they are

### Area level

- `level`: Each area has its own level, in the same words.

## What teams build with it

### Sales teams at AI vendors: find accounts ready to buy AI

1. Score your target accounts.
2. Keep the ones with momentum.
3. Pitch the area where each one is weakest.

Tools: `get_ai_adoption`.

### Consulting teams: prepare for client meetings

1. Pull the client's five areas with evidence.
2. Note their strengths and gaps.
3. Open the meeting with what you found.

Tools: `get_ai_adoption`.

### Investment teams: track a portfolio's progress with AI

1. Score every portfolio company on one scale.
2. Re-check each quarter.
3. Compare each company's momentum label between checks.

Tools: `get_ai_adoption`.

### Revenue teams: prioritize the pipeline

1. Score your open accounts.
2. Rank them by momentum.
3. Have reps call the ones speeding up first.

Tools: `get_ai_adoption`.

### Marketing teams: segment campaigns by AI maturity

1. Score the campaign list.
2. Split AI leaders from companies just starting.
3. Send each group its own message.

Tools: `get_ai_adoption`.

### Talent and recruiting teams: find companies building AI teams

1. Score your target companies.
2. Check the hiring and workforce areas.
3. Reach out where AI hiring is active.

Tools: `get_ai_adoption`.

## Use it in your agent

Paste this into your agent to connect Firmable, make a test call and save a rule for when to use it:

```text
Set up Firmable AI adoption for me.

1. Connect the Firmable MCP server by following
   https://agents.firmable.com/developer/setup.txt
   Keep any MCP servers that are already configured.
2. If you need an API key instead of signing in, ask me for it. Keep it in an
   environment variable called FIRMABLE_API_KEY or our secret store, never in
   a file that gets committed.
3. Check it works: call get_ai_adoption with domain stripe.com, then show me
   the overall level, the momentum and the five areas.
4. Add this rule to your project memory (CLAUDE.md, AGENTS.md or .cursor/rules)
   and tell me where you saved it:
   "When I ask how far a company has got with AI, call Firmable
    get_ai_adoption instead of reading press coverage. Give the overall
    level, the momentum and the weakest area."

What AI adoption can do: https://developer.firmable.ai/products/ai-adoption.md
```

### Ask your agent

```text
Use Firmable to rank these 50 accounts by AI adoption.
For each, show the overall level, momentum and the weakest area.
```

Works in any client with the Firmable MCP server.

### One company

```json
{
  "name": "get_ai_adoption",
  "arguments": { "domain": "hubspot.com" }
}
```

Send company_id or domain.

### Many, with evidence

```json
{
  "name": "get_ai_adoption",
  "arguments": {
    "records": [
      { "domain": "hubspot.com", "external_id": "acct-001" },
      { "company_id": "f000000740279", "external_id": "acct-002" }
    ],
    "withEvidence": true
  }
}
```

Up to 100 companies. Evidence costs more.

## Pricing

| What | Credits | US$ |
| --- | --- | --- |
| A company with data | 1 credit per 5 companies | $0.05 |
| With evidence, per company | 3 credits | $0.75 |
| A company with no AI adoption data | Free | $0 |

Based on $0.25 a credit. Part-credits carry over across your organization's calls.

## Questions

### What is AI adoption?

An API and MCP tool that shows how far a company has got with AI: an overall level, which way it is heading, and five areas you can check.

### Does a low level mean no AI?

No. Check each area's observability: it says how much Firmable can see of that area for the company.

### Are the workforce numbers a headcount?

No. They count the people Firmable finds in AI roles, not the company's total headcount.

### When should I turn on evidence?

When you need the items behind a level. evidence_available tells you how many there are first.

### Which companies can I look up?

Any company Firmable covers, close to 21 million. If Firmable has no AI adoption data for one, that answer is free.

### Where can I use it?

Through the REST API (POST /ai-adoption) or the get_ai_adoption tool on the Firmable MCP server, with a developer API key or by signing in. It works with Claude, ChatGPT, Cursor and other MCP clients.
