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

Related MCP server: simap MCP Server

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": "mcp-api-url-here"
      }
    }
  }
}

Restart Claude Desktop and you're ready to use the server!

Note: On Linux/macOS, if you encounter permission issues, you may need to use sudo npm install -g prozorro-mcp-server or configure npm to use a user directory.

Method 2: Install from GitHub

1. Install globally via npm from GitHub:

npm install -g git+https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server.git

2. Add to Claude Desktop configuration:

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

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

3. Restart Claude Desktop - The server will be ready to use!

Method 3: Local Development Installation

1. Clone the repository:

git clone https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server.git
cd prozorro-mcp-server

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Add to Claude Desktop configuration (use absolute path):

{
  "mcpServers": {
    "prozorro": {
      "command": "node",
      "args": ["/absolute/path/to/prozorro-mcp-server/build/index.js"],
      "env": {
        "PROZORRO_API_TOKEN": "your-api-token-here",
        "PROZORRO_SERVICE_URL": "https://prozorro.gov.ua"
      }
    }
  }
}

Configuration

The server requires specific environment variables to function correctly. You can set these in the Claude Desktop configuration or in a .env file for local development.

Getting API Credentials

To obtain API credentials and URL for Prozorro:

1. Contact the author

2. Retrieve API token and URL

3. Use the token and URL in your configuration

Common Usage Workflows

Workflow 1: Search Tenders by Organization

1. Use search_tenders with EDRPOUCode to find all tenders from a specific organization
2. Review the returned tender details including dates, amounts, and status
3. Filter results by date range if needed

Workflow 2: Find Recent Tenders

1. Use search_tenders with dateFrom and dateTo parameters
2. Optionally filter by organization name using legalName
3. Limit results for better performance

Workflow 3: Find the Biggest or Most Recent Tenders

1. Use search_tenders with sortBy: "amount_desc" to get the biggest tenders by value,
   or sortBy: "dateModified_desc" for the most recently updated tenders
2. Combine with legalName/EDRPOUCode/tendererName/date filters as needed
3. The top results are guaranteed to be the actual top matches, not just an
   arbitrary page of the full result set

Workflow 4: Paginate Through Large Result Sets

1. Call search_tenders with limit: 100 and offset: 0
2. Repeat the call with the same filters/sortBy, increasing offset by 100 each
   time, until a page comes back with fewer than 100 results
3. If you need to know the total number of matches upfront (e.g. to answer
   "how many tenders in total"), pass includeTotal: true and read total_count
   from the response — leave it off for routine paging, since it costs an
   extra query

Troubleshooting

Server not appearing in Claude Desktop

1. Check that the path in claude_desktop_config.json is correct

2. Ensure you've built the project with npm run build

3. Verify that Node.js is installed (version 18 or higher required)

4. Restart Claude Desktop

5. Check Claude Desktop logs for errors

API Request Failures

• Verify your PROZORRO_API_TOKEN is valid and not expired

• Check that PROZORRO_SERVICE_URL is correct

• The Prozorro API may have rate limits - consider adding delays between requests

• Network connectivity to prozorro.gov.ua is required

• Some tenders might be temporarily unavailable

Authentication Errors

• Ensure your API token includes the Bearer prefix if required

• Check that your token has the necessary permissions

• Verify the token hasn't expired

Development

Project Structure

prozorro-mcp-server/
├── src/
│   ├── index.ts              # Main MCP server entry point
│   ├── tenders.ts            # Tender search implementation
│   └── types.ts              # TypeScript type definitions
├── build/                    # Compiled JavaScript (generated)
├── package.json
├── tsconfig.json
└── README.md

Running in Development Mode

# Watch mode - auto-rebuild on changes
npm run dev

# In another terminal
npm start

Building for Production

npm run build

API Information

This server uses the Prozorro public API to retrieve tender information. For more details about the Prozorro system and available data:

• Prozorro Website: https://prozorro.gov.ua/

• API Documentation: https://prozorro.gov.ua/api

• Data Format: JSON responses with detailed tender information

License

ISC

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Contact

For issues and questions, please use the GitHub Issues page.

Tool Call Examples

Example search_tenders arguments for common queries.

Find all tenders from a specific organization:

{
  "EDRPOUCode": "21560045"
}

Find tenders by organization name within a date range:

{
  "legalName": "Укрпошта",
  "dateFrom": "2025-01-01",
  "dateTo": "2025-06-30"
}

Find the biggest tenders by value:

{
  "legalName": "Укрпошта",
  "sortBy": "amount_desc",
  "limit": 100
}

Find the most recently updated tenders:

{
  "sortBy": "dateModified_desc",
  "limit": 20
}

Find an individual entrepreneur (FOP) as a bidder/supplier:

{
  "tendererName": "Петренко Іван Іванович"
}

Page through a large result set (second page, 100 rows each):

{
  "legalName": "Укрпошта",
  "sortBy": "amount_desc",
  "limit": 100,
  "offset": 100
}

Get the true total number of matches, not just the current page:

{
  "legalName": "Укрпошта",
  "includeTotal": true
}

Response includes "total_count": 4832 alongside "count" (rows in this page) and "data".