mcp-opencorporates
MCP server for OpenCorporates — the world's largest open database of companies. Search companies, officers, and filing history across 140+ jurisdictions worldwide.
Install
npx -y @gonzih/mcp-opencorporates
Claude Desktop config
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"opencorporates": {
"command": "npx",
"args": ["-y", "@gonzih/mcp-opencorporates"],
"env": {
"OPENCORPORATES_API_KEY": "your_api_key_here"
}
}
}
}
The OPENCORPORATES_API_KEY is optional — without it, the free tier is used (rate-limited). Get an API key at opencorporates.com.
Tools
search_companies
Search companies by name across all jurisdictions or within a specific one.
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | yes | Company name or search query |
jurisdiction_code | string | no | Filter by jurisdiction (e.g. us_de, gb, de) |
page | number | no | Page number for pagination |
get_company
Get full details for a company by jurisdiction code and registration number.
| Parameter | Type | Required | Description |
|---|---|---|---|
jurisdiction_code | string | yes | Jurisdiction code (e.g. us_de, gb) |
company_number | string | yes | Company registration number |
search_officers
Search for officers (directors, shareholders, agents) across all companies.
| Parameter | Type | Required | Description |
|---|---|---|---|
q | string | yes | Officer name or search query |
jurisdiction_code | string | no | Filter by jurisdiction |
page | number | no | Page number for pagination |
get_company_officers
Get all officers for a specific company.
| Parameter | Type | Required | Description |
|---|---|---|---|
jurisdiction_code | string | yes | Jurisdiction code |
company_number | string | yes | Company registration number |
page | number | no | Page number for pagination |
get_company_filings
Get the filing history for a company.
| Parameter | Type | Required | Description |
|---|---|---|---|
jurisdiction_code | string | yes | Jurisdiction code |
company_number | string | yes | Company registration number |
page | number | no | Page number for pagination |
Jurisdiction codes
Common codes:
| Code | Jurisdiction |
|---|---|
us_de | Delaware, USA |
us_ca | California, USA |
us_ny | New York, USA |
gb | United Kingdom |
de | Germany |
fr | France |
au | Australia |
ca_on | Ontario, Canada |
Full list: opencorporates.com/jurisdictions
API key setup
The free tier works without an API key but is rate-limited. For higher limits:
- Sign up at opencorporates.com
- Set
OPENCORPORATES_API_KEYenv var in your Claude Desktop config
API reference
Full API documentation: api.opencorporates.com/documentation/API-Reference
License
MIT