Hilma MCP

Name: Hilma MCP
Author: Aimiten

von AimitenVersion 1.1.1i★ –iLäuft auf deinem Computer

Name in der Registryio.github.Aimiten/hilma-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

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

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges
Das musst du eintragen: HILMA_API_KEY, HILMA_READ_API_KEY

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: HILMA_API_KEY, HILMA_READ_API_KEY

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "hilma": {
      "command": "npx",
      "args": [
        "-y",
        "hilma-mcp"
      ],
      "env": {
        "HILMA_API_KEY": "your-value",
        "HILMA_READ_API_KEY": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add hilma --env HILMA_API_KEY=your-value --env HILMA_READ_API_KEY=your-value -- npx -y hilma-mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "hilma": {
      "command": "npx",
      "args": [
        "-y",
        "hilma-mcp"
      ],
      "env": {
        "HILMA_API_KEY": "your-value",
        "HILMA_READ_API_KEY": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "hilma": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hilma-mcp"
      ],
      "env": {
        "HILMA_API_KEY": "your-value",
        "HILMA_READ_API_KEY": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

HILMA_API_KEY geheim erforderlich env
Hilma APIM avp-read subscription key. Get a free key at https://hns-hilma-prod-apim.developer.azure-api.net/
HILMA_READ_API_KEY geheim erforderlich env
Same as HILMA_API_KEY — avp-read product includes EForms Read API. Required for get_notice_full tool.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto Aimiten bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 32742 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 9 % der anderen 32742 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 32742 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Hilma MCP sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: HILMA_API_KEY, HILMA_READ_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (1.1.1) kam vor 6 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, Asset Notation

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten

Installieren

Remote Desktop Commander

von desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Läuft in der Cloud★ 211Aktualisiert vorgestern

Installieren

Asset Notation

von assetnotation

Read and maintain an Asset Notation file on disk: net worth, holdings, valuations, CSV import.

Läuft auf deinem ComputerAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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:

Mene osoitteeseen https://hns-hilma-prod-apim.developer.azure-api.net/
Rekisteröidy tai kirjaudu → Products → avp-read → Subscribe
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:

Käyttöjärjestelmä	Polku
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

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ä.

Rekisteröidy ilmaiseksi: https://hns-hilma-prod-apim.developer.azure-api.net/
Lisää avain .env-tiedostoon (suositeltu):

   HILMA_API_KEY=oma-avaimesi-tähän

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

Työkalu	Kuvaus	Vaatii
`search_notices`	Hae ilmoituksia CPV-koodeilla, hakusanalla, päivämäärällä	HILMA_API_KEY
`get_notice_summary`	Yksittäisen ilmoituksen metatiedot noticeId:llä	HILMA_API_KEY
`get_expiring_soon`	Ilmoitukset joiden deadline on N päivän sisällä	HILMA_API_KEY
`get_notice_full`	Täysi eForms XML + yhteystiedot (BT-502/503/506)	HILMA_READ_API_KEY

`search_notices` — Hankintailmoitusten haku

Parametri	Tyyppi	Kuvaus
`search`	string	Vapaatekstihaku. `"*"` = kaikki.
`cpv_codes`	string[]	CPV-koodit, esim. `["71200000", "72000000"]`. OR-logiikka.
`notice_type`	string	`ContractNotices` / `ContractAwardNotices` / `PlanNotices`
`procurement_type`	string	`services` / `works` / `supplies`
`procedure_type`	string	`open` / `restricted` / `negotiated`
`days`	number	Viimeiset N päivää
`hours`	number	Viimeiset N tuntia
`top`	number	Max tuloksia (1–100, oletus 20)

`get_notice_summary` — Yksittäisen ilmoituksen yhteenveto

Parametri	Tyyppi	Kuvaus
`notice_id`	number	Ilmoituksen numeerinen ID

Käyttää search-APIa — ei vaadi erillistä tilausta. Palauttaa kaikki metatiedot: tilaaja, deadline, arvo, CPV, portaali-URL.

`get_expiring_soon` — Lähestyvät deadlinet

Parametri	Tyyppi	Kuvaus
`days`	number	Hae deadlinet seuraavan N päivän sisällä
`cpv_codes`	string[]	Rajaa CPV-koodeilla (valinnainen)

Järjestää tulokset deadlinen mukaan nousevaan järjestykseen.

`get_notice_full` — Täydet tiedot eForms XML:stä

Parametri	Tyyppi	Kuvaus
`notice_id`	number	Ilmoituksen numeerinen ID

Vaatii HILMA_READ_API_KEY (sama avain kuin HILMA_API_KEY — sisältyy avp-read-tilaukseen). Palauttaa:

Yhteystiedot: BT-502 (nimi), BT-503 (sähköposti), BT-506 (puhelin)
Tarjousportaalin URL:t
Koko eForms XML -raakadata

API-viite

Perustuu viralliseen Hilma API -dokumentaatioon.

Hakuendpoint: POST https://api.hankintailmoitukset.fi/avp/eformnotices/docs/search
Yksittäinen ilmoitus: GET https://api.hankintailmoitukset.fi/avp/eformnotices/docs/{noticeId}
Autentikointi: Ocp-Apim-Subscription-Key -header

English

Quick install

git clone https://github.com/Aimiten/hilma-mcp.git

cd hilma-mcp npm install && npm run build cp .env.example .env # then add your API key to .env

Get a free API key at: https://hns-hilma-prod-apim.developer.azure-api.net/

Add to Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

"mcpServers": { "hilma": { "command": "node", "args": ["/absolute/path/to/hilma-mcp/dist/index.js"] } } }

Restart Claude. The Hilma connector will appear in the connectors list.

Lisenssi / License

MIT — ks. LICENSE.

Aimiten

Tämä MCP-serveri on toteutettu osana [Aimitenin](https://aimiten.fi) AI-konsultointia. Aimiten Oy auttaa keskisuuria ja suuria yrityksiä ja organisaatioita ottamaan tekoälyn (Claude, Copilot, Gemini, n8n) käyttöön: koulutus, konsultointi ja käyttöönotot.

🌐 Verkkosivu: aimiten.fi
📖 Claude Code -opas (suomeksi): aimiten.fi/oppaat/claude-ai
🛠️ MCP-palvelimet & integraatiot: aimiten.fi/palvelut
👤 Tekijät: Sampsa Sironen (CEO) + Ville Grönlund (Co-Founder)

This MCP server is built and maintained by [Aimiten](https://aimiten.fi), a Finnish AI consultancy for mid-sized and large companies and organizations, specializing in Claude, Copilot and Gemini.

Hilma MCP

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

Asset Notation

README vom Entwickler

hilma-mcp

Vaatimukset

Asennus

1. Kloonaa repo

2. Asenna riippuvuudet ja buildaa

3. Luo .env-tiedosto

4. Lisää Claude-konfiguraatioon

4. Käynnistä Claude uudelleen

API-avain

Työkalut

search_notices — Hankintailmoitusten haku

get_notice_summary — Yksittäisen ilmoituksen yhteenveto

get_expiring_soon — Lähestyvät deadlinet

get_notice_full — Täydet tiedot eForms XML:stä

API-viite

English

Quick install

Lisenssi / License

Aimiten

`search_notices` — Hankintailmoitusten haku

`get_notice_summary` — Yksittäisen ilmoituksen yhteenveto

`get_expiring_soon` — Lähestyvät deadlinet

`get_notice_full` — Täydet tiedot eForms XML:stä