# S'en servir

Il y a trois portes d'entrée : essayer un service sans payer, payer à l'appel avec un portefeuille x402 (un portefeuille de cryptomonnaie capable de régler les requêtes x402, garni d'USDC), ou payer par carte chez OpenAny. x402 est un protocole ouvert qui sert à payer une seule requête HTTP, ici en USDC. Chaque service s'ajoute aussi à Claude Code d'une seule commande.

Laquelle choisir ? Pour essayer, commencez par la 1. Si votre agent dispose d'un portefeuille de cryptomonnaie compatible avec x402, prenez la 2. Si vous préférez payer par carte avec une seule clé d'API, prenez la 3. Pour brancher un service sur Claude Code ou sur un autre client MCP, voyez « Brancher par MCP » plus bas.

## 1. Essayer sans payer

Chaque service renvoie gratuitement une véritable réponse d'exemple sur sa route `/v1/exemple`. Vous n'avez rien à ajouter à la requête.

Chaque service accepte aussi quelques appels gratuits par jour sur sa route d'essai, nommée dans le tableau ci-dessous, mais seulement si vous les demandez : ajoutez le paramètre de requête ou l'en-tête indiqués dans ce même tableau. Chaque service publie ces limites dans son fichier `/.well-known/x402`, sous `freeTrial`.

Sans ce paramètre ni cet en-tête, une route payante renvoie toujours le code HTTP 402 (Payment Required, « paiement requis »).

Exemples de requêtes au service Biennial Update Sentinel :

```
GET https://mcs150.amacunia.fr/v1/exemple
    200, une véritable réponse d'exemple, gratuite
GET https://mcs150.amacunia.fr/v1/mcs150?free_trial=1
    un appel d'essai gratuit, une fois ajoutés les paramètres de la route, donnés par sa description OpenAPI
GET https://mcs150.amacunia.fr/v1/mcs150
    402, les exigences de paiement
```

## 2. Payer avec un portefeuille x402

1. Appelez une route payante sans payer. Elle renvoie le code HTTP 402 avec les exigences de paiement : montant, monnaie, réseau et adresse de paiement.
2. Un client x402 signe un paiement en USDC sur le réseau Base (`eip155:8453`), puis renvoie la même requête, paiement joint.

Il ne vous faut ni compte ni clé d'API. Une erreur ou une requête invalide n'est jamais facturée.

L'adresse de paiement n'est pas affichée sur cette page : votre agent la lit dans la réponse 402.

## 3. Payer par carte, chez OpenAny

OpenAny est une place de marché qui encaisse elle-même l'acheteur. On y alimente un solde, par carte ou en USDC, puis on appelle les services à travers sa passerelle avec sa clé OpenAny. Les services y figurent sous le nom de vendeur Amacunia. [Amacunia chez OpenAny](https://openany.si/providers/amacunia).

## Service par service

| Service | Prix de l'appel | Essai gratuit | Comment le demander | Exemple gratuit | Paramètres |
|---|---|---|---|---|---|
| [Biennial Update Sentinel](https://mcs150.amacunia.fr/) | `GET /v1/mcs150` 0,005 USDC | `GET /v1/mcs150` : 3 appels par jour et par appelant ; 50 par jour pour tout le service | `free_trial=1` dans l'adresse de la requête, ou l'en-tête `X-Free-Trial: 1` | [Exemple](https://mcs150.amacunia.fr/v1/exemple) | [OpenAPI](https://mcs150.amacunia.fr/openapi.json) |
| [Operating Authority Sentinel](https://authority.amacunia.fr/) | `GET /v1/authority` 0,01 USDC ; `GET /v1/carrier-compliance` 0,012 USDC | `GET /v1/authority` : 3 appels par jour et par appelant ; 50 par jour pour tout le service | `free_trial=1` dans l'adresse de la requête, ou l'en-tête `X-Free-Trial: 1` | [Exemple](https://authority.amacunia.fr/v1/exemple) | [OpenAPI](https://authority.amacunia.fr/openapi.json) |
| [Disaster Deadline Sentinel](https://disasters.amacunia.fr/) | `GET /v1/disasters` 0,01 USDC | `GET /v1/disasters` : 3 appels par jour et par appelant ; 50 par jour pour tout le service | `free_trial=1` dans l'adresse de la requête, ou l'en-tête `X-Free-Trial: 1` | [Exemple](https://disasters.amacunia.fr/v1/exemple) | [OpenAPI](https://disasters.amacunia.fr/openapi.json) |
| [Revalidation Deadline Sentinel](https://revalidation.amacunia.fr/) | `GET /v1/revalidation` 0,01 USDC | `GET /v1/revalidation` : 3 appels par jour et par appelant ; 50 par jour pour tout le service | `free_trial=1` dans l'adresse de la requête, ou l'en-tête `X-Free-Trial: 1` | [Exemple](https://revalidation.amacunia.fr/v1/exemple) | [OpenAPI](https://revalidation.amacunia.fr/openapi.json) |
| [Sentinelle catnat](https://catnat.amacunia.fr/) | `GET /v1/catnat` 0,01 USDC | `GET /v1/catnat` : 3 appels par jour et par appelant ; 50 par jour pour tout le service | `free_trial=1` dans l'adresse de la requête, ou l'en-tête `X-Free-Trial: 1` | [Exemple](https://catnat.amacunia.fr/v1/exemple) | [OpenAPI](https://catnat.amacunia.fr/openapi.json) |
| [Sentinelle créances](https://creances.amacunia.fr/) | `GET /v1/creances` 0,01 USDC | `GET /v1/creances` : 3 appels par jour et par appelant ; 50 par jour pour tout le service | `free_trial=1` dans l'adresse de la requête, ou l'en-tête `X-Free-Trial: 1` | [Exemple](https://creances.amacunia.fr/v1/exemple) | [OpenAPI](https://creances.amacunia.fr/openapi.json) |
| [Sentinelle oppositions](https://oppositions.amacunia.fr/) | `GET /v1/oppositions` 0,01 USDC | `GET /v1/oppositions` : 3 appels par jour et par appelant ; 50 par jour pour tout le service | `free_trial=1` dans l'adresse de la requête, ou l'en-tête `X-Free-Trial: 1` | [Exemple](https://oppositions.amacunia.fr/v1/exemple) | [OpenAPI](https://oppositions.amacunia.fr/openapi.json) |
| [Sentinelle phyto](https://phyto.amacunia.fr/) | `GET /v1/phyto` 0,01 USDC | `GET /v1/phyto` : 3 appels par jour et par appelant ; 50 par jour pour tout le service | `free_trial=1` dans l'adresse de la requête, ou l'en-tête `X-Free-Trial: 1` | [Exemple](https://phyto.amacunia.fr/v1/exemple) | [OpenAPI](https://phyto.amacunia.fr/openapi.json) |
| [Sentinelle syndic](https://syndic.amacunia.fr/) | `GET /v1/syndic` 0,01 USDC ; `GET /v1/syndic/echeances` 0,03 USDC | `GET /v1/syndic` : 3 appels par jour et par appelant ; 50 par jour pour tout le service | `free_trial=1` dans l'adresse de la requête, ou l'en-tête `X-Free-Trial: 1` | [Exemple](https://syndic.amacunia.fr/v1/exemple) | [OpenAPI](https://syndic.amacunia.fr/openapi.json) |

## Brancher par MCP

Chaque service est aussi un serveur MCP. MCP (Model Context Protocol) est le protocole standard par lequel un agent IA appelle un outil extérieur. Les serveurs emploient le transport Streamable HTTP (`streamable-http`) et ne demandent aucun compte.

Chaque serveur propose un outil d'exemple gratuit et un ou plusieurs outils payants. Le tableau ci-dessous donne chaque outil avec son prix.

Un outil payant appelé sans paiement renvoie les exigences de paiement x402 au lieu d'un résultat. Un client MCP qui ne peut pas payer avec x402 peut toujours utiliser l'outil d'exemple et l'essai gratuit.

Pour l'essai gratuit par MCP, appelez l'outil payant qui correspond à la route d'essai du service, avec l'argument `free_trial` à `true`. Ces appels comptent dans le même quota quotidien que les appels par le web.

Les serveurs répondent aux clients qui utilisent la révision 2026-07-28 de MCP.

Dans Claude Code, une commande par service ajoute son serveur MCP :

| Service | Question à laquelle il répond | Outils MCP | Commande |
|---|---|---|---|
| [Biennial Update Sentinel](https://mcs150.amacunia.fr/) | Quand la prochaine mise à jour biennale du formulaire MCS-150 d'un transporteur routier américain est-elle due, et la dernière a-t-elle été manquée ? | `mcs150_lookup` 0,005 USDC, `mcs150_example` gratuit | `claude mcp add --transport http amacunia-mcs150 https://mcs150.amacunia.fr/mcp` |
| [Operating Authority Sentinel](https://authority.amacunia.fr/) | L'autorisation d'exploitation de ce transporteur routier américain est-elle active, son assurance est-elle enregistrée, une suspension ou une mise à jour MCS-150 approche-t-elle ? | `authority_lookup` 0,01 USDC, `authority_example` gratuit, `carrier_compliance_lookup` 0,012 USDC, `carrier_compliance_example` gratuit | `claude mcp add --transport http amacunia-authority https://authority.amacunia.fr/mcp` |
| [Disaster Deadline Sentinel](https://disasters.amacunia.fr/) | Après une catastrophe dans un comté américain, jusqu'à quand demander l'aide de la FEMA, et à quelle date l'IRS reporte-t-il les échéances fiscales ? Service non affilié à la FEMA ni à l'IRS. | `disasters_lookup` 0,01 USDC, `disasters_example` gratuit | `claude mcp add --transport http amacunia-disasters https://disasters.amacunia.fr/mcp` |
| [Revalidation Deadline Sentinel](https://revalidation.amacunia.fr/) | Quand ce professionnel de santé américain doit-il revalider son inscription à Medicare, et la date est-elle déjà fixée ? | `revalidation_lookup` 0,01 USDC, `revalidation_example` gratuit | `claude mcp add --transport http amacunia-revalidation https://revalidation.amacunia.fr/mcp` |
| [Sentinelle catnat](https://catnat.amacunia.fr/) | Après une catastrophe naturelle, l'assuré a trente jours pour déclarer son sinistre. | `catnat_lookup` 0,01 USDC, `catnat_example` gratuit | `claude mcp add --transport http amacunia-catnat https://catnat.amacunia.fr/mcp` |
| [Sentinelle créances](https://creances.amacunia.fr/) | Quand un client est mis en liquidation, ses créanciers ont deux mois pour se déclarer. | `creances_lookup` 0,01 USDC, `creances_example` gratuit | `claude mcp add --transport http amacunia-creances https://creances.amacunia.fr/mcp` |
| [Sentinelle oppositions](https://oppositions.amacunia.fr/) | Quand un débiteur vend son fonds de commerce, ses créanciers ont dix jours pour bloquer le prix. | `oppositions_lookup` 0,01 USDC, `oppositions_example` gratuit | `claude mcp add --transport http amacunia-oppositions https://oppositions.amacunia.fr/mcp` |
| [Sentinelle phyto](https://phyto.amacunia.fr/) | Quand un produit phytosanitaire est retiré, la décision peut laisser quelques mois pour vendre le stock, puis pour l'utiliser. | `phyto_lookup` 0,01 USDC, `phyto_example` gratuit | `claude mcp add --transport http amacunia-phyto https://phyto.amacunia.fr/mcp` |
| [Sentinelle syndic](https://syndic.amacunia.fr/) | Le mandat d'un syndic de copropriété dure en règle générale trois ans au plus. Puis l'assemblée générale rebat les cartes. | `syndic_lookup` 0,01 USDC, `syndic_echeances` 0,03 USDC, `syndic_example` gratuit | `claude mcp add --transport http amacunia-syndic https://syndic.amacunia.fr/mcp` |
