API et MCP gratuits

L’essentiel

• Gratuit : pas de clé, pas de compte, pas d’offre payante derrière.
• Licence CC BY 4.0 : réutilisation libre des données factuelles, avec attribution (voir plus bas).
• API REST : https://vuntum.com/api/v1, en lecture seule, JSON, 120 requêtes par minute et par adresse IP. Description OpenAPI 3.1 : openapi.json.
• Serveur MCP : https://vuntum.com/mcp (HTTP Streamable), en lecture seule, 16 outils, 60 requêtes par minute et par adresse IP. Rien à installer.
• Deux langues : les textes sont en français par défaut, en anglais avec ?lang=en (API) ou locale: "en" (MCP).

Exemples de requêtes API

Chaque exemple se copie tel quel dans un terminal. Les réponses ont toutes la même forme : data (le résultat), meta (date, licence, attribution) et, pour les listes, un curseur de pagination. Ajoutez limit= pour réduire la liste.

Tous les points d’accès, leurs paramètres et leurs codes d’erreur sont décrits dans openapi.json. Les réponses portent un ETag et acceptent les requêtes conditionnelles ; les erreurs suivent la RFC 9457.

Le serveur MCP

MCP (Model Context Protocol) est la prise standard qui permet à un assistant IA d’interroger une source de données. Une fois Vuntum ajouté comme connecteur, l’assistant répond à partir de nos données sourcées plutôt que de sa mémoire, et indique la fiche à consulter. L’adresse à fournir est toujours la même : https://vuntum.com/mcp, sans authentification.

Questions à poser à votre assistant

Quelques exemples, par thème, qui font appel aux outils du serveur.

• Trouver
  • Quels robots peuvent monter des escaliers, et qui l’affirme ?
  • Quels robots pour la maison puis-je programmer en Python ou avec ROS 2 ?
  • Quels projets open source de robotique humanoïde Vuntum référence-t-il ?
• Comparer
  • Compare l’Unitree G1 et l’Unitree H1 : qu’est-ce qui diffère, et qu’est-ce qui n’est pas communiqué ?
  • Entre ces trois robots, lequel a la meilleure preuve pour son autonomie ?
• Prix et disponibilité
  • Combien coûte l’Unitree G1 aux États-Unis et en Chine, et à quelle date ce prix a-t-il été relevé ?
  • Ce robot est-il vendu en Europe aujourd’hui ?
• Vérifier
  • D’où vient ce chiffre d’autonomie, et est-il annoncé par le fabricant ou mesuré par un tiers ?
  • Explique-moi comment Vuntum classe ses niveaux de preuve.
• Suivre
  • Qu’est-ce qui a changé dans la base cette semaine ?
  • Quels articles récents de Vuntum parlent de robots humanoïdes ?

Clients MCP : ce que nous avons testé

Nous distinguons ce que nous avons fait tourner nous-mêmes de ce que nous recopions de la documentation du client. Les essais ont été faits depuis un serveur, le 3 octobre 2026, contre l’adresse publique du serveur (pas contre une copie locale).

Testés par nous

Claude Code

Testé : fonctionne. Le serveur a été ajouté à Claude Code, qui a appelé l’outil de prix sur l’Unitree G1 et répondu avec les deux prix (Chine et États-Unis) et leur date. Une commande suffit :

claude mcp add --transport http vuntum https://vuntum.com/mcp

Ou, pour un projet, dans le fichier .mcp.json :

{
  "mcpServers": {
    "vuntum": {
      "type": "http",
      "url": "https://vuntum.com/mcp"
    }
  }
}

Claude Desktop, par le fichier de configuration (passerelle mcp-remote)

Passerelle testée : fonctionne. Claude Desktop lit ce fichier pour lancer un programme local ; la passerelle mcp-remote relie ce programme au serveur distant. Nous avons essayé la passerelle elle-même (16 outils listés, un appel réussi), mais pas l’application Claude Desktop. Il faut Node.js. Dans l’application, ouvrez Settings > Developer > Edit Config (libellés anglais) et ajoutez :

{
  "mcpServers": {
    "vuntum": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://vuntum.com/mcp"
      ]
    }
  }
}

Votre propre programme (SDK officiel)

Testé : fonctionne. Avec le SDK TypeScript officiel (@modelcontextprotocol/sdk), vingt lignes suffisent pour lister les outils et en appeler un. Un exemple et un contrôle prêts à lancer sont dans le dépôt public du serveur.

Configuration documentée, pas encore testée par nous

Nous ne pouvons pas ouvrir ces applications depuis notre serveur. Les réglages ci-dessous suivent leur documentation ; si l’un d’eux ne marche pas chez vous, écrivez-nous et nous corrigerons la page.

claude.ai et Claude Desktop (connecteur personnalisé)

Dans Personnaliser > Connecteurs, choisissez Ajouter un connecteur personnalisé, collez l’adresse https://vuntum.com/mcp, laissez l’authentification vide, puis validez. Dans une conversation, activez-le depuis le menu +, rubrique Connecteurs. Sur les offres Team et Enterprise, un propriétaire de l’organisation l’ajoute d’abord.

ChatGPT

Les serveurs MCP distants demandent le mode développeur (Paramètres > Sécurité et connexion > Mode développeur, sur les offres qui le proposent). Créez ensuite une application avec l’adresse https://vuntum.com/mcp et Pas d’authentification. Les noms de menus changent souvent chez OpenAI : suivez son guide du mode développeur.

Cursor

Dans ~/.cursor/mcp.json (ou .cursor/mcp.json dans un projet) :

{
  "mcpServers": {
    "vuntum": {
      "url": "https://vuntum.com/mcp"
    }
  }
}

VS Code

Dans .vscode/mcp.json :

{
  "servers": {
    "vuntum": {
      "type": "http",
      "url": "https://vuntum.com/mcp"
    }
  }
}

Limites à connaître

• Au-delà de 60 requêtes par minute et par adresse IP, le serveur MCP répond 429 avec Retry-After: 60 ; l’API est limitée à 120, avec des en-têtes RateLimit-* explicites. Une session de client compte aussi l’ouverture et la liste des outils.
• Seules les données publiées sont servies. Une valeur absente veut dire que nous n’avons pas encore trouvé de source fiable, pas que la réponse est « non ».
• Pour un usage en volume, préférez l’export complet (JSON Lines ou CSV) à des milliers de requêtes.

Licence et attribution

Les données factuelles sont publiées sous licence CC BY 4.0 : vous pouvez les copier, les transformer et les redistribuer, y compris commercialement, à condition de citer la source. Les articles, guides et analyses restent protégés.

Citation attendue : Source : Vuntum (https://vuntum.com), licence CC BY 4.0, avec un lien vers la fiche concernée.

Pour le reste (exports, llms.txt, jeu de données) : Données et API. Le serveur MCP est aussi inscrit au registre officiel du protocole sous le nom com.vuntum/mcp, et son dépôt public contient les exemples de code.