# CompanyLens MCP Server

> Company registry intelligence for AI agents — covering 19 jurisdictions across Europe, the Americas, and Asia-Pacific.

[![MCP](https://img.shields.io/badge/MCP-compatible-blue)](https://modelcontextprotocol.io)
[![Auth](https://img.shields.io/badge/auth-OAuth%202.0-green)](https://mcp.companylens.io/.well-known/oauth-authorization-server)
[![Transport](https://img.shields.io/badge/transport-Streamable%20HTTP-orange)](https://modelcontextprotocol.io/docs/concepts/transports)
[![License](https://img.shields.io/badge/docs-MIT-lightgrey)](LICENSE)

**Server URL:** `https://mcp.companylens.io/mcp`

Give your AI agent instant access to official company registry data from 19 juristictions — search companies, look up officers and beneficial owners, map corporate networks, screen against the UK disqualified directors register, find every company at a registered address, and trace beneficial ownership, all from one MCP endpoint.

This is a **remote MCP server** — there is nothing to install locally. Add the URL to your MCP client, create a free acount, and start querying.

---

## Why CompanyLens?

**One endpoint, 19 registries.** Most company-data tools cover a single jurisdiction. CompanyLens unifies 19 official government registries across Europe, the Americas, and Asia-Pacific behind one MCP endpoint.

**Built for KYB and due diligence.** Beyond company lookup, the server exposes what compliance and investigation workflows actually need: persons with significant control, corporate networks via shared officers, the UK disqualified directors register, registered addresses with every co-located company, and full filing history.

**Official data, low-latency reads.** Records are ingested from each official government registry — Companies House, CRO, KBO/BCE, Handelsregisteramt, and equivalents — and indexed in CompanyLens's own database. Queries return in milliseconds, with no dependency on upstream registry availability or rate limits at request time.

**Safe to wire into any client.** All 18 tools are read-only and idempotent. Add the server to Claude, Cursor, your custom agent, or a CI pipeline without worrying about side effects.

**Free to try.** No credit card, no API key in config. The free tier gives you 100 calls / month — enough to evaluate the server end-to-end. Paid plans for unattended agents and high-volume workflows.

---

## Quick start

Add the server to your MCP client config:

```json
{
  "mcpServers": {
    "companylens": {
      "url": "https://mcp.companylens.io/mcp"
    }
  }
}
```

On the first tool call your client will open a browser window for OAuth sign-in. After that, the token is managed automatically.

### Setup by client

| Client | How to add |
|--------|------------|
| **Claude.ai (web)** | Settings → Connectors → Add custom connector → paste server URL |
| **Claude Desktop** | Settings → Developer → Edit Config → add the JSON snippet above |
| **Cursor** | Settings → MCP → Add new MCP server → URL transport |
| **Windsurf** | Settings → MCP Servers → Add custom server → paste URL |
| **Any MCP client** | Use the URL `https://mcp.companylens.io/mcp` with Streamable HTTP transport |

Full setup walkthrough: **[companylens.io/docs/mcp-setup](https://companylens.io/docs/mcp-setup)**

---

## Authentication

OAuth 2.0 with PKCE. Standard MCP-compliant discovery flow — your client handles everything.

- **Discovery endpoint:** `https://mcp.companylens.io/.well-known/oauth-authorization-server`
- **No API keys** in your config — tokens are issued and refreshed by the MCP client
- **Free account** at [companylens.io](https://companylens.io) is enough to start

---

## Service tokens (agentic workflows)

For unattended agents, CI/CD pipelines, and autonomous workflows where no human can complete an OAuth browser flow, use a **service token** instead.

Generate a token from the [CompanyLens dashboard](https://companylens.io/dashboard/service-tokens) and embed it in your MCP client config as a `Bearer` header:

```json
{
  "mcpServers": {
    "companylens": {
      "url": "https://mcp.companylens.io/mcp",
      "headers": {
        "Authorization": "Bearer st_live_your_token_here"
      }
    }
  }
}
```

Service tokens are available on the **Agent Starter** and **Agent Pro** plans. Service-token calls and OAuth-session calls use independent monthly quotas, so automated pipelines do not consume your interactive allowance.

Full guide: **[companylens.io/docs/agentic-ai-tools](https://companylens.io/docs/agentic-ai-tools)**

---

## Available tools

All 18 tools are **read-only** and **idempotent**. No tool writes, mutates, or sends external requests beyond the CompanyLens database.

### Company lookup
| Tool | Description |
|------|-------------|
| `search_companies` | Search by name or number across all jurisdictions with typo tolerance and prefix matching |
| `get_company` | Core company profile — status, address, officer count, and which data sections are available |
| `get_company_section` | Fetch a single section of a company profile: officers or beneficial owners |
| `get_company_batch` | Fetch core profiles for up to 20 companies in a single call |
| `browse_companies` | Browse companies in a jurisdiction by industry codes, officer count, date range, status, and entity type |
| `get_filings` | Paginated filing history for a company — annual accounts, PSC changes, officer changes, and more |
| `get_charges` | Registered charges and mortgages against a company (UK) |

### People & networks
| Tool | Description |
|------|-------------|
| `search_people` | Find officers, beneficial owners, and disqualified directors by name across all jurisdictions |
| `get_person` | Person identity record — display name and any known name variants |
| `get_person_section` | Fetch a section of a person profile: company links, officer roles, or disqualification records |
| `get_company_network` | Map the corporate network around a company via shared officers and owners |
| `get_person_network` | Map all companies a person appears in, with depth-2 traversal |

### Compliance & screening
| Tool | Description |
|------|-------------|
| `search_disqualified_directors` | Fuzzy name search over the UK disqualified directors register for KYB checks |
| `browse_disqualified_directors` | Browse the disqualified directors register by most recent — for bulk compliance review |
| `find_by_address` | Discover all companies registered at an address |

### Reference & metadata
| Tool | Description |
|------|-------------|
| `list_jurisdictions` | List all supported jurisdictions with metadata |
| `list_industry_codes` | List SIC/NACE codes for a jurisdiction |
| `get_usage` | Returns your current plan, rate limits, and usage for the active billing period |

---

## Coverage

**19 jurisdictions** across three regions:

| Region | Jurisdictions |
|--------|---------------|
| **Europe** | Belgium (BE), Cyprus (CY), Czech Republic (CZ), Estonia (EE), Ireland (IE), Latvia (LV), Moldova (MD), Norway (NO), Slovakia (SK), Slovenia (SI), Switzerland (CH), Ukraine (UA), United Kingdom (GB) |
| **Americas** | Argentina (AR), Canada (CA), Canada — Québec (CA-QC), Chile (CL) |
| **Asia-Pacific** | Kazakhstan (KZ), New Zealand (NZ) |

Refresh cadence and available data sections vary by jurisdiction — call `list_jurisdictions` for the live list and capabilities, or see [companylens.io/coverage](https://companylens.io/coverage).

---

## Example prompts

**Search for a company and get its directors**
> "Find all UK companies named Revolut and show me their directors"

**Cross-jurisdiction due diligence**
> "Search for any companies where John Smith is a director across all jurisdictions"

**Compliance screening**
> "Check if Jane Doe appears on the disqualified directors register"

**Corporate network mapping**
> "Map the corporate network around Deliveroo Limited — show all entities connected through shared directors and owners"

**Address clustering**
> "How many companies are registered at 1 Canada Square, London — and who are they?"

**Beneficial ownership**
> "Who are the persons with significant control for Monzo Bank Limited?"

**Sector research**
> "Which banks have been incorporated in the UK since 2020?"

---

## Pricing

| Plan | Queries | Price |
|------|---------|-------|
| **Free** | 50 / month | £0 |
| **Pro** | 200 / day | £20 / month |

Free tier is enough to evaluate the server and run light personal use. Full pricing: [companylens.io/pricing](https://companylens.io/pricing).

Responses include `X-RateLimit-Remaining` and `X-RateLimit-Reset` headers, and the `get_usage` tool returns your current consumption.

---

## Data sources

All data is sourced directly from official government company registries — Companies House (UK), CRO (IE), KBO/BCE (BE), Handelsregisteramt (CH), and equivalent national registries in each covered jurisdiction.

Records are updated regularly from each jurisdiction's registry feed. Refresh cadence varies per jurisdiction — see [companylens.io/coverage](https://companylens.io/coverage) for current per-jurisdiction lag and update frequency. CompanyLens does not create or modify registry data — it is presented as-is from the source authority.

---

## Privacy

CompanyLens processes your account data (name, email) and API usage metadata to deliver the service and enforce rate limits. **No conversation data is collected** — the MCP server only sees tool-call arguments, not the surrounding prompt.

Company registry data returned by the tools is sourced from public government records and is not personal data belonging to you.

- **Privacy policy:** [companylens.io/privacy](https://companylens.io/privacy)
- **Privacy enquiries:** privacy@companylens.io
- **Data processing terms:** available on request for Business plan customers

---

## Support

- **Documentation:** [companylens.io/docs](https://companylens.io/docs)
- **MCP setup guide:** [companylens.io/docs/mcp-setup](https://companylens.io/docs/mcp-setup)
- **Issues & feedback:** support@companylens.io

---

## About this repository

This repository hosts the public documentation and manifest for the CompanyLens MCP server. The server itself is hosted at `https://mcp.companylens.io/mcp` and is operated by CompanyLens.io.

The MCP server source code is closed-source. This repository exists so that MCP directories (such as [awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers), [glama.ai](https://glama.ai/mcp/servers), and [mcp.so](https://mcp.so)) and AI clients can link to a canonical, public location for documentation, manifest, and changelog.

Documentation in this repository is licensed under [MIT](LICENSE).