O servidor TOON MCP reduz os tokens de resultado de ferramentas em 30-60% no OpenClaw.

Foi lançado um servidor MCP que comprime automaticamente resultados estruturados de ferramentas JSON no formato TOON, uma representação eficiente em tokens projetada para reduzir o uso de tokens em 30-60% para dados tabulares em sessões do OpenClaw.

Como funciona

TOON é um formato projetado para representação eficiente de dados em LLMs que usa nomes de campos declarados uma vez, indentação em vez de chaves e sem aspas redundantes. O servidor MCP compara as contagens de tokens entre TOON e JSON compacto e retorna o que for menor.

Configuração

Adicione o servidor MCP à sua configuração do OpenClaw (~/.openclaw/openclaw.json):

{
  "mcpServers": {
    "toon": {
      "command": "npx",
      "args": ["@fiialkod/toon-mcp-server"]
    }
  }
}

Adicione uma regra ao seu AGENTS.md: Quando qualquer ferramenta retornar dados JSON estruturados (arrays de objetos, respostas de API, resultados de banco de dados, logs) maiores que ~20 campos, passe o resultado pela ferramenta toon_format_response antes de analisá-lo.

Desempenho

Para dados tabulares (arrays de objetos uniformes, e-mails, eventos de calendário, resultados de pesquisa, logs, linhas de banco de dados), o TOON normalmente vence por 30-60%. Para cargas pequenas ou configurações profundamente aninhadas, ele volta para o JSON compacto.

Benchmark com 15 transações financeiras e 15 perguntas:

• JSON: 14/15 corretas (93,3%), ~749 tokens usados
• TOON: 14/15 corretas (93,3%), ~398 tokens usados

Mesma precisão com 47% menos tokens. Os erros foram em perguntas diferentes e nenhum foi causado pelo formato. O TOON foi sem perdas nos testes — decode(encode(data)) === data.

Casos de uso

Melhor para: resultados MCP do Gmail/Calendário, consultas de banco de dados, respostas de API, listagens de arquivos, logs — qualquer coisa que seja um array de objetos com chaves repetidas.

Não necessário para: cargas pequenas (<5 itens), configurações profundamente aninhadas, dados que você precisa passar como JSON bruto.

Problema que resolve

O prompt do sistema e os esquemas de ferramentas têm custos fixos altos no OpenClaw, os arquivos de workspace são semi-fixos, mas os resultados das ferramentas se acumulam rapidamente. Quando os agentes leem arquivos, consultam APIs ou navegam, isso empurra as sessões para compactação onde o contexto é perdido. O TOON funciona a montante reduzindo os resultados das ferramentas antes que entrem na transcrição, adiando a compactação e mantendo mais histórico da sessão intacto.