company-research-mcp
An MCP server that fetches official company filings — annual reports, AGM documents, regulatory
announcements — from public sources and makes them available to an AI client.
Current Coverage
- UK companies via Companies House
Installation
Download a pre-built binary (no Go required):
Download the latest release for your platform from
GitHub Releases,
extract the archive, and place the binary on your $PATH.
Install via go install:
go install github.com/riftwerx/company-research-mcp/cmd/company-research-mcp@latest
Or build from source (installs to $GOPATH/bin):
git clone https://github.com/riftwerx/company-research-mcp
cd company-research-mcp
make local-release
make targets require a Unix-like environment (Linux, macOS, or WSL on Windows).
Windows users without WSL can run go install ./cmd/company-research-mcp directly —
the binary is fully Windows-compatible; only the build tooling requires Unix.
The binary is named company-research-mcp. Ensure $(go env GOPATH)/bin is on your $PATH.
Verify the installation:
company-research-mcp --version
Prerequisites
Register for a free Companies House API key at
https://developer.company-information.service.gov.uk
Client Configuration
Claude Code
claude mcp add --transport stdio company-research \
--scope user \
--env CH_API_KEY=your-key-here \
-- company-research-mcp
Claude Desktop
Add to claude_desktop_config.json:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"company-research": {
"command": "company-research-mcp",
"env": {
"CH_API_KEY": "your-key-here"
}
}
}
}
Cursor
Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"company-research": {
"command": "company-research-mcp",
"env": {
"CH_API_KEY": "your-key-here"
}
}
}
}
Windsurf
Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"company-research": {
"command": "company-research-mcp",
"env": {
"CH_API_KEY": "your-key-here"
}
}
}
}
Continue.dev
Add to ~/.continue/config.json under mcpServers:
{
"mcpServers": [
{
"name": "company-research",
"command": "company-research-mcp",
"env": {
"CH_API_KEY": "your-key-here"
}
}
]
}
| Tool |
Description |
search_company |
Search for UK companies by name |
get_company_profile |
Get a company profile by Companies House number |
list_filings |
List filing history for a company; returns a document_id for each filing (filings without a downloadable document are excluded) |
fetch_filing |
Download a specific filing document using the document_id from list_filings |
get_latest |
Fetch the most recent filing of a given category; returns a document_id alongside the local path |
list_zip_contents |
List all documents extracted from a zip archive filing; use when fetch_filing or get_latest returns is_archive: true |
extract_xbrl_facts |
Parse a cached iXBRL .xhtml file and return structured financial facts as JSON; also reports whether the document is native iXBRL or PDF-rendered |
clear_cache |
Delete cached filing documents |
Filings are returned as PDF or iXBRL (.xhtml) depending on what Companies House provides.
When a filing is served as a zip archive, all documents are extracted and the primary document is
selected automatically. The fetch_filing / get_latest response will include is_archive: true
alongside local_path and document_id for the primary file. Call list_zip_contents with the
same ch_number and document_id to get the full manifest — each entry has its own local_path,
content_type, and is_primary flag, so secondary documents (e.g. a PDF companion alongside an
iXBRL) can be accessed directly. When an archive contains more than 20 files, truncated: true is
set and total_in_archive shows the full count.
When fetch_filing or get_latest returns content_type: application/xhtml+xml, the file is an
iXBRL document containing tagged financial data. Use extract_xbrl_facts to parse it:
extract_xbrl_facts(local_path=<path from fetch_filing>)
Returns {facts, count, truncated, render_type, warnings?}. Each fact has name, value,
period, and unit. When truncated is true the document contained more than 2,000 facts —
use name_prefix to narrow the query (e.g. name_prefix="Revenue" returns only Revenue-related
facts).
render_type is "native_ixbrl" for standard filings or "pdf_rendered" for filings produced
by a PDF-to-HTML converter (e.g. pdf2htmlEX). PDF-rendered filings have fully extractable XBRL
facts but fragmented narrative text (MD&A, notes); when detected a warnings array explains this
and the document will not be readable as prose. If the filing came from a zip archive, the warning
also names any alternative formats available (e.g. a PDF) and directs you to use list_zip_contents
to access them.
Local cache
Downloaded filings are stored on disk and reused on subsequent requests:
| Platform |
Path |
| Linux |
~/.cache/company-research.mcp/ |
| macOS |
~/Library/Caches/company-research.mcp/ |
| Windows |
%LOCALAPPDATA%\company-research.mcp\ |
Use the clear_cache tool to free disk space.
Examples
(See EXAMPLE_PROMPTS.md for more usage examples)
Company status check
Find Monzo Bank and tell me whether it's still active
Tools: search_company → get_company_profile
Agent: Monzo Bank Limited (CH: 09446231) is active. It's a private limited company
registered in England & Wales. Registered office: Broadwalk House, 5 Appold Street, London,
EC2A 2AG. SIC code: 64191 (Banks).
Fetch and summarise the latest accounts
Look up Rolls-Royce Holdings, then download and summarise their most recent annual accounts
Tools: search_company → get_company_profile → get_latest
Agent: Found Rolls-Royce Holdings plc (CH: 07524813), active. Fetching the latest
accounts filing… downloaded 4.2 MB PDF to the local cache.
[reads document]
The accounts cover the year ended 31 December 2023. Revenue was £16.5 billion (up 17%
year-on-year), driven by growth in Civil Aerospace. Underlying operating profit was £1.6
billion, compared to £652 million in 2022. Net debt reduced from £3.3 billion to £0.2
billion. The auditors issued an unqualified opinion.
Compare multiple companies by name
Search for "British Steel" and compare the registered addresses of the top results
Tools: search_company → get_company_profile ×N
Agent:
| Company |
CH Number |
Status |
Registered Address |
| British Steel Limited |
09523808 |
Active |
Brigg Road, Scunthorpe, DN16 1BP |
| British Steel Pension Scheme Trustee Ltd |
06437005 |
Active |
1 Kingsway, London, WC2B 6AN |
| British Steel (Overseas Holdings) Ltd |
04669999 |
Dissolved |
— |