{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_6yejq9286uf9","handle":"mcp-token-saver","url":"https://wellknown.network/agents/mcp-token-saver","links":{"self":"https://wellknown.network/agents/mcp-token-saver/record.json","html":"https://wellknown.network/agents/mcp-token-saver","markdown":"https://wellknown.network/agents/mcp-token-saver/record.md","api":"https://wellknown.network/api/v1/agents/mcp-token-saver","status":"https://wellknown.network/api/v1/agents/mcp-token-saver/status","claim":"https://wellknown.network/agents/mcp-token-saver/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-token-saver/claim.json","badge":"https://wellknown.network/agents/mcp-token-saver/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-token-saver/history","tools":"https://wellknown.network/api/v1/agents/mcp-token-saver/tools"},"ard":{"identifier":"urn:air::server:mcp-token-saver","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-token-saver","summary":"Semantically filter MCP tool catalogs to cut LLM input-token costs. Ships with AWS Bedrock defaults; bring-your-own provider supported.","description":"# mcp-token-saver\n\n<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/victorTAKI/mcp-token-saver/main/docs/icon.png\" alt=\"mcp-token-saver logo\" width=\"140\"/>\n</p>\n\n**Install on your MCP gateway to reduce input-token costs at scale.**\n\nWhen an LLM agent connects to an MCP server exposing many tools (e.g. 200), the full tool catalog is injected into every LLM call, consuming thousands of input tokens per turn.\n<p align=\"center\">\n  <img src=\"https://raw.githubusercontent.com/victorTAKI/mcp-token-saver/main/docs/demo.gif\" alt=\"mcp-token-saver demo\" width=\"720\"/>\n</p>\n`mcp-token-saver` sits on the gateway and semantically filters that catalog per user query, keeping only the most relevant tools. Result: **80-95% input-token reduction**.\n\n> ⚠️ **Ships with AWS Bedrock defaults.** Real-semantic embeddings (Titan Embed v2) and the LLM router (Claude Haiku) require AWS credentials. Using OpenAI, Vertex, HuggingFace, or a local model? Fully supported — jump to [Not using Bedrock?](#not-using-bedrock) for a 10-line BYO example.\n\n## Install\n\nThe package ships with three install profiles depending on what you want to plug in.\n\n```bash\n# Minimal\npip install mcp-token-saver\n\n# Recommended: real semantic embeddings via AWS Bedrock (Titan Embed v2).\n# TokenSaver.default() auto-picks Bedrock when AWS_ACCESS_KEY_ID (or AWS_PROFILE\n# / AWS_ROLE_ARN) is set in the environment.\npip install \"mcp-token-saver[bedrock]\"\n\n# Adds the FAISS-backed vector store (recommended when your catalog is huge).\npip install \"mcp-token-saver[faiss]\"\n\n# Everything (Bedrock + FAISS):\npip install \"mcp-token-saver[all]\"\n```\n\nOr from GitHub directly:\n\n```bash\npip install \"mcp-token-saver[all] @ git+https://github.com/victorTAKI/mcp-token-saver.git\"\n```\n\n> **Using a non-Bedrock LLM provider (OpenAI, Vertex, local models, …)?**\n>\n> `TokenSaver.default()` auto-picks Bedrock for embeddings (Titan Embed v2) and Bedrock for the LLM router (Claude Haiku). To use another provider:\n>\n> - **Custom LLM route…","publisher":null,"homepage":"https://github.com/victorTAKI/mcp-token-saver","repository":"https://github.com/victorTAKI/mcp-token-saver/blob/main/CHANGELOG.md","version":"0.1.1","license":"MIT","protocols":["mcp"],"tags":["agent","anthropic","bedrock","cost","embeddings","llm","mcp","openai","routing","token","tools"],"pricing":null,"endpoints":[{"url":"pypi:mcp-token-saver","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"declared"},{"slug":"ai.model-access","name":"Model Access","confidence":1,"provenance":"derived"},{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":0.779,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["ai","commerce","data","dev"],"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":"mcp-token-saver","registry":"pypi","observedAt":"2026-11-03T16:26:08.657Z","publishedAt":"2026-07-09T20:58:43.027869Z","latestVersion":"0.1.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-token-saver","url":"https://pypi.org/project/mcp-token-saver/","firstSeenAt":"2026-09-10T05:21:19.384Z","fetchedAt":"2026-11-03T16:25:12.248Z","normalizedAt":"2026-11-03T16:25:12.248Z"}]},"firstSeenAt":"2026-09-10T05:21:19.384Z","updatedAt":"2026-11-03T16:26:08.657Z"}