@blackwell-systems/gcf-proxy

gcf-proxy

Bidirectional MCP proxy that translates between GCF and JSON. Drop-in, zero code changes to your server or client.

50-92% fewer tokens. 100% comprehension on every frontier model and 3 providers. 2,400+ LLM evaluations. Zero training.

Docs: gcformat.com · Proxy Guide · Playground · GCF vs TOON

Install

npm install -g @blackwell-systems/gcf-proxy

Setup (one line change)

Before:

{"mcpServers": {"yours": {"command": "your-mcp-server"}}}

After:

{"mcpServers": {"yours": {"command": "gcf-proxy", "args": ["your-mcp-server"]}}}

Works with Claude Code, Claude Desktop, VS Code, Cursor, and any MCP client.

What it does

Translates in both directions:

Responses:  Your Server (JSON) -> gcf-proxy encodes -> LLM reads GCF   (50-92% savings)
Requests:   LLM writes GCF    -> gcf-proxy decodes -> Your Server (JSON) (63% output savings)

• Responses: JSON tool results from the server are encoded as GCF
• Requests: GCF strings in tool call arguments are decoded to JSON (4-byte prefix check, zero overhead)
• Non-convertible content passes through unchanged in both directions
• Neither the server nor the client needs to know about GCF
• --no-flatten uses expanded encoding for nested objects (open-weight models currently comprehend this form better; GCF still outperforms JSON either way)

Benchmarks

Eval	GCF	TOON	JSON
General comprehension	100%	100%	100%
Adversarial code graphs (500 symbols)	91.6%	66.9%	54.6%
Token efficiency (16 datasets)	15/16 wins	1/16	baseline

Also available on

• PyPI: pip install gcf-proxy
• Go: go install github.com/blackwell-systems/gcf-proxy@latest

Links

• Full Setup Guide
• GCF Specification
• GCF vs TOON
• GitHub