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