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:

1. Sign up at opencorporates.com
2. Set OPENCORPORATES_API_KEY env var in your Claude Desktop config

API reference

Full API documentation: api.opencorporates.com/documentation/API-Reference

License

MIT