[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Lire les attributions de marchés

L'outil marches_attributions de Prescriptio dit qui a gagné quoi dans les marchés publics du bâti, d'après les DECP : titulaire, montant réel, acheteur et date, ou le classement des entreprises qui remportent le plus de contrats.

### Squelette d'appel, généré depuis le schéma

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "type": "liste"
    },
    "name": "marches_attributions"
  }
}
```

**HTTP (curl)**

```bash
curl -sS https://prescriptio.fr/api/mcp \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"type":"liste"},"name":"marches_attributions"}}'
```

### Forme de la réponse, générée depuis le schéma

```json
{
  "_meta": {},
  "next_cursor": "<texte>",
  "results": [
    {
      "fields": {},
      "id": "<texte>",
      "resume": "<texte>",
      "titre": "<texte>"
    }
  ],
  "total_estimated": 0
}
```

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `cursor` | texte | — | Curseur next_cursor de la page précédente, repassé tel quel. |
| `limit` | entier | — | (min 1, max 50, défaut `20`) |
| `localisation` | objet | — | Zone géographique. National = omettre (jamais dept:"all"). |
| `localisation.dept` | texte | — | Code département : 01-95, 2A/2B ou 971-978. |
| `localisation.region` | texte | — | Nom de région — couvre tous ses départements en un appel. |
| `query` | texte | — | Thème (ex : "voirie") ou nom d'ouvrage. Plein texte sur l'objet des contrats. UNE requête = UN sujet. |
| `type` | `liste` · `top_titulaires` | — | liste (défaut) = attributions recentes (titulaire, montant, acheteur, date). top_titulaires = classement des entreprises qui remportent le PLUS DE CONTRATS sur le sujet (le montant est rendu, il ne décide pas du rang : la source melange lots de chantier, operations entieres et accords-cadres sous un même type). Avec query = sur ce thème, sur la même population que la liste ; sans query mais avec localisation = classement global de la zone. |

## Quand l'utiliser

type:"liste" (défaut) = attributions recentes d'un thème et/ou d'une zone, avec titulaire (nom + SIRET), montant réel, acheteur, date. type:"top_titulaires" = classement des entreprises qui gagnent le plus : avec query thematique (ex "voirie") = classement sur ce thème ; sans query mais avec localisation = classement global de la zone. Utile pour : qui gagne quoi, analyse concurrentielle, montants réels (rarement publiés sur les AO ouverts).

**Prompt prêt à coller : Le prompt qui le déclenche**

```text
Avec Prescriptio, qui remporte le plus de marchés de menuiseries extérieures en Bretagne ?
```

Outil : `marches_attributions` · Portée : `mcp:read`, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 50 résultats par page au plus

## En bref

| | |
|---|---|
| Effets | lecture seule |
| Portée OAuth | `mcp:read` |
| Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. |
| Données lues | la donnée publique du bâti — aucune coordonnée personnelle n'est jamais renvoyée |
| Distribution | MCP historique |
| En REST | aucune opération : il s'appelle par le connecteur MCP |

## Réponse

Le résultat arrive dans `content[0].text` (le JSON sérialisé) et dans `structuredContent` (le même objet). L'exemple donne les **types**, jamais des valeurs réelles. Un champ absent ou `null` n'est ni un zéro ni une estimation : la source ne l'a pas renseigné.

## Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée.

Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas).

## Les skills qui s'en servent

- [prescriptio-trouver-marches](https://prescriptio.fr/skills/prescriptio-trouver-marches) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `marches_attributions`.

- [Moteur de recherche](https://prescriptio.fr/docs/recherche) : Documentation, Les modules
- [Les attributions (DECP)](https://prescriptio.fr/docs/donnees/attributions) : Documentation, Les données
- [Les entreprises et leurs établissements](https://prescriptio.fr/docs/donnees/entreprises) : Documentation, Les données
- [Appels d'offres](https://prescriptio.fr/docs/appels-offres) : Documentation, Les modules
- [Prescripteurs](https://prescriptio.fr/docs/detection-prescripteurs) : Documentation, Les modules
- [Les observatoires](https://prescriptio.fr/docs/donnees/observatoires) : Documentation, Les données
- [Trouver les architectes et bureaux d'études présents dans les dossiers qui citent votre matériau](https://prescriptio.fr/docs/guides/cabinets-de-votre-materiau) : Guides, Prescripteur de matériaux
- [Savoir qui remporte les marchés de votre lot dans votre département](https://prescriptio.fr/docs/guides/qui-remporte-les-marches-de-votre-lot) : Guides, Entreprise de travaux
- [Playbooks](https://prescriptio.fr/agents-ia/playbooks) : IA, Aller plus loin
- [Skills](https://prescriptio.fr/skills) : IA, Skills et plugin
- [Prompts du prescripteur de matériaux](https://prescriptio.fr/docs/prompts/prescripteur-materiaux) : IA, Prompts par métier
- [Trouver et lire des marchés](https://prescriptio.fr/skills/prescriptio-trouver-marches) : IA, Les skills du plugin

## Voir aussi

- [marches_rechercher](https://prescriptio.fr/docs/api/marches_rechercher) : Avis d'appels d'offres publics du bâti (BOAMP + DECP, ~744 000 avis)
- [marches_dce](https://prescriptio.fr/docs/api/marches_dce) : Pièces d'un dossier de consultation (DCE)
- [marches_dce_lien_obtenir](https://prescriptio.fr/docs/api/marches_dce_lien_obtenir) : URL de téléchargement signée (valable 1 h) d'une pièce de DCE, ou de l'archive complete du dossier
- [marches_dossiers](https://prescriptio.fr/docs/api/marches_dossiers) : Pipeline des dossiers d'appels d'offres suivis (kanban du portefeuille)
- [marches_dossier_suivre](https://prescriptio.fr/docs/api/marches_dossier_suivre) : Ajoute un marché public ou un DCE au pipeline AO (crée un dossier au statut 'A qualifier')
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module