Prozorro MCP Server

A Model Context Protocol (MCP) server that provides AI models with seamless access to Ukrainian government procurement data from Prozorro - Ukraine's public procurement system.

❗❗❗ Providing all the available features requires to have a proxy server and database, so right now MCP API is not available publicly. To get API URL and API token, please contact the author.

Features

• 🔍 Search Tenders: Advanced search capabilities by EDRPOU code, legal name, tenderer/supplier name, or date ranges
• ↕️ Server-side Sorting: Sort results by amount or last-modified date, so "biggest"/"latest" queries return the actual top results, not an arbitrary page
• 📄 Pagination: Page through result sets larger than 100 rows via offset
• ⚡ Fast: Direct API integration with Prozorro's public procurement database
• 🛠️ Easy Integration: Simple setup with Claude Desktop and other MCP clients

Available Tools

search_tenders

Searches for government tenders based on various criteria (Right now data are available only for 2025 year).

Parameters:

• EDRPOUCode (string, optional): The unique identifier code of the procuring organization (Ukrainian tax ID)
• legalName (string, optional): A substring to match against the procuring organization's legal name
• tendererName (string, optional): A substring to match against the tenderer/supplier/bidder's name (not the procuring entity). Use this to find individual entrepreneurs (FOPs) as bidders — see Known Limitations below.
• dateFrom (string, optional): Start date for the search (ISO 8601 format, e.g., 2025-01-01)
• dateTo (string, optional): End date for the search (ISO 8601 format, e.g., 2025-12-31)
• sortBy (string, optional): One of amount_desc, amount_asc, dateModified_desc, dateModified_asc. Sorting is applied server-side across the full matching dataset before pagination, so e.g. amount_desc reliably returns the biggest tenders even if there are thousands of matches.
• offset (number, optional): Number of records to skip, for paging beyond the first limit results (default: 0)
• includeTotal (boolean, optional): If true, the response includes total_count — the true total number of matching results across all pages. Costs an extra query server-side, so it's opt-in; omit it for routine paging (default: false)
• limit (number, optional): Maximum number of records to return per page (default: 100, max: 100 — the server hard-caps at 100 regardless of the value requested; use offset to fetch additional pages)

Returns: An object with data (array of tender objects with detailed information including tender ID, title, organization details, dates, and procurement status), plus count (rows in this page), total_count (true total matching the filters across all pages — null unless includeTotal was set), limit_applied, offset_applied, and sort_applied.

Known Limitations

• Individual entrepreneurs (FOP): Prozorro's public data source masks individual-entrepreneur identifier IDs (EDRPOU-style codes) to 0000000000 for privacy. This means EDRPOUCode/tenderer-ID-based search does not reliably find FOPs. Use tendererName (substring match) instead — FOPs almost always appear as bidders/suppliers (tenderers), not as the procuring entity.

Installation

Method 1: Install from npm (Recommended)

The easiest way to install the MCP server is via npm:

npm install -g prozorro-mcp-server

After installation, add to Claude Desktop configuration:

Windows: %APPDATA%\Claude\claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "prozorro": {
      "command": "prozorro-mcp-server",
      "env": {
        "PROZORRO_API_TOKEN": "your-api-token-here",
        "PROZORRO_SERVICE_URL":

... [View full README on GitHub](https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server#readme)