
Smart Context Mcp
If you're burning tokens on full file reads and massive grep results, this MCP gives you compressed alternatives. It indexes your codebase and exposes tools like smart_read (outline or focused chunks), smart_search (ranked, limited results), and smart_context (curated multi-file context). The real win is task checkpoints that persist between sessions so you don't re-explain the same context. Ships with workflow metrics showing 85-90% token reduction on debugging and refactoring tasks, though that requires multi-file work where you actually need the index. For single-file edits or when you already know what to touch, native tools are faster. Includes a reactive file watcher, semantic search via local embeddings, and declarative playbooks that chain multiple operations in one call.
- GitHub stars
- 4
- tools
- 15
- transport
- STDIO
- last updated
- Sep 18, 2026
Tools
15 toolsPublic tool metadata for what this MCP can expose to an agent.
smart_readRead files in compressed modes instead of loading full content.
Read files in compressed modes instead of loading full content.
No parameter schema in public metadata yet.
smart_searchIntent-aware code search with ranked, deduplicated results and index boosting.
Intent-aware code search with ranked, deduplicated results and index boosting.
No parameter schema in public metadata yet.
smart_contextOne-call context builder: search + read + graph expansion.
One-call context builder: search + read + graph expansion.
No parameter schema in public metadata yet.
build_indexBuild a symbol index for the project (functions, classes, imports).
Build a symbol index for the project (functions, classes, imports).
No parameter schema in public metadata yet.
smart_metricsInspect token savings and usage statistics.
Inspect token savings and usage statistics.
No parameter schema in public metadata yet.
smart_summaryMaintain compressed task state across sessions.
Maintain compressed task state across sessions.
No parameter schema in public metadata yet.
smart_doctorRun one operational preflight across repo hygiene, SQLite health, compaction, and legacy cleanup.
Run one operational preflight across repo hygiene, SQLite health, compaction, and legacy cleanup.
No parameter schema in public metadata yet.
smart_statusDisplay current session context with progress visibility.
Display current session context with progress visibility.
No parameter schema in public metadata yet.
smart_editBatch edit multiple files with pattern replacement.
Batch edit multiple files with pattern replacement.
No parameter schema in public metadata yet.
smart_turnOrchestrate turn start/end with automatic task checkpoint recovery.
Orchestrate turn start/end with automatic task checkpoint recovery.
No parameter schema in public metadata yet.
smart_read_batchRead multiple files in one call.
Read multiple files in one call.
No parameter schema in public metadata yet.
smart_shellSafe diagnostic command execution (allowlisted commands only).
Safe diagnostic command execution (allowlisted commands only).
No parameter schema in public metadata yet.
warm_cachePreload frequently accessed files into OS cache.
Preload frequently accessed files into OS cache.
No parameter schema in public metadata yet.
git_blameFunction-level code attribution.
Function-level code attribution.
No parameter schema in public metadata yet.
cross_projectShare context across monorepos and microservices.
Share context across monorepos and microservices.
No parameter schema in public metadata yet.
Sponsors
Readme
smart-context-mcp
MCP server that reduces AI agent token usage by up to 90% through intelligent context compression (measured on this project).
What it is
An MCP (Model Context Protocol) server that provides specialized tools for reading, searching, and managing code context efficiently. Instead of loading full files or returning massive search results, it compresses information while preserving what matters for the task.
Details
- Repository
- github.com/arrayo/smart-context-mcp
- Categories
- AI & LLM Tools, Productivity & Office
- Package
smart-context-mcp- Transport
- STDIO
- Registry
- MCP registry, active