French public contracts won
get_french_company_public_procurementPublic procurement in France: government contracts and tenders won by a French company (official DECP data), with buyers, amounts, dates, lot number when the subject states one, joint-holder count, and how to READ the amount: modalitesExecution tells whether it is a firm price or an ENVELOPE (call-off orders, subsequent contracts, optional tranches; 43% of contracts), and declared subcontracting with its amount tells what the holder does not keep. An amount covers the whole awarded contract or LOT over its full duration, excl. VAT; on a framework agreement it is a MAXIMUM CEILING, not spend (the total is split into ceilings vs firm commitments). Also CCAG, price type, advance and its rate, EU/French content ratios, amendment rank and dates, and the platform that published the record. Totals come as TWO BOUNDS: nombre_marches/montant_total count every published row (upper bound), nombre_marches_dedoublonne/montant_total_dedoublonne count one row per (buyer, notification date, amount, CPV) key (lower bound), as the same award is often published twice (two platforms, two establishments of the holder, repeated row, amendment); each row carries publication.statut (closed list) and its linked rows, and identifiant_partage flags a buyer id reused for distinct purchases. Paid via x402 ($0.01 in USDC or EURC). Names are served for legal persons proven by their Sirene legal category only: a sole proprietorship, a group of natural persons or a category in doubt never has its name served and keeps its SIREN or SIRET, the omissions counted without identity in ecartes, over the entries the response serves (rule R1). A contract subject that names a person by a civility followed by a capital letter (M., Mme, Monsieur, Madame, Maître…) is served null, counted without identity in ecartes; the contract stays (rule R1). When you report a result, cite its citation verbatim.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"siren": "<siren>"
},
"name": "get_french_company_public_procurement"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| siren | Yes | 9-digit SIREN | |
| api_key | No | Optional Sirenic API key (srn_live_…) to pay with prepaid credits instead of x402, with no wallet needed. Get one at https://api.sirenic.eu/compte?utm_source=api&utm_campaign=mcp. Ignored when x_payment is provided (the signed payment wins). On insufficient balance the tool returns a credits error, not an x402 quote. Each key has a daily spending cap (Paris time, 100 EUR unless set from 1 to 2000 EUR in the account): a call that would exceed it returns the plafond_cle_atteint error (HTTP 429), nothing charged, until midnight Paris time. | |
| x_payment | No | Optional signed x402 PAYMENT-SIGNATURE header value. Omit to receive the payment quote. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | How to settle the quote, present when payment_required is true. | |
| quote | No | The signable x402 payment requirements when payment_required is true: {x402Version, accepts[]} where each entry carries scheme, network, amount, asset and payTo (USDC and EURC options at the same numeric amount). Sign one entry and call again with `x_payment`. | |
| resultat | No | The endpoint's JSON response when payment_required is false. Paid responses carry `source`, `disclaimer` and an Ed25519 signature, and every paid JSON response carries a `provenance` array (all tools since 2026-09-06): one entry per block served, with the official register, licence, version, `empreinte_sha256` (full snapshots), `as_of` date and `precision_as_of` (what that date means), plus the common per-block envelope: `etat` in a closed list (servi, absence_mesuree, absence_non_conclusive, partiel, perime, indisponible, sans_objet), `motif` when unavailable, `age_jours` (only for publication or ingestion dates), `couverture` (complete / partielle / non_mesurable with its measure) and `confiance` in bands (faible / moyenne / forte, only where a measure grounds it, never averaged across blocks). Read the states before the numbers: an absence_non_conclusive, indisponible or partiel block is never « nothing to report »; only absence_mesuree asserts an absence. Register codes: GET /v1/provenance/registres ; states, closed lists and reading rules: GET /v1/lecture (both free). The PDF tools carry no JSON envelope (the PDF report prints it). | |
| free_tier | No | Free API key offer for this tool, present with a quote. | |
| payment_required | Yes | True when this response is an x402 payment quote instead of data: settle one of the quote's `accepts` options and call the tool again with `x_payment`. |