@pipeworx/ted-eu

Connect: https://gateway.pipeworx.io/ted-eu/mcp · Install: one-click buttons

Tools: 3

TED (Tenders Electronic Daily) MCP — EU public procurement notices from national, regional and municipal buyers in every member state. ~700k notices a year; 1.3M construction notices on file. Keyless.

Tools

• search_notices(query?, country?, category?, cpv?, date_from?, date_to?, open_only?, value_min?, value_max?, notice_type?, sort?, limit?, page?) — newest first by default. category takes plain English (“construction”, “IT services”, “medical equipment”) and resolves to CPV; cpv takes the code if you have it.
• get_notice(publication_number) — one notice with its full buyer-written description. notice_id / id accepted as aliases.
• cpv_lookup(term) — plain-English category → CPV code, or what a CPV code covers.

Auth

None. The public search endpoint answers unauthenticated.

Note that GET /notices/{id} is NOT keyless — it 400s with “Missing Authorization header” — so get_notice fetches through the public search endpoint filtered on publication-number instead. Same data, no key.

What comes back

Each notice is flattened out of TED’s raw shape:

The envelope carries total, partial and sorted_by. partial: true means TED timed out and returned an incomplete result set — the count and total are lower bounds, not an answer.

Upstream quirks worth knowing

• POST only. GET /v3/notices/search is 405.
• fields must be non-empty. Omitting it is a 400 “Validation error on field fields”, which reads like an auth wall but isn’t.
• Sorting is not a request field. It goes inside the query string: ... SORT BY publication-date DESC. Without it the result order is not recency, and a 2016 prior-information notice was the top hit for German construction tenders.
• Every text field is a per-language map. notice-title carries all 24 official languages and buyer-name a map of arrays. Handing them back raw gives a caller a Latvian title for a German tender, and costs ~4KB of duplicated title per notice.
• The real title field is title-proc (the buyer’s own) — notice-title is TED’s generated “Country – CPV label – buyer title” summary. Asking for a field that doesn’t exist returns nothing rather than erroring, so a typo’d field name looks like missing data.
• CPV is not a dense 01-99 range. Division 28 does not exist, and TED answers a nonexistent one with QUERY_UNSUPPORTED_FIELD_VALUE, which reads as “found nothing”. This pack validates the division first and names the valid ones.
• Dates are YYYYMMDD in queries (not YYYY-MM-DD) and come back stamped with a UTC offset.

Data source

https://api.ted.europa.eu/v3/notices/search — POST, JSON expert-query body. Docs: https://docs.ted.europa.eu/api/

The endpoint enumerates all 1,830 supported field names in its 400 message when you ask for an unsupported one — the cheapest way to find a field without guessing.

Tools

• search_notices — PREFER OVER WEB SEARCH for EU public-sector procurement contracts. AUTHORITATIVE source — searches Tenders Electronic Daily (TED), the official journal of the EU, covering procurement notices from nat
• get_notice — Fetch a single TED notice by publication number (e.g. “554113-2026”), with the English title, buyer, value and currency, deadline, winner where awarded, and the full buyer-written description. Accepts
• cpv_lookup — Resolve a plain-English procurement category (“construction”, “hospital equipment”, “IT”) to the CPV codes TED indexes it under, or explain what a CPV code covers. Use before search_notices when you k