# Tooner

> MCP proxy that reduces token usage via TOON format

- **Type:** MCP server
- **Install:** `agentstack add mcp-chaindead-tooner`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [chaindead](https://agentstack.voostack.com/s/chaindead)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [chaindead](https://github.com/chaindead)
- **Source:** https://github.com/chaindead/tooner

## Install

```sh
agentstack add mcp-chaindead-tooner
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

[](https://github.com/punkpeye/awesome-mcp-servers?tab=readme-ov-file#communication)
[](https://github.com/chaindead/tooner?tab=readme-ov-file#installation)
[](https://opensource.org/licenses/MIT)
[](https://visitorbadge.io/status?path=https%3A%2F%2Fgithub.com%2Fchaindead%2Ftooner)

# Tooner

Tooner is a lightweight MCP wrapper that keeps your server setup unchanged, but makes model-facing responses cleaner and shorter. It rewrites JSON-heavy outputs into [TOON format](https://toonformat.dev/) so models spend fewer tokens on syntax noise (~40% fewer tokens).

- [What it does](#what-it-does)
- [Installation](#installation)
  - [Homebrew](#homebrew)
  - [NPX](#npx)
  - [From Releases](#from-releases)
    - [MacOS](#macos)
    - [Linux](#linux)
    - [Windows](#windows)
  - [From Source](#from-source)
- [Configure MCP](#configure-mcp)

## What it does

- Works with your existing MCP servers (no server rewrite required)
- Keeps the same data, but in a format models read more efficiently
- Reduces token usage on large JSON responses
- Handles many messy JSON-like outputs and still returns useful model-ready content

## Installation

### Homebrew

You can install a binary release on macOS/Linux using brew:

```bash
# Install
brew install chaindead/tap/tooner

# Update
brew upgrade chaindead/tap/tooner
```

### NPX

You can run the latest version directly using npx (supports macOS, Linux, and Windows):

```bash
npx -y @chaindead/tooner
```

When using NPX [Configure MCP (Cursor example)](#configure-mcp-cursor-example) becomes:
```json
{
  "mcpServers": {
    "telegram": {
      "command": "npx",
      "args": ["-y", "@chaindead/tooner", "memory-mcp-server-go"]
    }
  }
}
```

### From Releases

#### MacOS

> **Note:** The commands below install to `/usr/local/bin`. To install elsewhere, replace `/usr/local/bin` with your preferred directory in your PATH.

First, download the archive for your architecture:

```bash
# For Intel Mac (x86_64)
curl -L -o tooner.tar.gz https://github.com/chaindead/tooner/releases/latest/download/tooner_Darwin_x86_64.tar.gz

# For Apple Silicon (M1/M2)
curl -L -o tooner.tar.gz https://github.com/chaindead/tooner/releases/latest/download/tooner_Darwin_arm64.tar.gz
```

Then install the binary:

```bash
# Extract the binary
sudo tar xzf tooner.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/tooner

# Clean up
rm tooner.tar.gz
```

#### Linux

> **Note:** The commands below install to `/usr/local/bin`. To install elsewhere, replace `/usr/local/bin` with your preferred directory in your PATH.

First, download the archive for your architecture:

```bash
# For x86_64 (64-bit)
curl -L -o tooner.tar.gz https://github.com/chaindead/tooner/releases/latest/download/tooner_Linux_x86_64.tar.gz

# For ARM64
curl -L -o tooner.tar.gz https://github.com/chaindead/tooner/releases/latest/download/tooner_Linux_arm64.tar.gz
```

Then install the binary:

```bash
# Extract the binary
sudo tar xzf tooner.tar.gz -C /usr/local/bin

# Make it executable
sudo chmod +x /usr/local/bin/tooner

# Clean up
rm tooner.tar.gz
```

#### Windows

#### Windows
1. Download the latest release for your architecture:
    - [Windows x64](https://github.com/chaindead/tooner/releases/latest/download/tooner_Windows_x86_64.zip)
    - [Windows ARM64](https://github.com/chaindead/tooner/releases/latest/download/tooner_Windows_arm64.zip)
2. Extract the `.zip` file
3. Add the extracted directory to your PATH or move `tooner.exe` to a directory in your PATH

### From Source

Requirements:
- Go 1.26 or later
- GOBIN in PATH

```bash
go install github.com/chaindead/tooner@latest
```

## Configure MCP

Setup is the only thing you need to do: in MCP config, shift the command by one argument and insert `tooner` at the beginning.

Before:

```json
{
  "mcpServers": {
    "memory": {
      "command": "memory-mcp-server-go"
    }
  }
}
```

After:

```json
{
  "mcpServers": {
    "memory": {
      "command": "tooner",
      "args": ["memory-mcp-server-go"]
    }
  }
}
```

Another example - Postgres MCP:

```json
{
  "mcpServers": {
    "postgres": {
      "command": "tooner",
      "args": [
        "uvx",
        "postgres-mcp",
        "--access-mode=unrestricted"
      ],
      "env": {
        "DATABASE_URI": "...",
        "TOONER_LOG_PATH": "/tmp/tooner.log"
      }
    }
  }
}
```

NPX setup:

```json
{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@chaindead/tooner", "memory-mcp-server-go"]
    }
  }
}
```

That's it. From there, `tooner` launches your MCP server as a subprocess and transparently proxies traffic, replacing JSON with TOON.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [chaindead](https://github.com/chaindead)
- **Source:** [chaindead/tooner](https://github.com/chaindead/tooner)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** yes
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-chaindead-tooner
- Seller: https://agentstack.voostack.com/s/chaindead
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.