D2B for Agents

D2B es “Spreadsheets for AI Agents”. Recibe en la entrada el Excel desordenado de los humanos, se lo entrega a los agentes como tablas tipadas, con ID de fila, versionadas y con gobernanza, y devuelve los resultados en una forma legible para las personas (xlsx / formato original). No solo da la respuesta: también se puede rastrear de dónde salió cada número.

Las 3 vías de entrada

Vía	Para quién	La primera llamada
MCP	Hosts MCP como Claude Code / Claude Desktop / Cursor / VS Code	`claude mcp add d2b --transport http https://d2b.dev/mcp/ --header "Authorization: Bearer $PAT"`
CLI	Agentes que usan la shell, CI, humanos	`pipx install d2b-sdk && d2b login`
SDK / API	Agentes y aplicaciones propios (Python / TypeScript / HTTP)	`pip install d2b-sdk` → Inicio rápido. PyPI / npm / GitHub

Las tres son la misma superficie del mismo backend. Las herramientas de MCP, los subcomandos de la CLI, los métodos del SDK y los endpoints REST se corresponden 1 a 1: puedes empezar por cualquiera y pasar luego a las demás.

Qué lo hace diferente

Se puede rastrear: las tablas derivadas se crean con transforms (SQL / Python) y los bindings {{ arg }} dejan lineage. Un code interpreter responde, pero no se puede rastrear ni reproducir.
Se puede revertir: snapshot / named version / op log / undo. Se parte de que los agentes se equivocan: puedes restaurar a cualquier punto en el tiempo.
Se puede proteger: mask / deny por etiqueta de columna × rol, forzados en la capa de datos. La misma política aplica en SQL, en export y en MCP.
Se puede devolver: xlsx / csv, el archivo original con solo sus celdas de valores reemplazadas, fórmulas vivas por fila, export = branch → re-import = 3-way merge.
Se puede poner en git: extrae transforms, sheets, charts y tablas base a un repositorio, revísalos por pull request y escríbelos de vuelta (Gestionar workbooks con git).

Orden de lectura

Inicio rápido — emite un PAT y haz tu primera llamada en 5 minutos
Conceptos centrales — Workbook / Source / Table / Sheet / Version, bloqueo optimista, idempotencia, gobernanza
La vía que vayas a usar: MCP / Agentes de programación / CLI / SDK / Webhooks
Cómo leer los errores — problem+json y suggested_fix
Referencia de la API — generada automáticamente desde OpenAPI

Índices para agentes: llms.txt / llms-full.txt / openapi.json