D2B for Agents

O D2B é o “Spreadsheets for AI Agents”. Ele recebe na entrada o Excel bagunçado dos humanos, entrega aos agentes tabelas tipadas, com row ID, versionadas e com governança, e devolve o resultado em um formato que humanos conseguem ler (xlsx / formato original). Além da resposta, dá para rastrear de onde veio cada número.

As 3 portas de entrada

Caminho	Indicado para	Primeira chamada
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 usam o shell, CI, humanos	pipx install d2b-sdk && d2b login
SDK / API	Seus próprios agentes e apps (Python / TypeScript / HTTP)	pip install d2b-sdk → Quickstart. PyPI / npm / GitHub

Os três são a mesma superfície do mesmo backend. As tools do MCP, os subcomandos da CLI, os métodos do SDK e os endpoints REST correspondem 1 para 1 — comece por qualquer um e migre para outro quando quiser.

O que é diferente

• Rastreável: tabelas derivadas nascem de transforms (SQL / Python), e o binding {{ arg }} preserva o lineage. Um code interpreter responde, mas não dá para rastrear nem reproduzir.
• Reversível: snapshot / named version / op log / undo. Agentes erram — esse é o pressuposto — e você pode restaurar para qualquer ponto no tempo.
• Protegido: mask / deny por tag de coluna × role, aplicados na camada de dados. A mesma política vale para SQL, export e MCP.
• Entregável: xlsx / csv, o arquivo original com apenas as células de valor substituídas, fórmulas vivas linha a linha, export = branch → re-import = 3-way merge.
• Versionável em git: extraia transforms, sheets, charts e tabelas base para um repositório, revise em PR e escreva de volta (Workbooks em git).

Ordem de leitura

1. Quickstart — emita um PAT e faça a primeira chamada em 5 minutos
2. Conceitos centrais — Workbook / Source / Table / Sheet / Version, lock otimista, idempotência, governança
3. O caminho que você vai usar: MCP / Agentes de codificação / CLI / SDK / Webhooks
4. Como ler os erros — problem+json e suggested_fix
5. Referência da API — gerada automaticamente a partir do OpenAPI

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