hilma_search
ActiveTool of Hilma
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 schema
{
"type": "object",
"properties": {
"top": {
"type": [
"number",
"string"
],
"description": "Number of notices to return (1–100). Default 10."
},
"skip": {
"type": [
"number",
"string"
],
"description": "Result offset for pagination. Default 0."
},
"query": {
"type": "string",
"description": "Free-text search, e.g. \"siivous\", \"IT-konsultointi\", \"rakentaminen\". Finnish terms match best. Omit to list the latest notices."
},
"filter": {
"type": "string",
"description": "Raw OData $filter passthrough, ANDed with the friendly filters, e.g. \"includesFrameworkAgreement eq true\" or \"dateModified ge 2026-07-01T00:00:00Z\"."
},
"_apiKey": {
"type": "string",
"description": "Optional Hilma AVP subscription key. Free key: sign up at https://hns-hilma-prod-apim.developer.azure-api.net (Products → avp-read → Subscribe)."
},
"orderby": {
"type": "string",
"description": "OData $orderby, e.g. \"datePublished desc\" (default), \"dateModified desc\", \"organisationName asc\"."
},
"cpv_code": {
"type": "string",
"description": "CPV code to filter by, e.g. \"45000000\" (construction), \"72000000\" (IT services). 8-digit code; a \"-N\" check-digit suffix is stripped."
},
"plans_only": {
"type": "boolean",
"description": "true → only procurement plans / advance-planning entries (isPlan eq true)."
},
"organisation": {
"type": "string",
"description": "Buyer organisation name to search for, e.g. \"Helsinki\", \"Väylävirasto\", \"Espoon kaupunki\". Matched against organisationName."
},
"exclude_plans": {
"type": "boolean",
"description": "true → published notices only, procurement plans filtered out (isPlan eq false)."
},
"national_only": {
"type": "boolean",
"description": "true → only national (below-EU-threshold) procurement notices (isNationalProcurement eq true)."
},
"published_since": {
"type": "string",
"description": "Only notices published on or after this date. \"YYYY-MM-DD\" or full ISO timestamp, e.g. \"2026-07-01\"."
},
"published_until": {
"type": "string",
"description": "Only notices published on or before this date. \"YYYY-MM-DD\" or full ISO timestamp."
}
}
}No endpoints wrapped at confidence ≥ 0.50.
Parent server
Hilma
https://github.com/pipeworx-io/mcp-hilma
1/7 registries