EU Tender MCP

Live, structured European public-procurement intelligence for SMEs — as an MCP server. Search opportunities, analyze cross-border risk, and understand EU tenders — all from inside Claude, Cursor, or any MCP client.

The value here is information an LLM cannot know: current tender opportunities, EU thresholds, CPV codes, and cross-border risk patterns. It's built for a consulting, services, or supply SME that wants to bid on public contracts outside its home member state.

Why it's genuinely useful (and not just another wrapper)

Every tool is deterministic, typed, and honest about its data source — it never fabricates "live" opportunities when a TED API key isn't configured.

Tools (7)

Install & run

python3 -m venv .venv
.venv/bin/pip install -e .
.venv/bin/pytest tests/ -q      # 38 tests, incl. a real MCP stdio integration

Start the server (stdio)

.venv/bin/eu-tender-mcp
# or
.venv/bin/python -m tendermcp.server

Connect a client

Claude Desktop — add to your MCP config (claude_desktop_config.json): mcpServers → see configs/claude-desktop.json. Point PYTHONPATH at the repo absolute path.

Claude Code / Cursor / other MCP clients — use configs/mcp-config.json and install the package (pip install -e .) so python3 -m tendermcp.server resolves.

Data model

• Default provider: a bundled set of clearly-labeled sample tenders (source bundled_sample) so the MCP works out of the box, is demoable, and is fully testable with no key.

• Live TED (roadmap): register a TED API key, set TED_API_KEY, and implement TEDLiveProvider._fetch() (in providers.py, already stubbed). Until then, no live data is ever fabricated — the labeled sample is returned instead.

Project layout

eu-tender-mcp/
├── tendermcp/
│   ├── server.py        ← FastMCP server wiring all tools
│   ├── knowledge.py     ← CPV codes, notice types, EU thresholds, red-flag rules
│   ├── analyzer.py      ← red-flag scan + SME fit scoring (offline, deterministic)
│   ├── providers.py     ← provider interface + bundled/live providers
│   ├── models.py        ← typed Tender / search-params models
│   ├── intel.py         ← market-snapshot aggregations
│   └── sample_data.py   ← labeled demo tenders
├── configs/             ← Claude Desktop / generic MCP client configs
├── tests/               ← 38 tests including real stdio integration
├── pyproject.toml
└── README.md

Roadmap / honest notes

• Live TED feed is the single biggest upgrade — it needs a registered TED/OPEN API key + account feed URL (account-specific), which only a user can supply. The provider seam is ready.

• More red-flag rules and jurisdiction nuance are planned; the analyzer is transparent on purpose (it outputs reasons, not false precision).

• Not legal advice. The analyzer is a triage aid; always verify against the full tender documents.

MIT licensed.