MCP proxy that compresses tool schemas — up to -98% tokens, 100% signal preserved
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"refract-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
<p align="center"> <img src="assets/logo.png" alt="Refract" width="360"> </p> # Refract > Cuts up to 98% of the tokens your AI agents spend using MCP tools — without losing anything. --- ## What it actually changes | Server | Tools | Before | After | Reduction | |---|---|---|---|---| | filesystem (Anthropic) | 14 | 1,892 tok | 236 tok | **−88%** | | sequential-thinking | 1 | 926 tok | 20 tok | **−98%** | | Google Calendar | 5 | 5,173 tok | 155 tok | **−97%** | | Enterprise (Cal + Gmail + Drive) | 12 | 8,649 tok | 882 tok | **−90%** | | sample_app.js (JavaScript) | — | 799 tok | 284 tok | **−64.5%** | | sample_app.ts (TypeScript) | — | 378 tok | 266 tok | **−29.6%** | | ast_extractor.py (Python) | — | 3,600 tok | 868 tok | **−75.9%** | Fewer tokens sent = lower API bills, faster responses. And nothing is lost. Every check confirmed tools stay 100% usable after compression. --- ## Install ```bash pip install refract-mcp ``` Optional extras: ```bash pip install refract-mcp[semantic] # semantic tool routing with embeddings pip install refract-mcp[multilang] # JavaScript, TypeScript, JSX, TSX support ``` --- ## Two modes ### Mode 1 — MCP Proxy Sits between your agent and any MCP server. Compresses tool schemas on the fly so your agent does not load the full catalogue on every request. **Local subprocess (stdio):** ```bash refract-proxy --target "npx @modelcontextprotocol/server-filesystem /tmp" --verbose ``` **Remote HTTP/SSE server:** ```bash # --url implies SSE transport (explicit, recommended for remote endpoints) refract-proxy --url https://my-mcp-server.com/sse # or with --transport flag (auto-detection can be overridden) refract-proxy --target https://my-mcp-server.com/sse --transport sse ``` **Proxy flags:** | Flag | Default | Description | |---|---|---| | `--target URL` | required | MCP target: stdio command, HTTP URL, or JSON file | | `--stdio-cmd CMD` | — | Alias for `--target` for stdio commands | | `--url URL` | — | Remote SSE/HTTP…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.