Spanish company public procurement (PLACSP)
get_spanish_company_public_procurementPublic-procurement record of a Spanish company from the Plataforma de Contratación del Sector Público (Ministerio de Hacienda CODICE feeds: hosted profiles and aggregated regional platforms with archives since 2012, minor contracts of the hosted profiles since 2018, daily updates): contracts WON matched by legal-person NIF (attributions: buyer with DIR3, subject, CPV, lot, closed-list result such as awarded or formalised, award date, amounts in EUR excl. and incl. tax as published, tenders received, SME flag) and notices ISSUED as a buyer (avis_emis, public entities with a NIF); minor contracts in their own lists (contrats_mineurs won, contrats_mineurs_passes as buyer), named in blocs_absents (collecte_en_cours) until first collected; newest first, capped at 100 per list, total and cut in listes_bornees; attributions and contrats_mineurs newest first by award date, else (missing or with a reserve) by the day of the file's latest version (mis_a_jour, Europe/Madrid). Never a natural-person winner (DNI, NIE or masked identifier; refused without charge) nor a consortium without its own NIF; a file cancelled by the source is no longer served as awarded. An aberrant award date is served as published with a closed-list reserves[] on its line, counted in reserves_lignes. Partial coverage: zero never means “never won a contract”; a NIF with no row, or a source placeholder NIF (identifiant_bouche_trou), answers 404 without charge. Paid via x402 ($0.02 in USDC or EURC). 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": {
"nif": "<nif>"
},
"name": "get_spanish_company_public_procurement"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nif | Yes | Spanish legal-person NIF: one letter (A-D, F, G, N, P-S, U-W), seven digits and a check character, e.g. A28582013; DNI/NIE (natural persons) are refused, and an E, H, J NIF (entity without legal personality, owners' association, civil partnership) returns 404, not billed | |
| 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`. |