D2B for Agents

D2B, c’est « Spreadsheets for AI Agents ». Il reçoit en entrée les Excel désordonnés des humains, les présente aux agents comme des tables typées, avec ID de ligne, versionnées et gouvernées, puis rend les résultats sous une forme lisible par les humains (xlsx / format d’origine). Au-delà de la réponse, vous pouvez retracer d’où vient chaque chiffre.

Trois points d’entrée

Voie	Pour qui	Premier appel
MCP	Les hôtes MCP : Claude Code / Claude Desktop / Cursor / VS Code, etc.	claude mcp add d2b --transport http https://d2b.dev/mcp/ --header "Authorization: Bearer $PAT"
CLI	Agents pilotant un shell, CI, humains	pipx install d2b-sdk && d2b login
SDK / API	Vos propres agents et applications (Python / TypeScript / HTTP)	pip install d2b-sdk → Démarrage rapide. PyPI / npm / GitHub

Ces trois voies sont la même surface du même backend. Tools MCP, sous-commandes CLI, méthodes SDK et endpoints REST se correspondent un à un : commencez par n’importe laquelle, vous pourrez passer aux autres.

Ce qui fait la différence

• Traçable : les tables dérivées se créent par transform (SQL / Python), et les liaisons {{ arg }} conservent le lineage. Un code interpreter répond, mais sans traçabilité ni reproductibilité.
• Réversible : snapshot / named version / op log / undo. Les agents sont censés se tromper : vous pouvez restaurer n’importe quel point dans le temps.
• Protégé : les règles mask / deny (tag de colonne × rôle) sont imposées par la couche de données. La même politique vaut en SQL, à l’export et via MCP.
• Restituable : xlsx / csv, l’original Excel dont seules les cellules de valeurs sont remplacées, des formules vivantes ligne par ligne, export = branch → ré-import = 3-way merge.
• Versionnable dans git : sortez transforms, sheets, charts et tables base vers un dépôt, relisez-les en pull request et réécrivez-les (les workbooks avec git).

Ordre de lecture

1. Démarrage rapide — émettez un PAT et passez votre premier appel en 5 minutes
2. Concepts clés — Workbook / Source / Table / Sheet / Version, verrouillage optimiste, idempotence, gouvernance
3. La voie que vous utilisez : MCP / Agents de codage / CLI / SDK / Webhooks
4. Lire les erreurs — problem+json et suggested_fix
5. Référence API — générée automatiquement depuis l’OpenAPI

Index pour les agents : llms.txt / llms-full.txt / openapi.json