MCP.Market

Hilma MCP server

by Aimiten·io.github.Aimiten/hilma-mcp·v1.1.1
No reviews yet

MCP server for Finnish public procurement notices (Hilma). Built by Aimiten.

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

0 stars

Reviews

Write one

Nobody has reviewed Hilma yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Hilma tools (4)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_expiring_soon

    Hae ilmoitukset joiden tarjousaika päättyy seuraavan N päivän sisällä.

  • get_notice_full

    Hae ilmoituksen täydet tiedot eForms XML -muodossa, mukaan lukien yhteystiedot

  • get_notice_summary

    Hae yksittäisen ilmoituksen yhteenveto noticeId:llä.

  • search_notices

    Hae hankintailmoituksia Hilmasta. Tukee vapaatekstihakua, CPV-koodisuodatusta,

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 136 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Hilma compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 38% of 48,255 servers
Tools
4
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break

What its tools let an agent do: 4 read

Install Hilma in Claude Code, Cursor or VS Code

Runs npx -y hilma-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add hilma-mcp -- npx -y hilma-mcp
Add to Cursor

What the publisher says

From the Hilma repository's README, as published. We do not edit it. Read it on GitHub

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.

Hanki avain ilmaiseksi:

  1. Mene osoitteeseen https://hns-hilma-prod-apim.developer.azure-api.net/
  2. Rekisteröidy tai kirjaudu → Products → avp-read → Subscribe
  3. Kopioi Primary key Profile-sivulta

Huom: .env-tiedostoa ei koskaan commitoida GitHubiin — se on jo .gitignore:ssa.

4. Lisää Claude-konfiguraatioon

Avaa Claude Desktopin konfiguraatiotiedosto:

Lisää tai muokkaa mcpServers-osiota:

{
  "mcpServers": {
    "hilma": {
      "command": "node",
      "args": ["/ABSOLUUTTINEN/POLKU/hilma-mcp/dist/index.js"]
    }
  }
}

Tärkeää: Korvaa /ABSOLUUTTINEN/POLKU/hilma-mcp oikealla polulla omalla koneellasi. Esimerkiksi:

  • macOS: /Users/sinunnimesi/hilma-mcp/dist/index.js
  • Windows: C:\\Users\\sinunnimesi\\hilma-mcp\\dist\\index.js

4. Käynnistä Claude uudelleen

Hilma ilmestyy connectors-listaan uudelleenkäynnistyksen jälkeen.

API-avain

Serveri vaatii oman API-avaimen — sitä ei ole bundlattu koodiin tietoturvasyistä.

  1. Rekisteröidy ilmaiseksi: https://hns-hilma-prod-apim.developer.azure-api.net/
  2. Lisää avain .env-tiedostoon (suositeltu):
HILMA_API_KEY=oma-avaimesi-tähän
  1. Tai anna se suoraan Claude-konfiguraatiossa:
{
     "mcpServers": {
       "hilma": {
         "command": "node",
         "args": ["/polku/hilma-mcp/dist/index.js"],
         "env": {
           "HILMA_API_KEY": "oma-avaimesi-tähän"
         }
       }
     }
   }

Työkalut

search_notices — Hankintailmoitusten haku

getnoticesummary — Yksittäisen ilmoituksen yhteenveto

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Hilma: common questions

Is Hilma MCP server safe?
Mostly: it is graded B (72/100). Read the Hilma safety report
How do I install Hilma?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Hilma need an API key?
Yes. The registry entry asks for HILMA_API_KEY, HILMA_READ_API_KEY.
Is Hilma maintained?
The last commit was 173 days ago (2026-05-15). The latest release is v1.1.1.
How does Hilma compare with other MCP servers?
safety score 72/100 (higher than 38% of 48,255 servers); tools 4 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.