Hilma

Name: Hilma MCP Server
Author: Aimiten

stdio

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

Getting Started

npx @getmcp/cli add io.github.Aimiten/hilma-mcp

Requires Node.js 18+. Community-contributed server. Review source before installing.

Claude Desktopguide →Vscodeguide →Cursorguide →Windsurfguide →

Required Environment Variables

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

Configuration

Config file: ~/Library/Application Support/Claude/claude_desktop_config.json

JSON

{
  "mcpServers": {
    "io.github.Aimiten/hilma-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "hilma-mcp"
      ],
      "env": {
        "HILMA_API_KEY": "",
        "HILMA_READ_API_KEY": ""
      }
    }
  }
}

Claude Desktop MCP documentation