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
pip install 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-flattenuses expanded encoding for nested objects (open-weight models currently comprehend this form better; GCF still outperforms JSON either way)
Savings
JSON 2,506 bytes ~626 tokens
GCF 916 bytes ~229 tokens (63% fewer)
With session dedup (92.7% by 5th call) and delta encoding (81.2%), use the GCF libraries directly.
Benchmarks
| Eval | GCF | TOON | JSON |
|---|---|---|---|
| General comprehension | 100% | 100% | 100% |
| Adversarial code graphs (500 symbols) | 91.2% | 68.8% | 54.1% |
| Token efficiency (16 datasets) | 15/16 wins | 1/16 | baseline |
Also available on
- npm:
npm install -g @blackwell-systems/gcf-proxy - Go:
go install github.com/blackwell-systems/gcf-proxy@latest
Links
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file gcf_proxy-0.11.4-py3-none-win_arm64.whl.
File metadata
- Download URL: gcf_proxy-0.11.4-py3-none-win_arm64.whl
- Upload date:
- Size: 5.5 MB
- Tags: Python 3, Windows ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2b53784bdc3e8338ed4f06167a65804c6129216281c00d3157ea5b4b9f3ed7d2
|
|
| MD5 |
52a63b2239e7d049334a2dceb088587e
|
|
| BLAKE2b-256 |
ee2bf06994bd5eaf37e98e8771e5ba54b3616fb44c1271e682608060552b40ef
|
File details
Details for the file gcf_proxy-0.11.4-py3-none-win_amd64.whl.
File metadata
- Download URL: gcf_proxy-0.11.4-py3-none-win_amd64.whl
- Upload date:
- Size: 3.1 MB
- Tags: Python 3, Windows x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3c2f781cb09d5235770049af23564ebacc740deac560187248156208d9e98604
|
|
| MD5 |
8c9903becc3a9cf638e8e27aab127c17
|
|
| BLAKE2b-256 |
6db700c5952e65f76112485e7fe19a0eadfe5428c33e8094daaf5db015dd47db
|
File details
Details for the file gcf_proxy-0.11.4-py3-none-manylinux2014_x86_64.whl.
File metadata
- Download URL: gcf_proxy-0.11.4-py3-none-manylinux2014_x86_64.whl
- Upload date:
- Size: 6.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
669e3c4d428b8a4c3e4aff86baa8a1d5f1121883b3ded47137780e0676915a86
|
|
| MD5 |
b4c32e49dc914d4af5ab2ae59dae940a
|
|
| BLAKE2b-256 |
f2be1029c74df3493ec9057f0a31ae34102c5df9775aea1ae2e3cc6702a51499
|
File details
Details for the file gcf_proxy-0.11.4-py3-none-manylinux2014_aarch64.whl.
File metadata
- Download URL: gcf_proxy-0.11.4-py3-none-manylinux2014_aarch64.whl
- Upload date:
- Size: 5.8 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3f9cdddf7cfb552ff51eaabca491b6153d5d0932ca7cbdf551604dfceeb5c677
|
|
| MD5 |
0275d7598ed8e224e84061434ca56dd6
|
|
| BLAKE2b-256 |
0f82808beec75433fd753f5e0e4bf8d90e93b89ec34c99d667e05f76d584b27b
|
File details
Details for the file gcf_proxy-0.11.4-py3-none-macosx_11_0_arm64.whl.
File metadata
- Download URL: gcf_proxy-0.11.4-py3-none-macosx_11_0_arm64.whl
- Upload date:
- Size: 5.9 MB
- Tags: Python 3, macOS 11.0+ ARM64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
2cab0541eea78a65b4162fdfce6315abf14de10fd58264754655df998a38b2d5
|
|
| MD5 |
49ff2310eb7171ca3d6de65d0c3cd6ce
|
|
| BLAKE2b-256 |
d7329fa63e9cc76567d8395e067142fb80e2b177db7cd703a845bb91a8a95d41
|
File details
Details for the file gcf_proxy-0.11.4-py3-none-macosx_10_12_x86_64.whl.
File metadata
- Download URL: gcf_proxy-0.11.4-py3-none-macosx_10_12_x86_64.whl
- Upload date:
- Size: 6.2 MB
- Tags: Python 3, macOS 10.12+ x86-64
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.13
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fcd721578b374376777185488ed54b6c06ee18fdcc808ce284c782b26255a409
|
|
| MD5 |
c86754a3f39bdf1b66d5def3d1d63073
|
|
| BLAKE2b-256 |
8b12e620a42f313ad9efeb6ac9994ca57a82326f108a46a353d9ec967906cae6
|
