Documentation and manifest for the CompanyLens MCP server — company registry intelligence across 19 jurisdictions for AI agents.
CompanyLens MCP Server
Company registry intelligence for AI agents — covering 19 jurisdictions across Europe, the Americas, and Asia-Pacific.
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:
{
"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
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 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 and embed it in your MCP client config as a Bearer header:
{
"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
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.
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.
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 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
- Privacy enquiries: privacy@companylens.io
- Data processing terms: available on request for Business plan customers
Support
- Documentation: companylens.io/docs
- MCP setup guide: 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, glama.ai, and 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.