prozorro

Prozorro MCP Server provides AI-model access to Ukrainian government procurement data via the Prozorro public procurement system. The server exposes a focused tool named search_tenders, which enables you to query tenders using criteria such as EDRPOUCode, organization legal name, and date ranges. Currently, data availability is indicated for 2025, with results returning tender objects that include details like tender ID, title, organization information, dates, and procurement status. To use the server, run the MCP server binary (typically installed globally as prozorro-mcp-server) and configure Claude Desktop or your MCP client to point at the server, supplying required environment variables such as your Prozorro API token and service URL. The client will then be able to invoke search_tenders to retrieve tender data and pass it to your AI models for downstream processing.

Prerequisites:\n- Node.js (recommended LTS, e.g., v18+) and npm installed on your system\n- Internet access to install packages or clone the repository\n- Optional: Git if you plan to clone from GitHub\n\nInstallation steps:\n1) Install globally via npm (recommended):\n\nbash\nnpm install -g prozorro-mcp-server\n\n2) Add to Claude Desktop configuration (example):\n\nWindows: %APPDATA%\Claude\claude_desktop_config.json\nmacOS: ~/Library/Application Support/Claude/claude_desktop_config.json\nLinux: ~/.config/Claude/claude_desktop_config.json\n\njson\n{\n "mcpServers": {\n "prozorro": {\n "command": "prozorro-mcp-server",\n "env": {\n "PROZORRO_API_TOKEN": "your-api-token-here",\n "PROZORRO_SERVICE_URL": "mcp-api-url-here"\n }\n }\n }\n}\n\n3) For local development from GitHub:\n\nbash\ngit clone https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server.git\ncd prozorro-mcp-server\nnpm install\nnpm run build\n\n4) Run the server (if using local build):\n\nbash\nnode build/index.js\n\n5) Ensure environment variables are set in your MCP client configuration, for example:\n\njson\n{\n "mcpServers": {\n "prozorro": {\n "command": "prozorro-mcp-server",\n "env": {\n "PROZORRO_API_TOKEN": "your-api-token-here",\n "PROZORRO_SERVICE_URL": "https://prozorro.gov.ua"\n }\n }\n }\n}\n

Tips and notes:\n- The server requires a valid Prozorro API token and service URL. These should be provided to your MCP client (e.g., Claude Desktop) via environment variables as shown in the configuration examples.\n- If you encounter permission issues when installing globally on Linux/macOS, consider using sudo or configuring npm to use a user directory.\n- The search_tenders tool is designed to filter tenders by EDRPOUCode, legalName, dateFrom, dateTo, and limit. Ensure date formats are ISO 8601.\n- The Prozorro API may have rate limits; implement request pacing in your integration if needed.\n- When running locally, ensure you build the project before starting the server (npm run build).\n- If the server is not appearing in Claude Desktop, verify the path and that the server process is running, and check Node.js version compatibility (as required by your setup).