Skip to content

Ask your AI assistant about any Belgian company

MCP server

With the Checked.be MCP server, your AI assistant answers questions about Belgian companies from our verified data: identity and status from the KBO register, acts from the Belgian State Gazette, directors and annual accounts. Every result names Checked.be as the source, with a link to the dossier.

What you get

Any Belgian company, in plain language

Your assistant finds a company by name, enterprise number, VAT number or NACE code and summarises what you want to know.

Verified data, with its source

Every fact from an act carries the numac number of its publication in the Belgian State Gazette, and every result links to the dossier on Checked.be.

Honest about what is missing

When we have not yet read every act of a company, the server says how many we have. Your assistant then assumes no completeness that is not there.

Questions your assistant can then answer
  • Who are the current directors of Colruyt Group?
  • What has the Belgian State Gazette published about this company in the past year?
  • How healthy is this supplier according to its latest annual accounts?

Six tools

Your assistant picks the tool that fits your question. All six are read-only: no tool changes any data.

search_companies

Finds companies by name, enterprise number, VAT number or NACE code, each hit with the link to its dossier.

get_company_profile

The profile of one company: identity, status, registered seat and activity, the key figures from the latest annual accounts, the health score, the credit verdict and the bankruptcy risk band.

get_company_acts

The acts from the Belgian State Gazette, newest first, with the facts of each act and, for every fact, the numac number of its publication.

get_company_officers

Directors and mandates, each marked current, last confirmed or ended, with permanent representatives, statutory auditors and the act each mandate comes from.

get_company_financials

The figures and ratios from the latest processed annual accounts, adapted to the company's sector.

get_extraction_status

How many acts the Belgian State Gazette holds for a company and how many we have read, so your assistant knows how complete the picture is.

Connect your assistant

Every connection needs an API key. This is how to get one. In the examples, replace YOUR_KEY with your own key.

Claude Code

One command
  1. Run this command in your terminal:
    Terminal
    claude mcp add --transport http checked https://checked.be/mcp --header "X-Api-Key: YOUR_KEY"
  2. By default the connection applies to the project you are working in. Add --scope user to use Checked in all your projects.

Claude Desktop

Configuration file
  1. In Claude Desktop, open the settings, choose Developer and then Edit Config. That opens the file claude_desktop_config.json, which you can also open directly at this location:
    • macOS~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows%APPDATA%\Claude\claude_desktop_config.json
  2. Add the server under mcpServers. If the file already lists servers, add only the checked block.
    claude_desktop_config.json
    {
      "mcpServers": {
        "checked": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-remote",
            "https://checked.be/mcp",
            "--header",
            "X-Api-Key:${CHECKED_API_KEY}"
          ],
          "env": {
            "CHECKED_API_KEY": "YOUR_KEY"
          }
        }
      }
    }
  3. Quit Claude Desktop completely and start it again.
Through this file, Claude Desktop only starts programs on your own computer. The mcp-remote program makes the connection to Checked from there and needs Node.js 18 or later. Keep the header as written in the example, with no space after the colon: Claude Desktop on Windows does not pass spaces in that line on correctly.

Cursor

mcp.json
  1. Put this in ~/.cursor/mcp.json to use Checked in all your projects, or in .cursor/mcp.json in the folder of a single project. If the file already lists servers, add only the checked block.
    mcp.json
    {
      "mcpServers": {
        "checked": {
          "url": "https://checked.be/mcp",
          "headers": {
            "X-Api-Key": "YOUR_KEY"
          }
        }
      }
    }

Other assistants

HTTP with a header

Any assistant that supports a remote MCP server over HTTP with a header of its own needs these three facts:

Address
https://checked.be/mcp
Transport
Streamable HTTP
Header
X-Api-Key: YOUR_KEY

In Visual Studio Code it looks like this, in .vscode/mcp.json:

.vscode/mcp.json
{
  "servers": {
    "checked": {
      "type": "http",
      "url": "https://checked.be/mcp",
      "headers": {
        "X-Api-Key": "YOUR_KEY"
      }
    }
  }
}
In preparation: ChatGPT and Claude on the web
The connectors you add on the web in ChatGPT and in Claude do not work with Checked yet. They ask you to sign in to the service, and Checked does not offer that sign-in yet. That sign-in is in preparation; until then, Checked works in the assistants above.

An API key

Keys are issued by hand today: mail enterprise@checked.be and say what you are building. There is no self-service key page yet.

The same key also opens the REST API. Keep it secret: never put it in a URL, a log file or a prompt.

Need an API key?
Tell us what you are building. Keys are issued by hand, which means you get a human answer rather than a form.
enterprise@checked.be

Using the data

Search, AI input and AI training are allowed on one condition: whoever uses content from Checked.be names Checked.be as the source, with a link to the exact page the content came from.

Every result from the server carries the attribution Checked.be, geverifieerde Staatsblad-extractie and the link to the company's dossier on Checked.be. When you or your assistant pass the data on, name Checked.be as the source with that link.

Privacy

The server returns no dates of birth. Directors appear under their name as the Belgian State Gazette publishes it.

Pages about natural persons are excluded for AI: AI crawlers may not read them and no document for AI agents points to them. More in our privacy policy.

Technical details

Address
https://checked.be/mcp
Transport
Streamable HTTP, read-only
Access
An API key in the header X-Api-Key. Without a valid key the server answers 401.
Rate limit
60 requests per minute per API key
Server card
https://checked.be/.well-known/mcp/server-card.json
Reference
The full technical reference for the REST API and the MCP server: Developers.