Prozorro.Sale MCP Server

Prozorro.Sale MCP Server

Read-only MCP server for Prozorro.Sale, the Ukrainian state platformthat auctions public assets — small and large privatisation, land sale and rental, propertylease, timber, subsoil, arrested and bankruptcy assets, sanctioned assets and non-performingloans.

The tools are organised around what people actually ask, not around HTTP endpoints. There isno GET /procedures/{id}/documents/{doc_id}/history tool; there is "show me the documents forthis auction". Nothing writes: no bids are placed, no procedures are created or modified.

Tools

Every tool accepts the public auction id printed on the website(LRE001-UA-20260708-03894) as well as the internal 24-character procedure id.

Tool reference

search_auctions

Entry point for any "what is available" question.

// Property lease near Lviv, still open, under 50 000 UAH
{"procedure_type": ["legitimatePropertyLease"], "open_for_bids": true,
 "region": "Львів", "max_value": 50000, "limit": 10}

// Everything privatisation-related that concluded in July 2026
{"procedure_type": ["smallPrivatization", "largePrivatization"], "status": ["complete"],
 "changed_since": "2026-07-01", "changed_until": "2026-07-31", "scan_pages": 25}

Returns compact summaries plus a scanned block. An empty result means "not in the scannedwindow", never "does not exist".

Owner vs seller

On the legitimatePropertyLease family the two roles are different organisations. A room in auniversity building is auctioned by the regional SPFU office, so the university appears aspropertyOwner (балансоутримувач) and never as seller. Filtering by seller for an institutionreturns nothing at all.

// Everything Lviv Polytechnic put up for lease this year — EDRPOU is exact, prefer it to a name
{"procedure_type": ["legitimatePropertyLease"], "property_owner_edrpou": "02071010",
 "changed_since": "2026-01-01", "changed_until": "2026-08-06", "scan_pages": 40}

Only that family publishes the distinction; for every other programme relatedOrganizations isabsent, the seller owns what it sells, and property_owner matches nothing. There is no silentfallback to text search — combine with keyword if you need one.

get_auction

Everything about one auction. For deadlines alone use get_auction_timeline; for the outcomealone use get_auction_results — both return far less.

include values: items (area, cadastral number, address, classification) · terms(starting price, minimal step, guarantee deposit, registration fee, lease duration, conditions,restrictions) · documents · questions · bids · awards · contracts.

// Full picture before deciding whether to bid
{"auction": "SPD001-UA-20260806-70620",
 "include": ["items", "terms", "documents", "questions"]}

// Minimal lookup
{"auction": "LRE001-UA-20260708-03894"}

get_auction_timeline

The stage clock: what has passed, what is running, what is next, how long is left to bid.

{"auction": "LRE001-UA-20260708-03894"}
{"auction": "LRE001-UA-20260708-03894", "include_revisions": true}

Returns the status with its plain-language meaning, every stage markedpast/current/upcoming, the next deadline, and bidding.closesAt / stillOpen /hoursRemaining.

get_auction_results

How an auction ended. Works on in-progress auctions too — reports outcome: "in_progress".

{"auction": "SPE001-UA-20260729-69703"}

Returns outcome (contract_signed · winner_determined · ended_without_winner ·cancelled_by_seller · in_progress), starting vs final price with priceUpliftPercent, bidcounts, attemptNumber (>1 means the lot failed to sell before), awards, contracts andcancellation reasons.

get_auction_documents

Published files with direct public download URLs.

// Just the technical specification
{"auction": "SPD001-UA-20260806-70620", "document_type": "technicalSpecifications"}

// The complete paper trail including the signed contract
{"auction": "SPD001-UA-20260806-70620",
 "include_attachments_of": ["auction", "awards", "contracts"]}

Documents attached to bids are never published.

find_comparable_auctions

Valuation and risk: what similar lots go for and how often they sell.

// Price benchmark for a land lease (default matching)
{"auction": "LRE001-UA-20260708-03894",
 "match_on": ["sellingMethod", "classification"]}

// What similar assets are on the market right now
{"auction": "SPD001-UA-20260806-70620", "concluded_only": false, "limit": 25}

Re-listings of the same lot are excluded, so one asset is not counted twice.

track_auction_changes

Cursor-based monitoring. Repeated calls make forward progress without re-reading the sameactivity.

// First poll of a niche
{"procedure_type": ["landRental"], "region": "Полтав", "limit": 20}

// Follow-up poll using the cursor from the previous response
{"procedure_type": ["landRental"], "region": "Полтав",
 "since": "2026-08-06T06:27:21.880000Z"}

Each change carries an isNew flag distinguishing brand-new listings from updates. The cursoris inclusive, so the last auction may repeat once.

analyze_auction_market

Volume and trend questions rather than individual lots.

// Which regions had the most land activity recently
{"procedure_type": ["landRental", "landSell"], "group_by": "region", "scan_pages": 25}

// How privatisation performed in July 2026
{"procedure_type": ["smallPrivatization"], "since": "2026-07-01", "until": "2026-07-31",
 "group_by": "sellingMethod", "scan_pages": 30}

Returns count/total/mean/median/min/max starting prices, a status histogram andsoldSharePercentOfSettled — where settled means complete, unsuccessful or cancelledonly, so in-flight procedures do not inflate it. These figures describe the scanned window, notthe whole catalogue.

list_procedure_types

The vocabulary the other tools filter on. Cached; no network cost after the first call. Callthis rather than guessing a procedure_type — an unrecognised value silently returns nothing.

{"filter": "land"}
{}

Returns 33 programme families with their auction formats, the exact sellingMethod values, andthe three-letter auction-id prefix each produces (LRE = landRental-english, SPE =smallPrivatization-english…), plus what each of the ten statuses means.

get_publication_constraints

The only forward-looking tool: if a lot is published today, how soon may the auction run.

{"procedure_type": "landRental-english"}
{"procedure_type": "smallPrivatization"}

Returns earliestAuctionStart and noticeDays. Computed live, so it is not cached.

Install

git clone https://github.com/VladyslavMykhailyshyn/prozorro-sale-mcp-server.git
cd prozorro-sale-mcp-server
npm install
npm run build

Claude Code

claude mcp add prozorro-sale -- node /absolute/path/to/prozorro-sale-mcp-server/build/index.js

Claude Desktop / any MCP client

{
  "mcpServers": {
    "prozorro-sale": {
      "command": "node",
      "args": ["/absolute/path/to/prozorro-sale-mcp-server/build/index.js"]
    }
  }
}

No API key is needed — Prozorro.Sale publishes this data openly.

Configuration

All optional; see .env.example. The variables are read from the process environment, so setthem in your MCP client's env block.

The one limitation worth understanding

Prozorro.Sale publishes no full-catalogue search API. The open-data surface is a changefeed ordered by modification time, plus a per-selling-method feed of the 100 most recentauctions. There is no "all currently open auctions" endpoint to call.

This server therefore searches by scanning, and it is explicit about what it scanned. Everydiscovery tool returns a scanned block:

{
  "scanned": {
    "coveredFrom": "2026-08-06T06:12:41.000Z",
    "coveredTo": "now",
    "recordsScanned": 614,
    "truncated": true,
    "note": "Every auction changed in the last 3h was examined (614 records over 3 segments), then the page budget ran out while reaching further back. Auctions last changed before that are NOT fully represented — raise \"scan_pages\" or set an explicit window to go deeper."
  }
}

Two consequences to keep in mind:

• Name the asset programme when you can. procedure_type: ["smallPrivatization"] makesthe server query the per-type feeds directly, which covers the 100 most recent auctions ofeach matching selling method instead of whatever happened to be busiest platform-wide.
• An empty result means "not in the scanned window", not "does not exist." Widen withscan_pages, or pass changed_since to scan a specific historical period.

The feed only runs forward in time from a cursor, so the newest records always sit at the endof a crawl. Starting at an arbitrary "7 days ago" would spend the whole page budget on oldrecords and never reach the present. Instead the crawler walks a short window ending at nowand then extends backwards in doubling segments while budget remains — so current auctions arealways covered first.

Data notes

• Bidder and buyer identities are redacted upstream and appear as [redacted].
• Document downloadUrl values are public and can be fetched directly.
• Bid amounts become visible only after an auction concludes.
• auctionId encodes its programme and publication date: LRE (landRental-english) + serial
  • -UA- + 20260708 + serial.

Development

npm run typecheck   # tsc --noEmit
npm run build       # compile to build/
npm run smoke       # build, then exercise all 10 tools against the live API

scripts/smoke.mjs is an integration check, not a unit test — it hits productionProzorro.Sale and prints a one-line summary per tool.

License

ISC