hilma-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HILMA_API_KEY | Yes | Your Hilma API key (avp-read) for most tools. Required. | |
| HILMA_READ_API_KEY | No | Your Hilma Read API key (same key as HILMA_API_KEY). Needed for get_notice_full tool. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_noticesA | Hae hankintailmoituksia Hilmasta. Tukee vapaatekstihakua, CPV-koodisuodatusta, aikarajausta, ilmoitustyypin ja menettelytyypin valintaa. Palauttaa listauksen ilmoituksista otsikoineen, hankintayksikköineen ja määräaikoineen. |
| get_notice_summaryA | Hae yksittäisen ilmoituksen yhteenveto noticeId:llä. Käyttää search-APIa — ei vaadi erillistä tilausta. Palauttaa kaikki metatiedot: tilaaja, deadline, arvo, CPV, portaali-URL. |
| get_notice_fullA | Hae ilmoituksen täydet tiedot eForms XML -muodossa, mukaan lukien yhteystiedot (BT-502 nimi, BT-503 sähköposti, BT-506 puhelin) ja tarjousportaalin linkit. VAATII erillisen avp-read-eforms-api -tilauksen ja HILMA_READ_API_KEY .env:ssä. Rekisteröi: https://hns-hilma-prod-apim.developer.azure-api.net/ → avp-read-eforms |
| get_expiring_soonA | Hae ilmoitukset joiden tarjousaika päättyy seuraavan N päivän sisällä. Järjestää deadlinen mukaan nousevaan järjestykseen. Hyödyllinen: 'mitä deadlineja on ensi viikolla', 'kiireellisimmät hankkeet'. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: search_notices for discovery, get_expiring_soon for time-sensitive filtering, get_notice_summary for metadata, and get_notice_full for complete XML data. No overlap or ambiguity between tools.
All tools follow a consistent snake_case verb_noun pattern: get_notice_summary, get_notice_full, search_notices, get_expiring_soon. The naming is predictable and uniform.
With only 4 tools, the server is well-scoped for its purpose of accessing Finnish procurement notices. Each tool earns its place without unnecessary bloat or glaring omissions.
The surface covers the full read-only lifecycle: search for notices, retrieve summaries, retrieve full XML details, and find expiring deadlines. No apparent gaps for the intended use case.