Skip to content

Quick Start: National Tenders

Get started searching below-threshold procurement tenders in under 5 minutes.

Step 1: Connect to the Server

Claude Desktop

Add the following to your Claude Desktop MCP configuration:

{
    "mcpServers": {
        "national_tenders": {
            "url": "https://national-tenders.lexsocket.ai/"
        }
    }
}

Direct API (cURL)

curl -X POST https://national-tenders.lexsocket.ai/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
        "name": "search_tenders",
        "arguments": {
            "query": "IT services",
            "country": "FR",
            "limit": 5
        }
    },
    "id": 1
  }'

Search across all countries

{
    "method": "search_tenders",
    "params": {
        "query": "software development",
        "limit": 5
    }
}

Search a specific country

{
    "method": "search_france_tenders",
    "params": {
        "query": "développement logiciel",
        "status": "active"
    }
}

{
    "method": "search_uk_tenders",
    "params": {
        "query": "software development",
        "status": "active"
    }
}

{
    "method": "search_tenders",
    "params": {
        "query": "software development",
        "country": "DE",
        "status": "active"
    }
}

Step 3: Explore Opportunities

Browse upcoming deadlines

{
    "method": "browse_by_deadline",
    "params": {
        "country": "FR",
        "limit": 10
    }
}

Find open opportunities

{
    "method": "get_open_opportunities",
    "params": {
        "query": "construction",
        "country": "GB"
    }
}

Search by sector (CPV code)

{
    "method": "search_by_cpv",
    "params": {
        "cpv_code": "72000000",
        "query": "cloud services"
    }
}

Common CPV codes:

CPV Code Sector
45000000 Construction work
72000000 IT services
71000000 Architectural & engineering services
79000000 Business services
33000000 Medical equipment
34000000 Transport equipment
50000000 Repair & maintenance

Search by region (NUTS code)

{
    "method": "search_by_nuts",
    "params": {
        "nuts_code": "FR10",
        "query": "consulting"
    }
}

NUTS code examples:

NUTS Code Region
FR All France
FR10 Ile-de-France
UKI London
DE300 Berlin
ES300 Madrid
NL329 Utrecht

Filter by contract value

{
    "method": "search_by_value_range",
    "params": {
        "min_value": 50000,
        "max_value": 200000,
        "currency": "EUR",
        "query": "consulting services"
    }
}

Search by buyer

{
    "method": "search_by_buyer",
    "params": {
        "buyer_name": "Mairie de Paris",
        "country": "FR"
    }
}

Find similar tenders

Once you find an interesting tender, discover related opportunities:

{
    "method": "find_similar_tenders",
    "params": {
        "tender_id": "FR-24-0054321",
        "limit": 5,
        "country": "FR"
    }
}

Step 5: Get Statistics

Database overview

{
    "method": "get_stats",
    "params": {}
}

{
    "method": "get_tender_statistics",
    "params": {
        "group_by": "country"
    }
}

Group by options: country, status, source, currency, nuts_code_main

Next Steps