What is MCP?
The Model Context Protocol (MCP) is an open standard that lets AI agents connect to external data sources and tools. CompanyLens provides an MCP server that gives your AI agent direct access to company registry data across all jurisdictions.
Claude Desktop
Add the following to your Claude Desktop MCP configuration:
{
"mcpServers": {
"companylens": {
"url": "https://mcp.companylens.io/mcp"
}
}
}Claude.ai
In Claude.ai, go to Settings → Integrations, click Add Integration, and enter:
https://mcp.companylens.io/mcpGive it a name (e.g. “CompanyLens”) and click Add. CompanyLens will ask you to sign in the first time you use a tool. Requires a Pro, Max, Team, or Enterprise plan — not available on the free tier.
Claude Code
Run this command to add CompanyLens as an MCP server in Claude Code:
claude mcp add --transport http companylens https://mcp.companylens.io/mcpOr add it manually to your ~/.claude.json:
{
"mcpServers": {
"companylens": {
"type": "http",
"url": "https://mcp.companylens.io/mcp"
}
}
}After adding, restart Claude Code. The CompanyLens tools will be available in your next session.
Cursor
In Cursor, go to Settings → Tools & MCP and add:
{
"mcpServers": {
"companylens": {
"url": "https://mcp.companylens.io/mcp"
}
}
}Windsurf
In Windsurf, open Settings → Cascade → MCP Servers and add a new server entry:
{
"mcpServers": {
"companylens": {
"serverUrl": "https://mcp.companylens.io/mcp"
}
}
}Windsurf uses serverUrl rather than url in its MCP config.
ChatGPT
In ChatGPT, go to Settings → Connectors, click + Add connector, and select Model Context Protocol (MCP). Enter:
https://mcp.companylens.io/mcpGive it a label (e.g. “CompanyLens”), click Save, and authenticate when prompted. Requires a Pro, Plus, Team, or Enterprise plan.
GitHub Copilot
In VS Code 1.101+, open the Command Palette (Ctrl+Shift+P / Cmd+Shift+P), run MCP: Add Server, select HTTP as the type, and paste:
https://mcp.companylens.io/mcpOr add it manually to your VS Code mcp.json:
{
"servers": {
"companylens": {
"type": "http",
"url": "https://mcp.companylens.io/mcp"
}
}
}Requires a GitHub Copilot subscription (any paid tier). MCP is available in the IDE only — not on github.com.
Authentication
CompanyLens uses OAuth 2.0 for MCP authentication. When your AI agent first connects, it will open a browser window for you to log in. After authentication, the session persists until the token expires.
If your MCP client supports Dynamic Client Registration (DCR), it will automatically register itself. Otherwise, the standard OAuth authorization code flow is used.
Available tools
Once connected, your AI agent has access to these tools:
| Tool | Description |
|---|---|
| search_companies | Search entities by name, jurisdiction, and status. Supports searchMode: 'fuzzy' (default), 'prefix' (recommended for DD), or 'exact' |
| get_company | Core entity profile and supported sections — use before calling section tools |
| get_company_section | One section per call: officers, beneficial owners, or financial statements |
| get_company_batch | Fetch core profiles for up to 20 companies in a single call |
| search_people | Cross-jurisdiction officer and beneficial owner search |
| get_person | Person identity record and known name variants |
| get_person_section | One section per call: company links, officer roles, or disqualifications |
| get_company_network | Corporate network graph — entities linked via shared officers and owners |
| get_person_network | All companies a person appears in, with depth-2 traversal |
| get_charges | Registered charges (mortgages/security) for an entity |
| get_filings | Paginated filing history — confirmation statements, annual accounts, share allotments (UK) |
| find_by_address | Find entities registered at a given address |
| search_disqualified_directors | Fuzzy name search over disqualified directors — for KYB name checks |
| browse_disqualified_directors | Browse all disqualified directors ordered by most recent — for compliance monitoring |
| list_jurisdictions | List all supported jurisdictions with metadata |
| get_usage | Returns your current plan, rate limits, and usage for the active billing period |
Need help setting up? Back to Docs overview or check the example queries.