MCP 服务器

rhr-mcp

MCP server that gives AI agents structured access to Public Procurement Registry data, allowing natural language queries for planned procurements, open tenders, contract awards, buyers, and winning suppliers.

README

RHR MCP

MCP server that gives AI agents structured access to Public Procurement Registry data. Query procurements, awards, buyers, and winning suppliers using natural language through any MCP-compatible client.

Tech Stack

Runtime — Bun >= 1.4.0
Language — TypeScript 7
Database — PostgreSQL
Query builder — Kysely
Validation — Zod
Tooling — Oxfmt and Oxlint

Prerequisites

Bun >= 1.4.0
Docker (for PostgreSQL)

Download open data

Download the public datasets from:

https://riigihanked.riik.ee/rhr-web/#/open-data

Place the unzipped files directly in the data/ folder at the project root. For example, a full year looks like:

HT_2025_1.xml
HT_2025_2.xml
HT_2025_3.xml
HT_2025_4.xml
HT_2025_5.xml
HT_2025_6.xml
HT_2025_7.xml
HT_2025_8.xml
HT_2025_9.xml
HT_2025_10.xml
HT_2025_11.xml
HT_2025_12.xml
HLST_2025_1.xml
HLST_2025_2.xml
HLST_2025_3.xml
HLST_2025_4.xml
HLST_2025_5.xml
HLST_2025_6.xml
HLST_2025_7.xml
HLST_2025_8.xml
HLST_2025_9.xml
HLST_2025_10.xml
HLST_2025_11.xml
HLST_2025_12.xml

HT_*.xml files are contract notices. HLST_*.xml files are contract award notices. Add any year the same way (HT_2024_1.xml, HT_2027_1.xml, and so on) — ingest picks up every matching file in data/.

Getting Started

git clone https://github.com/margusliinev/rhr-mcp.git
cd rhr-mcp
cp .env.example .env
bun install
docker compose up -d
bun run migrate
bun run ingest
bun run dev

The MCP endpoint is available at http://localhost:3002/mcp.

Use with Cursor

With the server running, add this to your Cursor MCP config (.cursor/mcp.json):

{
    "mcpServers": {
        "RHR": {
            "url": "http://localhost:3002/mcp"
        }
    }
}

Then restart MCP / reload Cursor so the RHR server shows up.

Available tools

Tool	Description
`get-organization`	Get an organization by id or registry code
`get-procurement`	Get a procurement with buyers, lots, and award summaries
`get-award`	Get an award with suppliers, lot, and procurement summary
`list-organization-procurements`	List procurements where an organization is a buyer
`list-organization-awards`	List awards where an organization is a winning supplier
`list-procurement-lots`	List lots for a procurement, with award summaries linked by lot id
`search-organizations`	Search organizations by name or registry code
`search-procurements`	Search and filter procurements by text, status, CPV, value, and more
`search-awards`	Search awards by amount, date, CPV, result, and supplier

Scripts

Command	Description
`bun run dev`	Start development server
`bun run start`	Start production server
`bun run migrate`	Apply database migrations
`bun run ingest`	Load RHR data from `data/` into Postgres
`bun run format`	Format code
`bun run lint`	Lint code
`bun run typecheck`	Typecheck