Prozorro

This MCP server lets AI models access Ukrainian government procurement data from Prozorro in a secure, programmable way. You can query tenders, integrate search capabilities into your workflows, and run the server locally or in your environment to power AI-assisted procurement activities.

How to use

To use the Prozorro MCP server with an MCP client, run the local MCP server and point your client at the configured endpoint. You will authenticate with an API token and connect to the Prozorro service URL provided for MCP access. Once connected, you can perform tender searches using the available function and then process the returned tender data within your AI workflows.

How to install

Prerequisites you need before installation: a supported Node.js environment and npm. Ensure Node.js version 18 or higher is available.

# Method 1: Install from npm (Recommended)
npm install -g prozorro-mcp-server

# Configure in Claude Desktop
# 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"
      }
    }
  }
}

# Method 2: Install from GitHub
npm install -g git+https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server.git

# Add to Claude Desktop configuration (same format as above)

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

# Method 3: Local Development Installation

# Clone and install
git clone https://github.com/VladyslavMykhailyshyn/prozorro-mcp-server.git
cd prozorro-mcp-server

# Install dependencies
npm install

# Build the project (if applicable)
npm run build

# Add to Claude Desktop configuration (absolute path to built index.js)
{
  "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"
      }
    }
  }
}

Repeat the relevant method to suit your environment. After setting up, restart Claude Desktop to enable the server.

## Configuration

To run the Prozorro MCP server, you must provide two environment variables: the API token and the service URL for the Prozorro API.

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

```env
PROZORRO_API_TOKEN=Bearer your-token-here
PROZORRO_SERVICE_URL=https://mcp-service-url-here
```" ,

Troubleshooting

If the server does not appear in your MCP client, verify the path to the configuration, ensure the server was built if required, confirm Node.js is installed (version 18 or higher), and restart the client. Check logs for errors and confirm the API token and service URL are correct and active.

Development

Project structure typically includes a source directory with the main entry point and tender search logic. Build and run commands follow standard Node.js project conventions.

# Development workflow
npm run dev

# In another terminal
npm start

# Production build
npm run build

API usage and data

This MCP server connects to the Prozorro public API to retrieve tender information. Data is returned as JSON with details such as tender identifiers, titles, organizations, dates, and procurement status.

License

ISC

Notes

The server requires a valid API token and URL for Prozorro. If you need credentials, contact the project maintainer to obtain access details and the correct endpoint.

Available tools

search_tenders

Searches for government tenders by EDRPOU code, legal name, and date ranges with optional limits. Returns detailed tender objects including IDs, titles, organization details, dates, and status.