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
Metadata
1 maintainer
Release files for gcf-proxy 0.11.5
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distributions (wheels)
| File | Reset | |||
|---|---|---|---|---|
| gcf_proxy-0.11.5-py3-none-win_arm64.whl | Python 3 | none | Windows ARM64 | Details |
| gcf_proxy-0.11.5-py3-none-win_amd64.whl | Python 3 | none | Windows x86-64 | Details |
| gcf_proxy-0.11.5-py3-none-manylinux2014_x86_64.whl | Python 3 | none | Linux glibc 2.17+ x86-64 | Details |
| gcf_proxy-0.11.5-py3-none-manylinux2014_aarch64.whl | Python 3 | none | Linux glibc 2.17+ ARM64 | Details |
| gcf_proxy-0.11.5-py3-none-macosx_11_0_arm64.whl | Python 3 | none | macOS 11.0+ ARM64 | Details |
| gcf_proxy-0.11.5-py3-none-macosx_10_12_x86_64.whl | Python 3 | none | macOS 10.12+ x86-64 | Details |
Total release size: 32.7 MB
Release files / gcf_proxy-0.11.5-py3-none-win_arm64.whl
| Download URL | gcf_proxy-0.11.5-py3-none-win_arm64.whl |
|---|---|
| Size | 5.5 MB |
| Tags | Python 3 Windows ARM64 |
|
SHA-256 checksum How to use checksums |
622775fad8ee016dcf8f2cb5a2f2b7c2f1e94f9ef351a036b9c706009cb48d06
|
|
BLAKE2b-256 checksum How to use checksums |
b7531071aa9d782093997ef857b60e1e55f95df7167891c95fd1a742e6dbf13a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / gcf_proxy-0.11.5-py3-none-win_amd64.whl
| Download URL | gcf_proxy-0.11.5-py3-none-win_amd64.whl |
|---|---|
| Size | 3.1 MB |
| Tags | Python 3 Windows x86-64 |
|
SHA-256 checksum How to use checksums |
3e15b80bafc9c10dcb4172c9d89988073fa75a3a0ce27dd14c293bd6c5dcc06c
|
|
BLAKE2b-256 checksum How to use checksums |
b68637f596356b1848144b69ae09001977718a1d97de8dd99e1bb2090cf7e984
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / gcf_proxy-0.11.5-py3-none-manylinux2014_x86_64.whl
| Download URL | gcf_proxy-0.11.5-py3-none-manylinux2014_x86_64.whl |
|---|---|
| Size | 6.2 MB |
| Tags | Linux glibc 2.17+ x86-64 Python 3 |
|
SHA-256 checksum How to use checksums |
7a0e2933ba3c57a340f70b90e072267c5bc39f92d8d2d1a32d65e788e4172bb9
|
|
BLAKE2b-256 checksum How to use checksums |
be1c01d3195c401112e42044979b1285a377b53cfb6d113a29658051403918d0
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / gcf_proxy-0.11.5-py3-none-manylinux2014_aarch64.whl
| Download URL | gcf_proxy-0.11.5-py3-none-manylinux2014_aarch64.whl |
|---|---|
| Size | 5.8 MB |
| Tags | Linux glibc 2.17+ ARM64 Python 3 |
|
SHA-256 checksum How to use checksums |
df670bbead27854ac8ab928f506cdd1b80fe22de85d38374218a8a870005555a
|
|
BLAKE2b-256 checksum How to use checksums |
e8286732964b9ec5989c108081c22b14e0ad11bb9d5c8eb3e6603fbec563e929
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / gcf_proxy-0.11.5-py3-none-macosx_11_0_arm64.whl
| Download URL | gcf_proxy-0.11.5-py3-none-macosx_11_0_arm64.whl |
|---|---|
| Size | 5.9 MB |
| Tags | Python 3 macOS 11.0+ ARM64 |
|
SHA-256 checksum How to use checksums |
5137116cf1e16b25da13e5e0531a5c24c75f5b10c6c9611c40d30357adff6878
|
|
BLAKE2b-256 checksum How to use checksums |
df8af46f89b64dd487fd22f86f824e4a6e9d3cc631800f321b38c42c9d962601
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Release files / gcf_proxy-0.11.5-py3-none-macosx_10_12_x86_64.whl
| Download URL | gcf_proxy-0.11.5-py3-none-macosx_10_12_x86_64.whl |
|---|---|
| Size | 6.2 MB |
| Tags | Python 3 macOS 10.12+ x86-64 |
|
SHA-256 checksum How to use checksums |
3c8177b6e7c583fddeb0eda1aabddea468a6f15b871e6de44500456786027ac9
|
|
BLAKE2b-256 checksum How to use checksums |
24d99d06669b92300435800826a292842eda1f61f41dae6bfe66be962d2ae461
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.12.13
|
Security for gcf-proxy 0.11.5
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
