gcf-proxy
About
Drop-in MCP proxy that losslessly re-encodes JSON tool responses as GCF. 71% fewer tokens, 100% comprehension across 1,700+ LLM evaluations. Zero code changes.
Details
- Author
- blackwell-systems
- Categories
- Developer Tools, AI, API
Jump to
Setup
Install gcf-proxy in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/blackwell-systems/gcf-proxy
Follow the installation instructions in the repository README, then restart your MCP client.
Bidirectional MCP proxy that translates between JSON and GCF. Drop-in, zero changes to your server or client. Works with any structured data format.
100% comprehension on every frontier model. 29% fewer tokens than TOON, 56% fewer than JSON (2,400+ evals, 11 models, 3 providers). Nested object flattening with opt-out for open-weight models. One line change in your MCP config.
pip install gcf-proxy # PyPI npm install -g @blackwell-systems/gcf-proxy # npm go install github.com/blackwell-systems/gcf-proxy@latest # Go
Use it with any MCP client. When tools return structured JSON, the proxy re-encodes to GCF and logs savings to stderr:
gcf-proxy: get_price_history 54.0KB -> 28.1KB (48% saved) gcf-proxy: get_ticker_info 10.0KB -> 7.4KB (26% saved) gcf-proxy: get_price_history 53.8KB -> 27.9KB (48% saved) --- gcf-proxy session stats --- Tool calls rewritten: 3 JSON bytes in: 117.8KB GCF bytes out: 63.4KB Bytes saved: 54.4KB (46.2%) Est. tokens saved: ~13.6K -------------------------------
Real live stock data from Yahoo Finance. 118KB of JSON reduced to 63KB. ~13,600 tokens saved in 3 tool calls.
Addgcf-proxyin front of any MCP server command:
{ "mcpServers": { "memory": { "command": "gcf-proxy", "args": ["npx", "-y", "@modelcontextprotocol/server-memory"] } } }
Point--upstreamat any Streamable HTTP MCP server:
{ "mcpServers": { "remote": { "command": "gcf-proxy", "args": ["--upstream", "http://host:3000/mcp"] } } }
Supports JSON and SSE responses. Session ID tracking viaMcp-Session-Idis automatic.
--httpturns the proxy into a remote Streamable HTTP server:
gcf-proxy --http :9090 --session your-mcp-server
Any MCP client that supports HTTP transport connects directly. Health check at/health. Chains with--upstreamfor fully remote deployments.
Both modes are bidirectional: server responses are encoded to GCF, GCF in tool call arguments is decoded to JSON. Neither side needs to change.
Responses: Server (JSON) -> LLM (GCF)
Before: {"tool":"context_for_task","symbols":[{"qualified_name":"pkg.Auth","kind":"function","score":0.78,...},...]} After: GCF profile=graph tool=context_for_task budget=5000 tokens=1900 symbols=50 edges=20 ## targets @0 fn pkg.Auth 0.78 lsp_resolved ...
If the LLM produces GCF in a tool call argument (63% fewer output tokens), the proxy decodes it to JSON before forwarding:
LLM sends: {"tool": "process", "arguments": {"data": "GCF profile=generic\nname=Alice\nage=30\n"}} Server gets: {"tool": "process", "arguments": {"data": {"name": "Alice", "age": 30}}}
Detection is a 4-byte prefix check (GCF). Zero overhead. Non-GCF strings pass through untouched.
- Spawns your MCP server as a subprocess
- Proxies stdin/stdout between client and server
- Responses: intercepts JSON-RPC responses, re-encodes structured JSON as GCF
- Requests: scans tool call arguments for GCF strings, decodes to JSON
- Passes everything else through unchanged in both directions
Sometimes you can't. The server is a third-party binary, or it's maintained by another team, or you just don't want to add a dependency. gcf-proxy gives you the token savings without touching server code.
If you control the server, use theGCF librariesdirectly for better control over session deduplication and delta encoding.
100% general comprehension on every frontier model. 91.2% on adversarial code graphs (vs TOON 68.8%, JSON 54.1%). Wins 15/16 datasets on token benchmark.
Reproduce comprehension eval:git clone https://github.com/blackwell-systems/gcf-go && cd gcf-go/eval && GOWORK=off go test -run TestComprehension -v -timeout 0
Reproduce token benchmark:git clone https://github.com/blackwell-systems/toon && cd toon && git checkout gcf-comparison && cd benchmarks && pnpm install && pnpm benchmark:tokens
- Claude Code Plugin- one-command install for Claude Code users
- Codex Plugin- one-command install for OpenAI Codex users
- GCF Specification
- Documentation
- Cost Calculator
- Go library
- TypeScript library
- Python library
- Rust library
- Swift library
- Kotlin library
- betterthanjson.com
- jsonalternative.com
- betterthantoon.com
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
a complete and intuitive SDK for building MCP Servers, MCP Agents, and LLM integrations (OpenAI, Claude, Gemini) with minimal effort. It abstracts all the complexity of the MCP protocol, provides an intelligent agent with automatic model routing, and includes a universal client for external APIs all through a single, simple, and powerful interface. Perfect for chatbots, enterprise automation, internal system integrations, and rapid development of MCP-based ecosystems.
A lightweight, LLM-agnostic RESTful proxy that unifies multiple MCP servers under a single API.
A lightweight, LLM-agnostic RESTful proxy that unifies multiple MCP servers under a single API.
Scan codebases for LLM API calls and estimate monthly costs. Compare costs between git refs to catch cost regressions during code review.
An open-source library to connect any LLM to any MCP server, enabling the creation of custom agents with tool access.
One shared context layer for AI agents and humans — live API specs, DB schemas, and versioned contracts across repos so every agent and teammate works from the same source of truth.
The MCP server for Bitrix24 provides AI assistants with structured access to the Bitrix24 API. It delivers up-to-date method descriptions, parameters, and valid values, allowing assistants to work with precise data instead of guesswork. This reduces code errors and accelerates Bitrix24 integration development.
Local-first knowledge graph for developers. Watches project files, extracts entities and relationships via LLMs, and lets you query across projects with natural language and source citations.
Tool platform by IBM to build, test and deploy tools for any data source
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.




