@pipeworx/fr-decp

Connect: https://pipeworx.io/mcp — every tool in the catalog, including @pipeworx/fr-decp’s. Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 3

French public-contract AWARD data (données essentielles de la commande publique / DECP) — for every contract a French public buyer has awarded: buyer, awarded supplier’s SIRET, amount, notification date, and CPV code. This is award data (after the fact), not tender notices — it complements france-boamp (open tender bulletin, before award), it does not duplicate it.

Tools

• fr_decp_search_contracts(keyword?, buyer_name?, buyer_siret?, supplier_name?, supplier_siret?, cpv_code?, department_code?, min_amount?, max_amount?, date_from?, date_to?, sort?, limit?, offset?) — search awarded contracts by any combination of buyer, supplier, CPV, French department, amount range, notification-date range, and free text in the contract description. Returns total_matches (the true count over the whole filtered set) plus the matching contracts, newest first by default.
• fr_decp_get_contract(uid) — fetch one contract award by its unique record id, as returned in a search result.
• fr_decp_contract_stats(group_by, keyword?, buyer_name?, buyer_siret?, supplier_name?, supplier_siret?, cpv_code?, department_code?, min_amount?, max_amount?, date_from?, date_to?, limit?) — aggregate contract counts by buyer department, buyer region, buyer type, supplier size category, supplier department, CPV code, procedure, or contract type, over the same filters as the search tool — “which departments/CPV codes/buyer types won the most contracts matching X”.

Auth

Keyless. No PISTE/API-Gouv account, app registration, or key is needed.

Data sources

• Ministère de l’économie et des finances (DAJ), Données essentielles de la commande publique — the legally-required disclosure (arrêté of 22 March 2019) every French public buyer files about a contract it awards, served through the state’s own consolidated, re-published copy under Licence Ouverte v2.0 (Etalab) — which explicitly permits redistribution and re-use, commercial included.

Notes

The upstream (an older “decp_augmente” dataset on data.economie.gouv.fr) was deprecated in November 2023 in favour of a newer, actively-maintained consolidated file; this pack targets the live successor, which is updated multiple times a month and carries records notified days before a query runs (verified: a contract notified the day before was queryable immediately).

The consolidated dataset’s own file is multi-gigabyte — too large to proxy or mirror whole — so this pack queries it live, per request, through the publisher’s own keyless row-filtering query service for hosted datasets. No nothing downloaded or stored by this pack; every response carries data_as_of.

Two upstream quirks worth knowing if you touch this pack:

• The __groupby and __count query operators are bare flags — passing them as key=value (what URLSearchParams.set() always produces) gets the whole query rejected with a 400 “Malformed query”. They have to be concatenated onto the query string unencoded, with no =.
• page_size silently returns zero rows above ~200 rather than erroring or clamping — there is no error to catch, so stay at or under 200.

A small share of upstream rows carry obviously-wrong values (e.g. a dateNotification decades in the future) — a data-quality property of the underlying government filings, not of this pack.

Tools

• fr_decp_search_contracts — Search FRENCH PUBLIC-CONTRACT AWARDS (données essentielles de la commande publique / DECP) — the legally-required disclosure every French public buyer (ministries, local authorities, public hospitals,
• fr_decp_get_contract — Fetch a single French public-contract award (DECP) by its unique record id (uid), as returned by fr_decp_search_contracts. Returns the full award record: buyer, supplier SIRET, amount, dates, CPV, pro
• fr_decp_contract_stats — Aggregate French public-contract AWARD counts (DECP), grouped by one dimension, over the same filters as fr_decp_search_contracts (buyer, supplier, CPV, department, amount range, date range, keyword).