What it does
firmfind lets an MCP client search companies in official business registers through the CompanyData service. The company_search tool filters by name, location, industry code, company size, age, and whether a record includes an email address, phone number, website or named CEO. The company_enrich tool exports the complete record for one company by its CompanyData ID, and field_lookup suggests city names from a partial place name, which can be used before searching. Returned data is passed on exactly as the service sends it, without trimming, renaming or summarising.
It suits cases where you need businesses matching several register criteria and then want the full entry for a chosen company, or where a place name is uncertain and needs resolving first. The tools can also be run from a command-line interface, where each tool is a subcommand that takes one JSON argument string. Output is the tool's result text, and exit codes distinguish success, runtime errors and usage errors.
The COMPANYDATA_API_KEY environment variable must be set, and it is sent with every request. COMPANYDATA_API_BASE_URL can optionally override the default base URL. The package is released under the MIT licence.
Limitations and requirements
Requires a CompanyData API key in the COMPANYDATA_API_KEY environment variable; without it every tool fails and no request is made. Upstream non-2xx replies fail with 'companydata error: HTTP', and an unreachable API fails with 'companydata unreachable'.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.CloudCorpRecords/firmfind
Company search and enrichment across official business registers, via the CompanyData API.
v0.1.0As shown on registry.modelcontextprotocol.io when we last read it