MCP et API

Mesurez la visibilité IA depuis Claude, vos agents et votre pipeline.

AeoState exploite un serveur Model Context Protocol (MCP) à l'adresse https://aeostate.com/mcp, avec la même API HTTP derrière. Connectez-vous une fois et le score gratuit de visibilité IA s'affiche comme une carte interactive dans Claude Desktop, claude.ai, Claude Code, Cursor et tout autre hôte MCP — ou appelez l'API directement depuis un script.

Outils

Les outils gratuits fonctionnent pour tous : sans compte, sans clé. Les outils marqués « Clé d'API » agissent pour un compte enregistré : créez un compte gratuit, puis une clé personnelle dans Compte → Accès API.

Connectez-vous en une étape

Copiez l'un de ces extraits dans votre hôte. Ajoutez l'en-tête Authorization quand vous avez une clé.

Point de terminaison MCP
https://aeostate.com/mcp
Claude Code
claude mcp add --transport http aeostate https://aeostate.com/mcp
Cursor, VS Code, connecteurs claude.ai et autres hôtes (JSON)
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp"
    }
  }
}
Idem, en agissant pour votre compte
{
  "mcpServers": {
    "aeostate": {
      "url": "https://aeostate.com/mcp",
      "headers": {
        "Authorization": "Bearer <your-api-key>"
      }
    }
  }
}

HTTP simple pour les pipelines

Les trois mêmes appels que ceux du serveur MCP. Lancez une analyse, interrogez-la, lisez le rapport — depuis la CI, un flux CRM ou une tâche nocturne.

1 · Lancer une analyse
curl -s -X POST https://aeostate.com/api/analyze \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com","industry":"family dental clinic","category":"family dental clinic","locale":"en"}'
# → {"mode":"async","jobId":"…"} (poll below) or the finished free summary
2 · Interroger jusqu'à la fin
curl -s https://aeostate.com/api/scan-jobs/<jobId>
# → {"status":"queued|running|completed|failed","stage":"crawling|scoring|completed","reportId":"…"}
3 · Lire le rapport
curl -s https://aeostate.com/api/reports/<reportId>
# → 402 + the free summary (score, grade, confidence, section teasers)

Les analyses anonymes suivent les règles du score gratuit du site (limites d'usage ; lorsque le score gratuit est protégé par e-mail, le lien est envoyé par e-mail). Avec une clé, elles s'exécutent au nom de votre compte : pas de barrière, limites par clé et vos rapports payants.

Comment les agents IA trouvent AeoState

En plus du serveur MCP, AeoState publie des descriptions lisibles par machine pour que les agents IA et les registres d’agents le découvrent d’eux-mêmes. Chaque adresse ci-dessous répond en JSON lisible par n’importe quel site.

Carte du serveur MCP
https://aeostate.com/.well-known/mcp/server-card.json
Catalogue IA (ARD)
https://aeostate.com/.well-known/ai-catalog.json
Catalogue d’API (RFC 9727)
https://aeostate.com/.well-known/api-catalog

Compétences pour agents (Agent Skills)

Les agents compatibles Agent Skills peuvent charger depuis cet index la compétence publiée par AeoState. Elle leur montre comment lancer une vérification gratuite de la visibilité IA via le serveur MCP ou l’API HTTP, puis comment lire le résultat. Chaque compétence est listée avec une empreinte SHA-256 pour que l’agent puisse vérifier ce qu’il a téléchargé.

Index des Agent Skills
https://aeostate.com/.well-known/agent-skills/index.json

Les pages en markdown

Demandez n’importe quelle page publique avec l’en-tête Accept: text/markdown pour obtenir son texte en markdown plutôt qu’en HTML, avec son titre, son adresse et sa langue en tête. Les navigateurs continuent de recevoir la page normale.

Exemple
curl -H "Accept: text/markdown" https://aeostate.com/fr/pricing

Outils dans le navigateur (WebMCP)

Dans un navigateur compatible WebMCP, un agent IA qui travaille sur ce site peut ouvrir ses pages, lire les tarifs actuels, suivre une analyse en cours et remplir le formulaire de score gratuit. Le visiteur confirme et envoie toujours lui-même le formulaire. WebMCP est expérimental et n’est disponible que dans certaines versions de navigateur ; ailleurs, rien ne change.

Score gratuit et Rapport Advanced

Sans compte

Score gratuit — chaque outil, chaque visiteur

  • Votre score global de visibilité, sa note et notre niveau de confiance
  • Dans quelle mesure votre contenu publié étaye clairement les réponses IA
  • Le premier constat qui freine votre visibilité

Obtenez une clé d'API personnelle

Connectez-vous (ou créez un compte gratuit), ouvrez Compte → Accès API, créez une clé et collez-la dans les extraits ci-dessus. Les clés n'agissent que sur les analyses et les rapports que vous avez achetés — jamais sur votre compte, la facturation ni les rapports d'autrui.

Obtenez votre clé