TOON

MCP server for TOON encoding to reduce token usage when sending structured data to LLMs.

javascript

1

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "elminson-toon-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "toon-mcp-server"
      ]
    }
  }
}

You can run the TOON MCP Server to enable TOON-encoded data as a compact, token-efficient data exchange format for LLMs. This server exposes MCP endpoints that let you encode data to TOON, decode from TOON, analyze savings, and optimize prompts for token efficiency, helping you reduce token usage and costs when sending structured data to language models.

How to use

Set up the TOON MCP Server with an MCP client, then use the available tools to encode data to TOON, decode TOON back to JSON, analyze potential savings, and automatically convert data sections within prompts. You can use these tools from your MCP-enabled editor, IDE, or CLI integration to streamline data preparation and reduce token usage.

How to install

Prerequisites you need before running the server:

Then install the MCP server tools and configure your MCP client as shown.

// Quick start using npx without installing globally

npx -y toon-mcp-server

// Or, install globally and configure your MCP settings
npm install -g toon-mcp-server

// Example MCP settings pointing to the local server executable
{
  "mcpServers": {
    "toon": {
      "command": "toon-mcp"
    }
  }
}

Additional sections

The server can be run using different MCP configurations. The repository shows two practical stdio configurations you can use depending on how you prefer to run the server.

// Configuration 1: Run with npx (preferred for quick start)

```json
{
  "mcpServers": {
    "toon_npx": {
      "command": "npx",
      "args": ["-y", "toon-mcp-server"]
    }
  }
}

// Configuration 2: Run as a CLI command after global installation

```json
{
  "mcpServers": {
    "toon_cli": {
      "command": "toon-mcp",
      "args": []
    }
  }
}

Available tools

toon_encode

Convert data to TOON format for compact transmission. Supports formats including JSON, CSV, TSV, XML, HTML tables, and YAML.

toon_decode

Convert TOON back to JSON for easy consumption by applications or humans.

toon_analyze

Analyze data to show potential token and cost savings when encoded as TOON.

toon_optimize_prompt

Automatically locate data sections within prompts and convert them to TOON for token efficiency.