{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_sg6jm3gp8cvm","handle":"refract-mcp","url":"https://wellknown.network/agents/refract-mcp","links":{"self":"https://wellknown.network/agents/refract-mcp/record.json","html":"https://wellknown.network/agents/refract-mcp","markdown":"https://wellknown.network/agents/refract-mcp/record.md","api":"https://wellknown.network/api/v1/agents/refract-mcp","status":"https://wellknown.network/api/v1/agents/refract-mcp/status","claim":"https://wellknown.network/agents/refract-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/refract-mcp/claim.json","badge":"https://wellknown.network/agents/refract-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/refract-mcp/history","tools":"https://wellknown.network/api/v1/agents/refract-mcp/tools"},"ard":{"identifier":"urn:air::server:refract-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"refract-mcp","summary":"MCP proxy that compresses tool schemas — up to -98% tokens, 100% signal preserved","description":"<p align=\"center\">\n  <img src=\"assets/logo.png\" alt=\"Refract\" width=\"360\">\n</p>\n\n# Refract\n\n> Cuts up to 98% of the tokens your AI agents spend using MCP tools — without losing anything.\n\n---\n\n## What it actually changes\n\n| Server | Tools | Before | After | Reduction |\n|---|---|---|---|---|\n| filesystem (Anthropic) | 14 | 1,892 tok | 236 tok | **−88%** |\n| sequential-thinking | 1 | 926 tok | 20 tok | **−98%** |\n| Google Calendar | 5 | 5,173 tok | 155 tok | **−97%** |\n| Enterprise (Cal + Gmail + Drive) | 12 | 8,649 tok | 882 tok | **−90%** |\n| sample_app.js (JavaScript) | — | 799 tok | 284 tok | **−64.5%** |\n| sample_app.ts (TypeScript) | — | 378 tok | 266 tok | **−29.6%** |\n| ast_extractor.py (Python) | — | 3,600 tok | 868 tok | **−75.9%** |\n\nFewer tokens sent = lower API bills, faster responses. And nothing is lost. Every check confirmed tools stay 100% usable after compression.\n\n---\n\n## Install\n\n```bash\npip install refract-mcp\n```\n\nOptional extras:\n\n```bash\npip install refract-mcp[semantic]   # semantic tool routing with embeddings\npip install refract-mcp[multilang]  # JavaScript, TypeScript, JSX, TSX support\n```\n\n---\n\n## Two modes\n\n### Mode 1 — MCP Proxy\n\nSits 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.\n\n**Local subprocess (stdio):**\n\n```bash\nrefract-proxy --target \"npx @modelcontextprotocol/server-filesystem /tmp\" --verbose\n```\n\n**Remote HTTP/SSE server:**\n\n```bash\n# --url implies SSE transport (explicit, recommended for remote endpoints)\nrefract-proxy --url https://my-mcp-server.com/sse\n\n# or with --transport flag (auto-detection can be overridden)\nrefract-proxy --target https://my-mcp-server.com/sse --transport sse\n```\n\n**Proxy flags:**\n\n| Flag | Default | Description |\n|---|---|---|\n| `--target URL` | required | MCP target: stdio command, HTTP URL, or JSON file |\n| `--stdio-cmd CMD` | — | Alias for `--target` for stdio commands |\n| `--url URL` | — | Remote SSE/HTTP…","publisher":null,"homepage":null,"repository":null,"version":"0.7.0","license":"MIT License\n        \n        Copyright (c) 2025 Refract.ai cont…","protocols":["mcp"],"tags":["mcp","llm","proxy","token-optimization","claude","anthropic"],"pricing":null,"endpoints":[{"url":"pypi:refract-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.filesystem","name":"Filesystem","confidence":0.882,"provenance":"derived"},{"slug":"productivity.calendar","name":"Calendar & Scheduling","confidence":0.871,"provenance":"derived"}],"categories":["dev","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"refract-mcp","registry":"pypi","observedAt":"2026-11-03T23:22:56.543Z","publishedAt":"2026-07-01T00:46:14.118591Z","latestVersion":"0.7.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"refract-mcp","url":"https://pypi.org/project/refract-mcp/","firstSeenAt":"2026-09-10T11:26:34.341Z","fetchedAt":"2026-11-03T23:21:41.548Z","normalizedAt":"2026-11-03T23:21:41.548Z"}]},"firstSeenAt":"2026-09-10T11:26:34.341Z","updatedAt":"2026-11-03T23:22:56.543Z"}