CompanyLens MCP Server

Corporate intelligence for AI agents. Search companies, get SEC filings, screen sanctions, check government contracts — all via Model Context Protocol.

CompanyLens MCP gives your AI assistant access to real corporate data from official government sources. No web scraping, no hallucinations — verified data from SEC EDGAR, UK Companies House, OpenSanctions, and USAspending.gov.

Available Tools

Quick Start

Claude Desktop

claude mcp add companylens -- npx companylens-mcp

Claude Code (CLI)

Add to your project's .mcp.json:

{
  "mcpServers": {
    "companylens": {
      "command": "npx",
      "args": ["companylens-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "companylens": {
      "command": "npx",
      "args": ["companylens-mcp"]
    }
  }
}

Windsurf

Add to ~/.windsurf/mcp.json:

{
  "mcpServers": {
    "companylens": {
      "command": "npx",
      "args": ["companylens-mcp"]
    }
  }
}

Smithery

npx -y @smithery/cli install companylens-mcp --client claude

Usage Examples

Once connected, ask your AI assistant:

Company Research

• "Search for Apple Inc and show me their latest SEC filings"
• "Get the full profile for Microsoft — revenue, officers, SIC codes"
• "Look up Rolls Royce in the UK Companies House registry"

Compliance & Risk

• "Screen Gazprom against global sanctions lists"
• "Check if this company has any OFAC matches"
• "Run a sanctions check on all companies in my spreadsheet"

Government Contracts

• "What government contracts does Boeing have?"
• "Show me the top federal contracts for Lockheed Martin"
• "Are there any open SAM.gov opportunities for this vendor?"

Legal Research

• "Find federal court cases involving Tesla"
• "What litigation history does Johnson & Johnson have?"

How It Works

AI Assistant  →  CompanyLens MCP  →  CompanyLens API  →  Government Sources
                  (this server)       (REST backend)      SEC, CH, OFAC, SAM.gov

1. Your AI calls company_search with a company name
2. CompanyLens searches official registries (SEC EDGAR, Companies House)
3. Returns an entity_id — a stable identifier for that company
4. Use the entity_id with other tools to get profile, sanctions, contracts, court cases

Every response includes an agent_hint — a natural-language suggestion for what the AI should do next.

Data Sources

Configuration

Custom API URL

By default, the server connects to https://companylensapi.vercel.app. To use your own instance:

COMPANYLENS_API_URL=https://your-api.example.com npx companylens-mcp

Or in your MCP config:

{
  "mcpServers": {
    "companylens": {
      "command": "npx",
      "args": ["companylens-mcp"],
      "env": {
        "COMPANYLENS_API_URL": "https://your-api.example.com"
      }
    }
  }
}

Development

git clone https://github.com/diplv/companylens-mcp.git
cd companylens-mcp
pnpm install
pnpm dev

Build

pnpm build

Test with MCP Inspector

npx @modelcontextprotocol/inspector node dist/index.js

API Reference

company_search

Search companies by name or stock ticker.

Parameters:

• query (string, required) — Company name or ticker (e.g., "Apple", "AAPL", "Rolls Royce")
• jurisdiction (string, optional) — Filter: us, uk, or all (default: all)
• limit (number, optional) — Max results 1-50 (default: 10)

Returns: List of companies with entity_id for use with other tools.

company_profile

Full corporate profile with financials and registration data.

Parameters:

• entity_id (string, required) — CompanyLens entity ID from company_search

Returns: JSON with name, jurisdiction, status, SIC codes, registered address, XBRL financials (revenue, net income, total assets), recent filings, officers list, and data source attribution.

company_sanctions_check

Screen against global sanctions lists.

Parameters:

• entity_id (string, required) — CompanyLens entity ID from company_search

Returns: Boolean is_sanctioned flag, match details with confidence scores, and list names. Includes a disclaimer that this is automated screening, not legal advice.

company_contracts

US government contract awards and opportunities.

Parameters:

• entity_id (string, required) — CompanyLens entity ID from company_search

Returns: Awarded contracts (amount, agency, date) and open SAM.gov opportunities.

company_court_cases

Federal court litigation history.

Parameters:

• entity_id (string, required) — CompanyLens entity ID from company_search

Returns: Court cases with case name, court, docket number, filing date, and status.

Related

• CompanyLens API — The REST API backend powering this MCP server
• Model Context Protocol — The open protocol for AI tool integration
• Smithery — MCP server marketplace

License

MIT