Skip to main content
UseAgents supports multiple response encodings so you can optimize for scripts, humans, or LLM token budgets. Toon (Token-Oriented Object Notation) is a compact, human-readable encoding designed for LLM tool results. Prefer it when an agent will consume the payload; prefer JSON when a conventional HTTP client or script will parse it. Error responses on the API stay JSON even when format=toon, so clients can always parse failures the same way.

​
REST API

Add format=toon or format=json (default) to any tools endpoint:
When format=toon, the response body is Toon text with Content-Type: text/toon; charset=utf-8. See also Tools Search and Tools Docs Search.

​
MCP

Each tool accepts an optional format argument. Omit it to keep the default (toon):
Applies to search_tools, get_tool_context, search_docs, and test_tool.

​
CLI

--format wins over --json and over the pipe default. See UseAgents CLI.