# mcp-opencorporates

MCP server for [OpenCorporates](https://opencorporates.com) — the world's largest open database of companies. Search companies, officers, and filing history across 140+ jurisdictions worldwide.

## Install

```bash
npx -y @gonzih/mcp-opencorporates
```

## Claude Desktop config

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```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](https://opencorporates.com/api_accounts/new).

## 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](https://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](https://opencorporates.com/api_accounts/new)
2. Set `OPENCORPORATES_API_KEY` env var in your Claude Desktop config

## API reference

Full API documentation: [api.opencorporates.com/documentation/API-Reference](https://api.opencorporates.com/documentation/API-Reference)

## License

MIT