Skip to main content
Docs

Documentation

Everything you need to integrate CompanyLens into your application or AI agent.

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/mcp

Give 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/mcp

Or 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/mcp

Give 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/mcp

Or 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:

ToolDescription
search_companiesSearch entities by name, jurisdiction, and status. Supports searchMode: 'fuzzy' (default), 'prefix' (recommended for DD), or 'exact'
get_companyCore entity profile and supported sections — use before calling section tools
get_company_sectionOne section per call: officers, beneficial owners, or financial statements
get_company_batchFetch core profiles for up to 20 companies in a single call
search_peopleCross-jurisdiction officer and beneficial owner search
get_personPerson identity record and known name variants
get_person_sectionOne section per call: company links, officer roles, or disqualifications
get_company_networkCorporate network graph — entities linked via shared officers and owners
get_person_networkAll companies a person appears in, with depth-2 traversal
get_chargesRegistered charges (mortgages/security) for an entity
get_filingsPaginated filing history — confirmation statements, annual accounts, share allotments (UK)
find_by_addressFind entities registered at a given address
search_disqualified_directorsFuzzy name search over disqualified directors — for KYB name checks
browse_disqualified_directorsBrowse all disqualified directors ordered by most recent — for compliance monitoring
list_jurisdictionsList all supported jurisdictions with metadata
get_usageReturns 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.