API Anatools

Comptes et joueurs

Tous les comptes connus, actifs et archivés, de la partie en cours et des précédentes. Pour chacun : le dirigeant et la nation, l'état, l'alliance, les badges, les noms successifs, les anciens pays et les profils liés d'un même joueur entre les parties. Les statistiques de la fiche (bonheur, superficie, régions habitables, pollution, technologies, recherche, éducation, merveille, victoires et défaites…) sont données avec leur évolution cycle après cycle pour les comptes en cours.

/v1/comptes /v1/comptes/{id}

Alliances

Toutes les alliances, en activité ou archivées : tag, nom, président, nombre de membres, Discord quand il est dans la description, texte de présentation et noms successifs.

/v1/alliances /v1/alliances/{id}

Classement

Le classement du dernier cycle, et l'historique cycle après cycle par joueur et par alliance : rang, score, population, territoire et alliance. Pour la partie en cours seulement, à partir du cycle 29 (10 octobre 2026).

/v1/classement /v1/classement/historique /v1/classement/joueurs/{id} /v1/classement/alliances /v1/classement/alliances/{id}

Chronologie et combats

La chronologie du jeu pour la partie en cours et les trois parties précédentes, filtre partie (guerres terminées avec vainqueur, durée et pertes, guerres déclarées dont les détails sont encore masqués, pays fondés, périodes). Les combats sont déduits des relevés du classement : un gain de territoire d'un côté, une perte de l'autre.

/v1/chronologie /v1/combats

Statistiques de la partie

Les chiffres globaux de la partie en cours, un point par tour (cycle) depuis le premier : nombre de pays, population, territoire, argent, pollution, bonheur, technologies et éducation moyennes, guerres, alliances, activité du forum, matériaux (les huit types). Ils viennent de l'API officielle du jeu, relevés après chaque cycle.

/v1/stats

Listes filtrées côté serveur

Les joueurs et les alliances du dernier cycle, filtrés (partie, statut, alliance, badge, texte), triés par la mesure de ton choix (score, population, territoire, ancienneté, technologies, pollution…) et paginés. Un joueur en vacances garde son score et son rang d’avant. Les séries du classement de plusieurs joueurs ou alliances se demandent en un seul appel, et la recherche rend quelques joueurs et alliances à partir d’un texte (casse et accents ignorés).

/v1/classement/joueurs /v1/classement/alliances/liste /v1/classement/series /v1/recherche

Guerres

Les guerres terminées des quatre parties avec le territoire conquis et les soldats tués quand ils sont connus (null sinon, jamais 0), la durée moyenne, l’histogramme des durées en cinq classes et la série du nombre de guerres en cours dans le monde. Une guerre se déplie avec ses combats déduits.

/v1/guerres /v1/guerres/{gid}

État des données

Si la collecte est à jour ou en retard (en cycles), le dernier et le prochain relevé, l’état de chaque source, la couverture de chaque partie et le journal des nouveautés.

/v1/etat

Serveur MCP

Pour interroger les données avec une IA (Claude ou un autre assistant) : un serveur MCP distant, en lecture seule, avec les mêmes données que l'API (comptes, alliances, classement, chronologie, statistiques, merveilles, podiums). Il demande la même clé que l'API, dans l'en-tête X-API-Key.

https://api.myst.best/mcp

Avec Claude Code : claude mcp add --transport http anatools https://api.myst.best/mcp --header "X-API-Key: ta-clé"

Merveilles

Le classement des merveilles de la partie en cours par score. Ce score vient de l'API officielle du jeu et n'est pas affiché en jeu. Il ressemble à la hauteur de la merveille : de 0 à 300 environ en construction, plus de 400 pour une merveille, plus de 700 pour une grande (à confirmer). Chaque ligne donne le type (Scientifique, Humaniste, économique, écologique, Guerrière, Diplomatique), l'état (en construction, merveille, grande) et le matériau.

/v1/merveilles

Badges

Le catalogue des badges avec leur nombre de porteurs, la liste des comptes qui portent un badge donné, et le tableau des comptes avec leurs badges, filtré par badges cochés (au moins un ou tous).

/v1/badges /v1/badges/{nom} /v1/badges/porteurs

Annuaire et fiche en direct

L'annuaire contient ce qui n'existe pas dans le jeu et qui est saisi à la main : gouvernement et Discord de joueurs, Discord d'alliances. La fiche en direct lit, au moment de l'appel, le bonheur et la Grande Merveille Guerrière d'un joueur.

/v1/annuaire /v1/joueurs/{id}/fiche

curl -H "X-API-Key: ta_clé" https://api.myst.best/v1/comptes/9709

const r = await fetch("https://api.myst.best/v1/badges/equipe", {
  headers: { "X-API-Key": process.env.ANAPI_CLE },
});
console.log((await r.json()).porteurs);