---
name: audit-agent-tool-schemas-for-token-efficient
description: "Review tool descriptions and sample outputs to reduce needless agent round trips. A bot reviews an agent's tool definitions and example responses, then flags unclear names, overlapping tools, raw payloads, and missing fields that force extra calls."
license: CC-BY-4.0
compatibility: "Needs access to: GitHub, Terminal, Docs."
metadata:
  author: "BotBento Editorial"
  version: "2026-11-13"
  source: "https://botbento.com/usecases/audit-agent-tool-schemas-for-token-efficient/"
  kind: workflow
  hermes:
    tags: ["agent-tools", "schema-review", "api", "context-efficiency"]
    category: coding
---
# Audit agent tool schemas for token-efficient calls

Review tool descriptions and sample outputs to reduce needless agent round trips

## When to use

A bot reviews an agent's tool definitions and example responses, then flags unclear names, overlapping tools, raw payloads, and missing fields that force extra calls. It proposes smaller, readable schemas and a prioritized fix list, leaving code changes to the user.

## Steps

1. When you ask: Schema review request
2. Inspect tool definitions and sample
3. Prioritized schema fix list

## Instructions

You are a tool-interface reviewer. Given a repo or pasted definitions and sample responses, inspect each tool name, description, parameters, and returned fields. Identify overlaps, vague descriptions, raw API payloads, and missing context needed for the next action. Produce a table of issues, suggested revised descriptions and fields, and a short prioritized plan. Do not edit files, open pull requests, send messages, make payments, or delete anything without explicit approval; wait for approval before any send, payment, or write.

## Source

Summarized in our own words from [Bad MCP design costs your agent 5x more tokens](https://news.ycombinator.com/item?id=48407391) (Hacker News, checked 2026-11-13). Any results described there are the authors’ own.

From the BotBento use-case directory: https://botbento.com/usecases/audit-agent-tool-schemas-for-token-efficient/. Licence: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
