Hilma FAQs

Question 1

Is an API key required to use Hilma?

Accepted Answer

Yes, Hilma requires a Hilma AVP API key for secure and authorized access to the procurement data. This key is free and can be obtained by registering on the Hilma API developer portal and subscribing to the 'avp-read' product.

Question 2

What is Hilma?

Accepted Answer

Hilma is a tool that integrates Finnish public procurement notices (from hankintailmoitukset.fi) directly into Claude AI assistants. It functions as an MCP (Model Context Protocol) server, enabling users to search, retrieve, and analyze procurement data without leaving their AI environment.

Question 3

What types of procurement information can I access with Hilma?

Accepted Answer

You can search for notices using CPV codes, keywords, and date ranges; retrieve concise metadata summaries; identify notices with deadlines approaching soon; and access the full eForms XML raw data, including detailed contact information, for any specific notice.

Question 4

How do I integrate Hilma with my Claude AI assistant?

Accepted Answer

After cloning the Hilma repository and installing its dependencies, you need to add your Hilma API key to a .env file. Then, configure your Claude Desktop or Claude Cowork's `mcpServers` settings with the absolute path to Hilma's executable. Restart Claude, and Hilma will appear as a connector.

Question 5

Can Hilma help me track procurement deadlines?

Accepted Answer

Absolutely. Hilma includes a feature (`get_expiring_soon`) that allows you to identify and list all procurement notices with deadlines approaching within a specified number of days, optionally filtered by CPV codes, helping you stay informed on critical opportunities.

Hilma

Hilma

Key Features

Use Cases

Key Features

Use Cases