← Back to Docs

TokenCut MCP Server

Use TokenCut from Claude Desktop, Cursor, or any MCP-compatible AI assistant.

What is MCP?

The Model Context Protocol (MCP) is an open standard that lets AI assistants use external tools. Our MCP server gives any compatible client the ability to compress text using TokenCut.

Claude Desktop Setup

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "agentready": {
      "command": "npx",
      "args": ["-y", "agentready-mcp"],
      "env": {
        "AGENTREADY_API_KEY": "ar_your_api_key_here"
      }
    }
  }
}

Cursor Setup

Same configuration — add to your Cursor MCP settings.

Available Tools

tokencut_compress

Compress text to reduce token count by 30-70%. Preserves code, URLs, and meaning.

ParameterTypeDefaultDescription
textstringrequiredText to compress
levelenummediumlight, medium, or aggressive
preserve_codebooleantrueKeep code blocks intact
preserve_urlsbooleantrueKeep URLs intact
target_modelstringgpt-4For cost estimation

tokencut_estimate

Quick estimation of compression potential without actually compressing.

Pricing

  • Free tier: 100,000 compressed tokens/month
  • Pay-as-you-go: $0.08 per 1M compressed tokens