> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firmable.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Adoption tool

> See how far a company has adopted AI from your AI agent

The `get_ai_adoption` MCP tool lets your agent see how far a company has adopted AI, such as
*"How far has pgim.com adopted AI?"* or *"Which of these companies have AI leadership?"*. It returns
the same data as the [AI Adoption API](https://docs.firmable.com/api-reference/ai-adoption.md).

The tool is on the Firmable MCP server and the [developer MCP server](https://docs.firmable.com/developer/mcp.md), from version
0.14.0. You don't need to set anything up: ask your agent about a company's AI adoption and it uses
it.

## get\_ai\_adoption

Returns a company's overall AI adoption level, a one-line explanation, momentum, and the five areas
(`architecture`, `footprint`, `hiring`, `initiatives`, `workforce`) with their levels and headlines.

```json theme={null}
{ "domain": "pgim.com" }
```

For many companies at once:

```json theme={null}
{ "records": [{ "domain": "pgim.com", "external_id": "row-1" }, { "company_id": "f000002437529" }] }
```

### Inputs

| Input | What it is |
| - | - |
| `company_id` or `domain` | The company. Give one, not both. |
| `external_id` | Optional. Your own ID, returned with the answer. |
| `records` | Up to 100 companies, each with `company_id` or `domain` and an optional `external_id`. Send it instead of `company_id` or `domain`, not with them. |
| `withEvidence` | `true` to also get the evidence behind each area. Costs 3 credits per company with evidence. |

### Replies

| Reply | What it means |
| - | - |
| `success: true` | The answer, as the [AI Adoption API](https://docs.firmable.com/api-reference/ai-adoption.md#get-one-company) returns it: `input`, `company`, `evidence` (with `withEvidence`) and `usage`. A batch has `results` and `usage.billable_rows`. |
| `success: true`, `company: null` | Firmable has no AI adoption data for that company. `error.code` is `not_found`, and it's free. |
| `success: false` with a `message` | Something needs fixing, such as both `company_id` and `domain`, or not enough credits. `message` says what. |

## Credits

`get_ai_adoption` costs the same as the [AI Adoption API](https://docs.firmable.com/api-reference/ai-adoption.md#pricing):

* **1 credit per 5 companies found**, or **3 credits per company** with `withEvidence` when evidence
  comes back.
* Companies not found and failed calls are free.
* A batch is charged per row, and part-credits carry over between calls.

On the Firmable MCP server, answers use your subscription credits, then add-on credits. On the
developer MCP server, they use [developer credits](https://docs.firmable.com/developer/credits.md).

## Try it

Ask your agent:

* *"Use Firmable to check how far pgim.com has adopted AI."*
* *"For each of these domains, give me the AI adoption level and the strongest area."*
* *"Show me the evidence behind PGIM's AI workforce score."*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.