Skip to main content
Glama
fieldnote-agents

Global Company Check MCP Server

README.md
<!-- mcp-name: io.github.fieldnote-agents/company-check-mcp -->
# Company Check MCP server (LEI, ARES, KRS, VIES)

An MCP server (stdio) that lets AI agents look up companies and Legal Entity
Identifiers (LEIs) worldwide. It calls the
[Global Company Check](https://apify.com/fieldnoteagents/global-company-check)
actor on Apify, which reads GLEIF open data (CC0).

> Not affiliated with or endorsed by GLEIF, the Czech Ministry of Finance, the Polish Ministry of Justice or the European Commission. Data comes from their public sources (GLEIF CC0, ARES, KRS open API, VIES).

## Tools

| Tool | What it does |
|---|---|
| `lookup_company(name, country?)` | Best match for a legal name; add an ISO-2 country (e.g. `SE`) for better results |
| `lookup_lei(lei)` | Full record for one 20-character LEI |
| `bulk_lookup(queries)` | Up to 500 queries: LEIs or `"Legal name \| CC"` |
| `czech_company_check(queries, include_persons?)` | Czech ARES: IČO lookup or company name ([actor](https://apify.com/fieldnoteagents/czech-company-check-ares)) |
| `poland_krs_extract(krs_numbers, include_persons?, full_extract?)` | Poland KRS extract by KRS number only ([actor](https://apify.com/fieldnoteagents/poland-krs-company-check)) |
| `eu_vat_check(vat_numbers, leis?, match_lei?, requester_vat_number?)` | EU VAT number check in VIES + GLEIF LEI match ([actor](https://apify.com/fieldnoteagents/eu-company-vat-check)) |

The LEI tools take `include_parents` (default `true`) to add direct and ultimate parents.
All tools take up to 500 items per call. Built for KYB, supplier and counterparty checks, not lead lists.
`include_persons` returns personal data (board members): use only for a lawful purpose (GDPR).

## Pricing

Runs go to **your own Apify account** using your `APIFY_TOKEN`:
each actor: first 25 results free, then $0.03 per company found / counterparty checked. No result, no charge.

## Setup

1. Get an Apify API token: https://console.apify.com/settings/integrations
2. Install: `pip install company-check-mcp` (or `uvx company-check-mcp`)
3. Add to your MCP client, e.g. Claude Desktop / Cursor:

```json
{
  "mcpServers": {
    "company-check": {
      "command": "uvx",
      "args": ["company-check-mcp"],
      "env": { "APIFY_TOKEN": "apify_api_..." }
    }
  }
}
```

From source: `pip install .` then run `company-check-mcp`.

## License

MIT. Made by Fieldnote Agents.

TDQS

A3.5/5.0

Scored across 3 tools

Disambiguation4/5

The three tools split cleanly by input key: lookup_company takes a legal name, lookup_lei takes a single 20-char LEI, and bulk_lookup handles many queries. There is mild overlap since bulk_lookup accepts both LEI and 'name | CC' formats, but the single-vs-batch boundary is clear enough to guide selection.

Naming Consistency4/5

All names are snake_case and start with a lookup verb, giving a predictable read (lookup_company, lookup_lei). The only minor deviation is bulk_lookup, which drops the 'lookup_' prefix for the batch variant, but it remains understandable.

Tool Count4/5

Three tools is slightly lean but well-matched to a focused GLEIF data-access service: one per lookup mode (name, LEI, batch). Each tool earns its place without redundancy, though the surface is minimal.

Completeness4/5

Core GLEIF access is covered: name search, single-LEI resolution, and batch lookup, all returning status, addresses and parents. Minor gaps exist (e.g. no reverse/parent-tree traversal or pagination/filter options), but agents can work around these by chaining lookups.

Maintenance

ActivityMaintained
ResponsivenessNo issues