# Le serveur MCP et l’API SaTT pour les agents IA

> Le serveur MCP public de SaTT en lecture seule (satt.com/api/mcp) : outils AdPools, Quêtes, créateurs, oracles, reçus, docs, limites et installation.

Publié par SaTT · Mis à jour le 2026-10-29 · Fonctionnalités · https://satt.com/guides/fr/features/mcp-api

## En bref

SaTT propose un serveur [MCP](https://satt.com/guides/fr/glossary#mcp) public en lecture seule à l’adresse `https://satt.com/api/mcp`, qui permet aux assistants IA d’interroger les AdPools, les pools en dollars, les Quêtes, l’annuaire des créateurs, le réseau d’oracles, les reçus, les attestations et la documentation. Il ne demande aucune authentification, n’expose que des données publiques et ne propose aucun outil d’écriture.

## Qu’est-ce que le serveur MCP de SaTT ?

C’est un point d’accès Model Context Protocol qui s’appuie sur l’API REST publique de SaTT : un assistant obtient donc les mêmes données validées et filtrées que le site.

| Élément | Valeur |
| --- | --- |
| Point d’accès | `POST https://satt.com/api/mcp` |
| Transport | HTTP streamable, mode JSON sans état (pas de session, pas de SSE) |
| Authentification | Aucune : données publiques uniquement |
| Limite de débit | Par IP : 60 requêtes en rafale, puis 1 requête par seconde |

Tous les outils sont en lecture seule. Soumettre un post, rejoindre une Quête ou réclamer un gain se fait dans l’application web, avec la signature de l’utilisateur.

## Quels outils propose-t-il ?

- `get_platform_info` : éditions, statut de l’alpha, types de pools, frais, jeton, règle du Créateur vérifié.
- `get_satt_price`, `get_satt_token` : prix du jeton, offre, volumes brûlés et liquidité.
- `list_adpools`, `get_adpool`, `list_fiat_pools`, `get_fiat_pool` : pools crypto et en dollars avec prix par réseau et statistiques.
- `list_quests`, `get_quest`, `verify_quest_draw` : les Quêtes et le recalcul du [tirage vérifiable](https://satt.com/guides/fr/glossary#verifiable-draw).
- `search_creators`, `get_creator`, `get_directory_stats` : l’annuaire des créateurs, Créateurs vérifiés en premier.
- `get_oracle_network`, `list_oracles`, `get_oracle`, `list_oracle_jobs`, `get_oracle_job`, `match_ownership`, `list_oracle_providers` : le [réseau d’oracles](https://satt.com/guides/fr/glossary#oracle-network).
- `get_capabilities` : ce qui peut être mesuré sur chaque réseau.
- `list_receipts`, `verify_receipt`, `list_attestations`, `verify_attestation` : [reçus](https://satt.com/guides/fr/glossary#receipt) et [attestations](https://satt.com/guides/fr/glossary#attestation).
- `search_docs` : recherche dans la documentation de référence de SaTT.

Il expose aussi deux ressources (les informations de la plateforme et la référence Markdown) et trois prompts : `evaluate_adpool`, `verify_payout` et `find_creators`.

## Comment connecter un assistant ?

Ajoutez le serveur à la configuration de votre client MCP :

`{ "mcpServers": { "satt": { "type": "http", "url": "https://satt.com/api/mcp" } } }`

La mise en place pas à pas et un test avec curl sont détaillés dans [Utiliser le serveur MCP](https://satt.com/guides/fr/how-to/use-mcp-server).

## Comment lire les résultats ?

- Chaque résultat contient `url`, la page satt.com correspondante, pour que les réponses puissent la citer.
- Les montants crypto sont en unités de base du jeton (18 décimales) ; les montants en dollars sont des centimes entiers.
- Les erreurs sont renvoyées comme des données avec `isError: true` et un code comme `not_found` ou `rate_limited` (avec `retryAfter`).
- Les e-mails des créateurs et les sessions ne quittent jamais le serveur : aucun cookie n’est transmis à l’API.

Le serveur est aussi référencé dans `https://satt.com/llms.txt`, dans `https://satt.com/openapi.json` et dans le catalogue d’API `https://satt.com/.well-known/api-catalog`.

## À retenir

- Point d’accès : POST https://satt.com/api/mcp, sans authentification.
- Lecture seule : aucun outil ne peut soumettre, rejoindre, réclamer ou modifier quoi que ce soit.
- Les outils couvrent pools, Quêtes, créateurs, oracles, reçus, capacités et documentation.
- Les montants crypto sont en unités de base à 18 décimales ; les dollars en centimes entiers.
- Limite par IP : 60 requêtes en rafale, puis 1 par seconde.

## Questions fréquentes

### Faut-il une clé d’API ?

Non. Le serveur MCP est public et ne sert que des données publiques, avec une limite de débit par adresse IP.

### Un agent IA peut-il postuler à un AdPool via MCP ?

Non. Tous les outils sont en lecture seule. Postuler, rejoindre une Quête ou réclamer un gain nécessite la signature de l’utilisateur dans l’application web.

### Le serveur MCP peut-il vérifier un tirage de Quête ?

Oui. `verify_quest_draw` recalcule la racine de Merkle, la graine, les gagnants et le signataire, et renvoie le bloc de référence à contrôler sur un explorateur.

## Guides associés

- [Utiliser le serveur MCP de SaTT avec un assistant IA](https://satt.com/guides/fr/how-to/use-mcp-server)
- [Le réseau d’oracles : qui mesure les posts SaTT](https://satt.com/guides/fr/features/oracle-network)
- [Paiements vérifiables : attestations et reçus](https://satt.com/guides/fr/features/verified-receipts)
- [Devenir oracle et être payé pour mesurer des posts](https://satt.com/guides/fr/how-to/become-an-oracle)

## Pages officielles

- [Réseau d’oracles](https://satt.com/oracles)
- [Paiements vérifiables](https://satt.com/attestations)

Glossaire: https://satt.com/guides/fr/glossary