Hilma Mcp
Connects Claude directly to Finland's public procurement system (Hilma) via their official API. You get four tools: search_notices for filtering by CPV codes, keywords, or date ranges; get_notice_summary for metadata on a specific tender; get_expiring_soon for upcoming deadlines; and get_notice_full for complete eForms XML including contact details. Requires a free API key from the Hilma developer portal. Useful if you're monitoring Finnish public tenders, tracking procurement opportunities in specific sectors, or need to extract structured data from Hilma without manual browser work. Built by Aimiten, a Finnish consultancy focused on AI tooling for SMEs.
- tools
- 4
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- May 15, 2026
Tools
4 toolsPublic tool metadata for what this MCP can expose to an agent.
search_noticesHae ilmoituksia CPV-koodeilla, hakusanalla, päivämäärällä
Hae ilmoituksia CPV-koodeilla, hakusanalla, päivämäärällä
No parameter schema in public metadata yet.
get_notice_summaryYksittäisen ilmoituksen metatiedot noticeId:llä
Yksittäisen ilmoituksen metatiedot noticeId:llä
No parameter schema in public metadata yet.
get_expiring_soonIlmoitukset joiden deadline on N päivän sisällä
Ilmoitukset joiden deadline on N päivän sisällä
No parameter schema in public metadata yet.
get_notice_fullTäysi eForms XML + yhteystiedot (BT-502/503/506)
Täysi eForms XML + yhteystiedot (BT-502/503/506)
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
HILMA_API_KEY*secretHilma APIM avp-read subscription key. Get a free key at https://hns-hilma-prod-apim.developer.azure-api.net/
HILMA_READ_API_KEY*secretSame as HILMA_API_KEY — avp-read product includes EForms Read API. Required for get_notice_full tool.
Readme
hilma-mcp
MCP (Model Context Protocol) -serveri Suomen julkisille hankintailmoituksille — hankintailmoitukset.fi (Hilma).
Mahdollistaa hankintailmoitusten haun suoraan Claude-assistentista ilman erillistä selainta.
Kieliversio: Ohjeet suomeksi alla. English instructions further down.
Vaatimukset
- Node.js versio 18 tai uudempi
- Claude Desktop tai Claude Cowork (MCP-tuki)
- Hilma AVP API -avain (ks. alla)
Asennus
1. Kloonaa repo
git clone https://github.com/Aimiten/hilma-mcp.git
cd hilma-mcp
2. Asenna riippuvuudet ja buildaa
npm install
npm run build
Tämä luo dist/index.js-tiedoston, jota Claude ajaa.
3. Luo .env-tiedosto
cp .env.example .env
Avaa .env tekstieditorissa ja lisää API-avaimesi:
HILMA_API_KEY=oma-avp-read-avain-tähän
HILMA_READ_API_KEY=oma-avp-read-avain-tähän
Huom: Molemmat kentät käyttävät samaa avainta —
avp-read-tuote sisältää jo Read API (EForms) -rajapinnan, joten erillistä tilausta ei tarvita.
Details
- Repository
- github.com/aimiten/hilma-mcp
- Website
- aimiten.fi
- Package
hilma-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active