Greek Procurement MCP Server

This MCP server provides integration with the Greek public procurement system (ΚΗΜΔΗΣ) through their OpenData API.

Features

• Search procurement requests, notices, awards, and contracts
• Retrieve PDF documents for specific ADAM reference numbers
• Analyze market opportunities based on CPV codes and budget ranges
• Real-time access to Greek public procurement data

Installation

1. Install dependencies:

npm install

2. Start the server:

npm start

Usage with Claude Desktop

Add this to your Claude Desktop configuration file:

{
  "mcpServers": {
    "greek-procurement": {
      "command": "node",
      "args": ["F:\\MCP servers\\greek-procurement\\server.js"],
      "cwd": "F:\\MCP servers\\greek-procurement"
    }
  }
}

Available Tools

search_requests

Search procurement requests in the ΚΗΜΔΗΣ system.

Parameters:

• title (string): Title to search for
• cpvItems (array): CPV codes (format: 12345678-9)
• organizations (array): Organization codes
• contractType (string): Contract type (9=Services, 10=Works, 12=Studies, 13=Supplies, 14=Technical Services)
• dateFrom (string): Start date (YYYY-MM-DD)
• dateTo (string): End date (YYYY-MM-DD)
• totalCostFrom (integer): Minimum cost without VAT
• totalCostTo (integer): Maximum cost without VAT
• page (integer): Page number

search_notices

Search procurement notices/announcements.

Parameters:

• Similar to search_requests plus:
• finalDateFrom (string): Submission deadline from (YYYY-MM-DD HH:mm)
• finalDateTo (string): Submission deadline to (YYYY-MM-DD HH:mm)
• procedureType (string): Procedure type
• isModified (boolean): Search only modifications

search_awards

Search contract awards.

Parameters:

• Similar to search_requests plus:
• vatNumber (string): Contractor VAT number
• contractorName (string): Contractor name

search_contracts

Search final contracts.

get_pdf_document

Download PDF document for a specific ADAM reference number.

Parameters:

• referenceNumber (string): ADAM reference number
• documentType (string): Type of document (request, notice, award, contract)

analyze_market_opportunities

Analyze market opportunities based on CPV codes and budget ranges.

Parameters:

• cpvCodes (array): CPV codes to analyze
• minBudget (integer): Minimum budget
• maxBudget (integer): Maximum budget
• daysAhead (integer): Days to look ahead for opportunities

Contract Types

• 9: Services (Υπηρεσίες)
• 10: Works (Έργα)
• 12: Studies (Μελέτες)
• 13: Supplies (Προμήθειες)
• 14: Technical Services (Τεχνικές ή λοιπές συναφείς Υπηρεσίες)

Example Usage

// Search for IT services contracts
{
  "cpvItems": ["72000000-5", "48000000-8"],
  "contractType": "9",
  "totalCostFrom": 10000,
  "totalCostTo": 500000,
  "dateFrom": "2024-01-01",
  "dateTo": "2024-12-31"
}

API Rate Limits

The ΚΗΜΔΗΣ API updates daily. Be mindful of rate limits and cache results when possible.

Support

For issues with the Greek Procurement API, refer to: https://cerpp.eprocurement.gov.gr/khmdhs-opendata/help