What it does
hilma-mcp gives Claude access to Finnish public procurement notices published on hankintailmoitukset.fi (Hilma). The search tool filters notices by CPV codes, keywords, publication period, notice type, procurement type and procedure type. A summary tool returns the metadata of one notice, including the contracting authority, deadline, value, CPV codes and portal URL. A deadline tool lists notices whose deadline falls within a set number of days, sorted from earliest to latest. A full-details tool returns contact names, emails and phone numbers from the eForms notice, tender portal URLs and the raw eForms XML.
It suits anyone who wants to look up Finnish public tenders from inside a Claude conversation, without opening a separate browser for the Hilma site. The notice data comes from the official Hilma API, and the server is published under the MIT licence by Aimiten.
Setup means cloning the repository, installing dependencies and building the project so that a dist/index.js file exists. The user then creates a .env file with a Hilma API key, or supplies the key in the Claude configuration, and adds the server path to the mcpServers section of the Claude Desktop configuration file. After Claude is restarted, the Hilma connector appears in the connectors list.
Limitations and requirements
Requires Node.js version 18 or newer. Requires Claude Desktop or Claude Cowork with MCP support. Requires a Hilma AVP API key, which is not bundled with the code and must be obtained by registering with the Hilma API developer portal. The get_notice_full tool requires a read key (HILMA_READ_API_KEY); the same key works if it is subscribed to the avp-read product. The .env file is excluded from Git by .gitignore and should not be committed.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.Aimiten/hilma-mcp
MCP server for Finnish public procurement notices (Hilma). Built by Aimiten.
v1.1.1As shown on registry.modelcontextprotocol.io when we last read it