Finnish Public Tenders (HILMA) — MCP avatar

Finnish Public Tenders (HILMA) — MCP

Pricing

from $1.00 / 1,000 tender searches

Go to Apify Store
Finnish Public Tenders (HILMA) — MCP

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

Anton Aouat

Maintained by Community

Actor stats

0

Bookmarked

1

Total users

0

Monthly active users

11 hours ago

Last modified

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

ToolWhat it does
search_tendersSearch 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_tenderFull 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_plansUpcoming 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_KEY as 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

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 build
HILMA_API_KEY=... node dist/server.js # register in your MCP client

Develop

npm test # unit tests (recorded fixtures)
npm run typecheck
HILMA_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