Quick Start: TED MCP Server¶

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

Step 1: Connect to the Server¶

Claude Desktop¶

Add the following to your Claude Desktop MCP configuration:

{
    "mcpServers": {
        "lexsocket": {
            "url": "https://mcp.lexsocket.ai/"
        }
    }
}

Direct API (cURL)¶

curl -X POST https://mcp.lexsocket.ai/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "tools/call",
    "params": {
        "name": "search_ted",
        "arguments": {
            "query": "hospital construction",
            "country": "POL",
            "limit": 5
        }
    },
    "id": 1
  }'

Step 2: Make Your First Search¶

Simple keyword search¶

{
    "method": "search_ted",
    "params": {
        "query": "IT services",
        "limit": 5
    }
}

Search a specific country¶

{
    "method": "search_ted",
    "params": {
        "query": "construction",
        "country": "DEU",
        "limit": 10
    }
}

Step 3: Explore Opportunities¶

Browse upcoming deadlines¶

{
    "method": "browse_tenders_by_deadline",
    "params": {
        "country": "FRA",
        "limit": 10
    }
}

Search by sector (CPV code)¶

{
    "method": "search_ted_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_ted_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

Step 4: Refine Your Search¶

Filter by contract value¶

{
    "method": "search_ted_by_value_range",
    "params": {
        "min_value": 500000,
        "max_value": 5000000,
        "currency": "EUR",
        "query": "engineering services"
    }
}

Search by buyer (contracting authority)¶

{
    "method": "search_ted_by_buyer",
    "params": {
        "buyer_name": "Ministry of Transport",
        "country": "DEU"
    }
}

Search by procurement type¶

{
    "method": "search_ted",
    "params": {
        "query": "software development",
        "procurement_type": "open",
        "limit": 10
    }
}

Find similar tenders¶

Once you find an interesting tender, discover related opportunities:

{
    "method": "find_similar_ted_tenders",
    "params": {
        "notice_id": "87e29ed9-5fbc-418e-9e6d-1bb5bc0c142c",
        "limit": 5
    }
}

Step 5: Get Details & Statistics¶

Retrieve full tender notice¶

{
    "method": "get_ted_notice",
    "params": {
        "notice_id": "87e29ed9-5fbc-418e-9e6d-1bb5bc0c142c"
    }
}

Database statistics¶

{
    "method": "get_ted_stats",
    "params": {}
}

Procurement trend analysis¶

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

Group by options: procurement_type, currency, nuts_code_main, country

Next Steps¶

Overview: Full reference of all 12 available tools
Search Guide: Master search techniques and filtering strategies
National Tenders: For below-threshold procurement
Examples: More usage scenarios