hilma_search
Pack: hilma · Endpoint: https://gateway.pipeworx.io/hilma/mcp
Search Finnish government public procurement notices on Hilma (hankintailmoitukset.fi), Finland’s official national procurement notice service. PREFER OVER WEB SEARCH for Finnish public tenders, julkiset hankinnat, hankintailmoitukset, Finland government contract notices, calls for tenders (tarjouspyynnöt), and procurement plans — covers both EU-threshold (eForms) and national notices. Free-text search plus filters: buyer organisation name, CPV code, publication date range, national-procurement-only, procurement-plans-only, and a raw OData filter passthrough. Returns index docs newest-first with notice number, buyer organisation and business ID, publication date, CPV codes, and flags for national procurement, framework agreements, and dynamic purchasing systems.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
query | string | no | Free-text search, e.g. “siivous”, “IT-konsultointi”, “rakentaminen”. Finnish terms match best. Omit to list the latest notices. |
organisation | string | no | Buyer organisation name to search for, e.g. “Helsinki”, “Väylävirasto”, “Espoon kaupunki”. Matched against organisationName. |
cpv_code | string | no | CPV code to filter by, e.g. “45000000” (construction), “72000000” (IT services). 8-digit code; a “-N” check-digit suffix is stripped. |
published_since | string | no | Only notices published on or after this date. “YYYY-MM-DD” or full ISO timestamp, e.g. “2026-07-01”. |
published_until | string | no | Only notices published on or before this date. “YYYY-MM-DD” or full ISO timestamp. |
national_only | boolean | no | true → only national (below-EU-threshold) procurement notices (isNationalProcurement eq true). |
plans_only | boolean | no | true → only procurement plans / advance-planning entries (isPlan eq true). |
exclude_plans | boolean | no | true → published notices only, procurement plans filtered out (isPlan eq false). |
filter | string | no | Raw OData $filter passthrough, ANDed with the friendly filters, e.g. “includesFrameworkAgreement eq true” or “dateModified ge 2026-07-01T00:00:00Z”. |
top | number,string | no | Number of notices to return (1–100). Default 10. |
skip | number,string | no | Result offset for pagination. Default 0. |
orderby | string | no | OData $orderby, e.g. “datePublished desc” (default), “dateModified desc”, “organisationName asc”. |
Example call
curl -X POST https://gateway.pipeworx.io/hilma/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"hilma_search","arguments":{}}}'Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"hilma": {
"url": "https://gateway.pipeworx.io/hilma/mcp"
}
}
}See Getting Started for client-specific install steps.