Hilma MCP Server
by aimitenio.github.Aimiten/hilma-mcpv1.1.1
MCP server for Finnish public procurement notices (Hilma). Built by Aimiten.
context tax
queued
security
queued
cold start
queued
freshness
Slowing5mo ago
Install Hilma MCP server
Install in Claude Code
claude mcp add hilma -e HILMA_API_KEY='<hilma-api-key>' -e HILMA_READ_API_KEY='<hilma-read-api-key>' -- npx -y hilma-mcpInstall in Cursor
{
"mcpServers": {
"hilma": {
"command": "npx",
"args": [
"-y",
"hilma-mcp"
],
"env": {
"HILMA_API_KEY": "<hilma-api-key>",
"HILMA_READ_API_KEY": "<hilma-read-api-key>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).
Install in Claude Desktop
{
"mcpServers": {
"hilma": {
"command": "npx",
"args": [
"-y",
"hilma-mcp"
],
"env": {
"HILMA_API_KEY": "<hilma-api-key>",
"HILMA_READ_API_KEY": "<hilma-read-api-key>"
}
}
}
}Settings → Developer → Edit Config (claude_desktop_config.json), then restart.
Install in VS Code
{
"servers": {
"hilma": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hilma-mcp"
],
"env": {
"HILMA_API_KEY": "<hilma-api-key>",
"HILMA_READ_API_KEY": "<hilma-read-api-key>"
}
}
}
}Add to .vscode/mcp.json in your workspace.
Install in Windsurf
{
"mcpServers": {
"hilma": {
"command": "npx",
"args": [
"-y",
"hilma-mcp"
],
"env": {
"HILMA_API_KEY": "<hilma-api-key>",
"HILMA_READ_API_KEY": "<hilma-read-api-key>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json.
Configuration
| Variable | Required | Secret | Description |
|---|---|---|---|
| HILMA_API_KEY | yes | yes | Hilma APIM avp-read subscription key. Get a free key at https://hns-hilma-prod-apim.developer.azure-api.net/ |
| HILMA_READ_API_KEY | yes | yes | Same as HILMA_API_KEY — avp-read product includes EForms Read API. Required for get_notice_full tool. |
Freshness
Slowing — last maintenance signal 5mo ago. The newest of the signals below sets the band.
Last commit (default branch)
2026-05-15 · 5mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-05-15 · 5mo ago · official registry · v1.1.1
FAQ
›How do I install the Hilma MCP server in Claude Code?
Run: claude mcp add hilma -e HILMA_API_KEY='<hilma-api-key>' -e HILMA_READ_API_KEY='<hilma-read-api-key>' -- npx -y hilma-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.
›Does Hilma require an API key?
Yes. It expects HILMA_API_KEY, HILMA_READ_API_KEY, of which 2 are secrets.
›Can I use Hilma as a remote (hosted) MCP server?
No hosted endpoint is published; it runs locally over stdio.
›Is Hilma in the official MCP registry?
Yes, as io.github.Aimiten/hilma-mcp.