Products / Firmable MCP
Give your agent Firmable over MCP.
One URL over Streamable HTTP. Sign in with OAuth on your own machine, or send your developer key from a server or CI. Your agent gets search, company and people data, Decisions, Tech Intelligence and AI adoption.
Before you start
Two ways to connect.
Sign in with OAuth
For Claude, ChatGPT and most editors on your own machine. The client ID is on the developer portal's Home page with OAuth selected. Sign-in comes back to port 53612, so use it exactly as shown.
Use your developer key
On the developer plan, the same fbl_dev_ key that calls the REST API also works for the MCP server. No app account needed. Send it as a header: Authorization: Bearer fbl_dev_xxx.
Get your free API key →Setup
Pick your tool.
Claude (web and desktop)
Add Firmable as a custom connector. Added on the web, it shows up in Claude Desktop too.
- In Claude, open Settings, then Connectors.
- Select Add custom connector, name it Firmable and paste the MCP URL below.
- Under Advanced settings, enter the OAuth client ID below and leave the client secret blank.
- Select Add, then Connect, and sign in to Firmable.
MCP URL: https://agents.firmable.com/developer/mcp OAuth client ID: rkI2RHxS55F7qKp8
Using a developer key instead? Choose no sign-in and add a request header named Authorization with the value Bearer <YOUR_FIRMABLE_API_KEY>.
Tools
The tools your assistant can call.
Your assistant picks the right tool from your question. You choose which tools it may use without asking.
| Tool | What it does | Credits |
|---|---|---|
| filter_search | Find companies or people by industry, location, size, seniority, department and more. | Free |
| ai_search | Find companies or people from a plain-English description. | Free |
| get_company | A full company profile from a domain, LinkedIn URL or Firmable ID. | 1 credit a new profile |
| get_person | Resolve a person from an email, LinkedIn URL or Firmable ID. | 1 credit a new profile |
| make_decision | Yes, no or unknown about a company or person, with the facts behind it. | 1 credit per 25 yes or no answers, 2 with reasoning. Unknown answers are free |
| list_decision_tools | The decision tools that are switched on, with the inputs each one needs. | Free |
| get_tech_intel | The technologies a company runs, with confidence and recency. | Up to 5 credits a company, once |
| bulk_get_tech_intel | Technologies for up to 200 companies, 20 each. | Up to 5 credits a company, once |
| get_ai_adoption | A company's AI adoption level, momentum and five areas. | 1 credit per 5 companies found, 3 per company with evidence. Not found is free |
One connection
Everything on one connection.
Company data
Full profiles from a domain, website, LinkedIn URL or Firmable ID, across 13 markets.
People data
Roles, seniority and departments, with work emails and phone numbers, paid for once per person.
Search
Find companies and people by filters or a plain-English description. Free.
Decisions
34 yes, no or unknown checks about companies and people, with confidence and the date of the data.
Tech Intelligence and AI adoption
What a company runs, and how far it has got with AI across five areas.
Skills
GTM skills your AI tool runs with one prompt.
Account Brief
A structured overview of an account: description, size, tech footprint, registers and ICP fit, in one call.
SkillBuying Committee Mapper
Maps the likely decision maker, economic buyer, champion, technical evaluator and blockers, grounded in real Firmable contacts.
SkillCRM Push Prep
Previews what will be created or updated, how duplicates are handled and the cost, then asks you to confirm before anything is written.