Finnish Public Tenders (HILMA) — MCP
Pricing
from $1.00 / 1,000 tender searches
Finnish Public Tenders (HILMA) — MCP
MCP server for Finnish public procurement (HILMA): search tenders, awards and procurement plans by keyword, CPV, region and buyer, and fetch full notice details.
Pricing
from $1.00 / 1,000 tender searches
Rating
0.0
(0)
Developer
Anton Aouat
Maintained by CommunityActor stats
0
Bookmarked
1
Total users
0
Monthly active users
11 hours ago
Last modified
Categories
Share
Finnish Public Tenders (HILMA) — MCP Server
Search and monitor Finnish public procurement from your AI agent, straight from HILMA (hankintailmoitukset.fi) open data. Find relevant tenders and awards, get full notice details, and track upcoming procurement plans — by CPV code, region, buyer, and keyword.
Built for suppliers bidding on public contracts, and the agencies/tools serving them.
Tools
| Tool | What it does |
|---|---|
search_tenders | Search procurement notices (contract / prior-information / award) by keyword, CPV code, region (NUTS), buyer, notice type, date, EU-vs-national, open-only. Returns buyer, CPV, value, deadline, status. |
get_tender | Full details for one notice (id from search, or numeric noticeId): buyer + contacts, description, CPV, procedure, value, deadline, lots, winner (for awards), document + TED links. |
search_procurement_plans | Upcoming procurement plans — non-binding early signals of forthcoming procurements, before the tender is published. |
Titles/descriptions in en, fi, or sv (most Finnish tenders are Finnish-only; falls back to Finnish).
Example
// search_tenders — open IT tenders in the Helsinki region{ "query": "IT", "region": "FI1B", "onlyOpen": true, "top": 10 }
Configuration
Requires a HILMA AVP-Read subscription key (free; register at the
developer portal → Products →
avp-read → Subscribe). Provide it as the HILMA_API_KEY environment variable:
- Local: put
HILMA_API_KEY=...in your.env(gitignored) or the shell environment. - Hosted (Apify): set
HILMA_API_KEYas a secret Environment variable on the Actor.
The key is a server secret — buyers of the hosted endpoint never see it; they pay per call.
Use it
Hosted (Apify) — recommended
Connect your MCP client to the Actor's Standby URL at the /mcp path; billing is per
successful tool call (Pay-Per-Event).
Local (stdio)
npm install && npm run buildHILMA_API_KEY=... node dist/server.js # register in your MCP client
Develop
npm test # unit tests (recorded fixtures)npm run typecheckHILMA_API_KEY=... npm run smoke # live end-to-end check
Architecture (small units): src/hilma/client.ts (HTTP + key auth + throttle/cache),
src/hilma/query.ts (safe Azure-Search query building), src/hilma/normalize.ts
(raw → clean tender shape), src/tools.ts (MCP tools), src/server.ts / src/standby.ts
(stdio / Apify HTTP transports).
Data source & attribution
Data from HILMA (hankintailmoitukset.fi), operated by Hansel Oy, via the AVP-Read open API, licensed CC BY 4.0. This server is an independent tool, not affiliated with Hansel/HILMA.
License
MIT