Canonical: https://botbento.com/usecases/audit-agent-tool-schemas-for-token-efficient/
Format: Markdown representation of the public HTML page.

# Audit agent tool schemas for token-efficient calls

[Coding](https://botbento.com/usecases/coding/) · Intermediate

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. It proposes smaller, readable schemas and a prioritized fix list, leaving code changes to the user.

## Quick answers

**What does it do?** Review tool descriptions and sample outputs to reduce needless agent round trips. Result: Prioritized schema fix list.

**What does it need?** Tools: GitHub, Terminal, Docs. Intermediate: some setup. The prompt includes an approval step.

**How do I run it?** When you ask: Schema review request. Copy the prompt below into a bot in BotBento.

## How it works

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

## Prompt to start with

```text
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.
```

## Tools it uses

GitHub, Terminal, Docs

## Works with

BotBento

## Tags

agent-tools, schema-review, api, context-efficiency

## Source

[Bad MCP design costs your agent 5x more tokens](https://news.ycombinator.com/item?id=48407391) — Hacker News · checked 2026-11-13

Summarized in our own words. Any results described there are the authors’ own, not measured by BotBento.

Verified 2026-11-13: passed every automated gate and a second-model review (kimi-code/k3.1-pro). Automated, not human review. [How verification works](https://botbento.com/usecases/verification/)

By BotBento Editorial · Added 2026-11-13 · Updated 2026-11-13 · [Suggest a correction](https://botbento.com/contact/)

## Related use cases

- [Testing protocol servers against agent marketplace standards](https://botbento.com/usecases/testing-protocol-servers-against-agent-marketplace-standards/) — Verify tool schemas, run integration tests across AI clients, and audit marketplace submission checklists
- [Generating tool schemas from browser network traffic](https://botbento.com/usecases/generating-tool-schemas-from-browser-network-traffic/) — Turn authenticated web app network calls into reusable structured tools for automation.
- [Generating client SDKs and docs from API specs](https://botbento.com/usecases/generating-client-sdks-and-docs-from-api/) — Turn API schemas into client libraries, documentation, and agent servers automatically
