MCP server setup

Connect CompanyLens to your AI agent in under 2 minutes — no code required. You'll need a free CompanyLens account (50 queries/month, no credit card) and this URL:

https://mcp.companylens.io/mcp

Claude Desktop & Claude.ai

Claude.ai requires a Pro, Max, Team, or Enterprise plan to add custom connectors.

1. 1

   Go to Settings → Connectors

   Open Claude Desktop or claude.ai, click your profile picture, and select Settings. Navigate to the Connectors tab.

2. 2

   Add the custom connector

   Click Add custom connector, then copy the name and Remote URL below:

   Name

   CompanyLens

   Remote URL

   https://mcp.companylens.io/mcp

3. 3

   Sign in when prompted

   The first time you use a CompanyLens tool in a conversation, Claude will ask you to authorise the connection. Click Allow and sign in with your CompanyLens account.

ChatGPT

Requires a Pro, Plus, Team, or Enterprise ChatGPT plan.

1. 1

   Go to Settings → Connectors

   In ChatGPT, click your profile picture and go to Settings. Select the Connectors tab.

2. 2

   Add the MCP connector

   Click + Add connector, select Model Context Protocol (MCP), then copy the URL and label below, and click Save:

   URL

   https://mcp.companylens.io/mcp

   Label

   CompanyLens

3. 3

   Authenticate when prompted

   ChatGPT will open an OAuth flow to connect your CompanyLens account. Sign in and you're ready to use CompanyLens tools in your conversations.

Claude Code

1. 1

   Run the setup command

   In your terminal, run:

   claude mcp add --transport http companylens https://mcp.companylens.io/mcp

   Alternatively, add the following to your ~/.claude.json directly:

   ~/.claude.json

   {
     "mcpServers": {
       "companylens": {
         "type": "http",
         "url": "https://mcp.companylens.io/mcp"
       }
     }
   }

2. 2

   Restart Claude Code

   Exit and reopen Claude Code. CompanyLens tools will be available in your next session. You'll be prompted to sign in the first time you use one.

Cursor

1. 1

   Open MCP settings

   In Cursor, go to Settings → Tools & MCP.

2. 2

   Add the server config

   Paste the following into the MCP config editor:

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

3. 3

   Save and authenticate

   Save the settings. On first use, Cursor will prompt you to sign in with your CompanyLens account.

Windsurf

1. 1

   Open MCP settings

   In Windsurf, open Settings → Cascade → MCP Servers.

2. 2

   Add the server config

   Add a new server entry with the config below. Note that Windsurf uses serverUrl rather than url:

   {
     "mcpServers": {
       "companylens": {
         "serverUrl": "https://mcp.companylens.io/mcp"
       }
     }
   }

3. 3

   Save and authenticate

   Save the settings. On first use, Windsurf will prompt you to sign in with your CompanyLens account.

GitHub Copilot

Requires VS Code 1.101+ and an active GitHub Copilot subscription.

1. 1

   Run MCP: Add Server from the Command Palette

   Open VS Code 1.101 or later. Press Ctrl+Shift+P (Windows/Linux) or Cmd+Shift+P (macOS) to open the Command Palette, then run MCP: Add Server.

2. 2

   Select HTTP and paste the URL

   Choose HTTP as the server type and paste:

   https://mcp.companylens.io/mcp

   Alternatively, edit your mcp.json directly:

   mcp.json

   {
     "servers": {
       "companylens": {
         "type": "http",
         "url": "https://mcp.companylens.io/mcp"
       }
     }
   }

3. 3

   Authenticate on first use

   The first time Copilot calls a CompanyLens tool, VS Code will prompt you to sign in. Follow the OAuth flow to connect your account.

Example queries

Once connected, try these in any conversation:

• “Find all UK companies named Revolut and show me their current directors.”
• “Who are the persons with significant control for Monzo Bank?”
• “List all active Irish companies where Sarah Murphy is a director.”
• “Check if Jane Doe appears on the UK disqualified directors register.”
• “Show me all companies connected to UK company 08804411 through shared officers.”

More examples: MCP examples →