About firmbase
firmbase provides Claude, Codex, and other MCP clients with Belgian company information from official registers, filed annual accounts, and the Belgian Official Gazette. It also offers due-diligence and sales-workspace tools, with changes requiring approval in firmbase.
Key features
- 01Search Belgian company records and accounts
- 02Check company status, figures, and notices
- 03Build ranked prospect lists by sector and region
- 04Read sales lists, notes, reminders, and watchlists
- 05Submit workspace changes for approval
Use cases
- 01Review a Belgian counterparty before engagement
- 02Find companies in a sector and region for prospecting
- 03Check a lead’s sales notes and pipeline
- 04Request a workspace update for confirmation
MCP support
The MCP server exposes company-data and firmbase workspace tools to MCP clients. Data tools are read-only; workspace changes are submitted as approval requests and take effect only after confirmation in firmbase.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.firmbase.be/mcpclaude mcp add --transport http firmbase-be-firmbase https://api.firmbase.be/mcp{"mcpServers":{"firmbase-be-firmbase":{"type":"http","url":"https://api.firmbase.be/mcp"}}}Open in Cursor{"servers":{"firmbase-be-firmbase":{"type":"http","url":"https://api.firmbase.be/mcp"}}}Open in VS Code{"mcpServers":{"firmbase-be-firmbase":{"type":"http","url":"https://api.firmbase.be/mcp"}}}{"mcpServers":{"firmbase-be-firmbase":{"serverUrl":"https://api.firmbase.be/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEfirmbase plugin for Claude and Codex
Belgian company data inside your AI assistant, from the official sources: the Crossroads Bank for Enterprises (KBO/BCE/CBE) register, the annual accounts filed with the National Bank of Belgium, and the Belgian Official Gazette. Refreshed every night.
The plugin connects the firmbase MCP server and adds four skills:
- belgian-company-data: which of the 33 data tools answers which question, how to identify a company, and how to cite the sources.
- company-due-diligence: a structured check of a counterparty, from status and figures to insolvency notices, the 30bis/30ter withholding obligation and sanctions screening.
- prospect-list: target companies in a sector and region, ranked on revenue or staff, next to the sector median, and saved as a list in firmbase if you want.
- sales-workspace: your own firmbase account through 34 more tools: sales lists and their pipeline, notes and reminders, saved searches, the watchlist and watch rules, leads and exports.
Nothing changes without you
The data tools only read. The workspace tools read your lists, notes and watchlist directly, but they never change them on their own. When the assistant wants to change something, such as creating a list, moving a company to won, adding a note or following a company, it files a request. You see that request on the Approvals page in firmbase, with the companies by name, and you confirm or reject it there. Nothing happens until you click Confirm, and a request expires after a day.
Install
Claude Code
claude plugin marketplace add firmbase-be/firmbase-plugin
claude plugin install firmbase@firmbase
Then run /mcp in Claude Code, choose firmbase and Authenticate. Your browser opens firmbase to sign in.
Codex
codex plugin marketplace add firmbase-be/firmbase-plugin
codex plugin add firmbase@firmbase
Codex asks you to sign in with firmbase when the plugin is installed.
Claude.ai, ChatGPT and other MCP clients
No plugin needed. Add https://api.firmbase.be/mcp as a custom connector and sign in when asked. See firmbase.be/en/api/mcp for per-client steps.
Sign-in
You sign in with your firmbase account through OAuth. You don't paste an API key anywhere. The connection gets its own key on your account, named after the client, so you can see its usage and revoke it in the dashboard.
Which tools your account reaches is set by your firmbase account. A tool it does not reach says so, and the assistant tells you.
Privacy
firmbase receives the tool calls your assistant makes, such as a company number or a search term, the same as an API call. It never sees the conversation itself. See the privacy policy.
Support
Open an issue in this repository, or write to [email protected].
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.