company-research-mcp

module
v0.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 4, 2026 License: Apache-2.0

README

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"
      }
    }
  ]
}

Available Tools

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 (filings without a downloadable document are excluded)
fetch_filing Download a specific filing document (document_url must be a document-api.company-information.service.gov.uk URL)
get_latest Fetch the most recent filing of a given category
clear_cache Delete cached filing documents

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 —

Directories

Path Synopsis
cmd
internal
cache
Package cache implements local storage for downloaded company filings.
Package cache implements local storage for downloaded company filings.
mcp
Package mcp implements the MCP server and tool handlers for company-research-mcp.
Package mcp implements the MCP server and tool handlers for company-research-mcp.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL