Home / Developers
Developers

Companies House MCP server: connect UK company data to Claude, ChatGPT and Cursor

Updated By
Short answerA Companies House MCP server lets an AI assistant such as Claude, ChatGPT or Cursor look up UK companies itself. Our remote server at data.globalmindsetmarketing.co.uk/mcp covers the full register of 5.7 million companies plus balance sheet figures from 37 million iXBRL accounts since 2008, and works with a free key in about two minutes.

What an MCP server does for company research

The Model Context Protocol (MCP) is an open standard that lets AI assistants call external tools. With a Companies House MCP server connected, you can ask Claude "Is TESCONS LTD still trading and what were its net assets last year?" and the assistant calls a tool, reads the answer from real filings and cites it, instead of guessing from training data.

Typical jobs it handles well:

Connect in two minutes

  1. Get a free key on the developer docs page (50 requests a month, no card).
  2. Add the server to your client using one of the snippets below.
  3. Ask a question that names a UK company or a company number.

claude.ai (web and mobile)

Settings, Connectors, Add custom connector, then paste:

https://data.globalmindsetmarketing.co.uk/mcp?key=YOUR_KEY

claude.ai custom connectors cannot send headers, so the key goes in the URL. Treat that URL as a secret.

Claude Code

claude mcp add --transport http uk-company-data https://data.globalmindsetmarketing.co.uk/mcp --header "Authorization: Bearer YOUR_KEY"

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "uk-company-data": {
      "url": "https://data.globalmindsetmarketing.co.uk/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Claude Desktop

Claude Desktop reaches remote servers through mcp-remote (needs Node.js). Add to claude_desktop_config.json:

{
  "mcpServers": {
    "uk-company-data": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://data.globalmindsetmarketing.co.uk/mcp", "--header", "Authorization: Bearer YOUR_KEY"]
    }
  }
}

ChatGPT and other clients

Any client that supports remote MCP over Streamable HTTP can use the same endpoint. Where a client cannot send an Authorization header, append ?key=YOUR_KEY to the URL.

Tools the server exposes

ToolWhat it returns
search_by_nameCompanies matching a name across the whole register, exact matches and active companies first
lookup_companyRegister details, latest iXBRL balance sheet, filing history and risk signals for one company number
compare_companiesTwo companies side by side
search_companiesCompanies filtered by size, risk band, trajectory, assets or employees
find_triggersLead-generation signals: rapid growth, cash-rich, distressed, new investment
market_statsAggregates across the dataset
recent_changesCompanies whose accounts were published in the last N days
watch_add, watch_list, watch_removeYour watchlist: 5 companies on Free, 50 on Pro
get_alertsStatus changes, overdue accounts, new accounts, new charges, negative net assets, falling cash

Example prompts

What the data covers, and what it does not

Figures are what the company filed. They are not a credit rating.

Why not build your own server on the Companies House API?

You can, and for live officer or filing-history lookups the free Companies House API is the right source. The API does not return balance sheet figures as data, though: accounts come as documents. Getting numbers means downloading bulk iXBRL files, parsing tens of millions of documents and keeping them in sync daily. That is the part this server does for you. See Companies House API vs bulk data for the trade-offs.

FAQ

Is there an official Companies House MCP server?

Not as of October 2026. Companies House publishes a REST API and bulk data files. MCP servers for Companies House, including this one, are built by third parties on top of that open data.

Is the MCP server free?

Yes, up to 50 requests a month on the free key. API Pro is £39 a month for 5,000 requests and a 50-company watchlist.

Does it work with ChatGPT?

Yes, in any ChatGPT surface that supports remote MCP connectors over Streamable HTTP. Use the URL with ?key= if the client cannot send headers.

Where does the financial data come from?

From iXBRL accounts filed at Companies House and published in its free accounts bulk data, used under the Open Government Licence v3.0.

Try it with a free key. 50 requests a month, REST and MCP, no card. Company register, iXBRL financial history since 2008 and watchlist alerts.

Get a free API key