# smart-context-mcp

MCP server that reduces agent token usage by 90% with intelligent context compression, task checkpoint persistence, and workflow-aware agent guidance.

- **Type:** MCP server
- **Trust:** 60/100 (B), scored on the package rubric
- **Verification:** community-indexed — nobody has claimed this listing
- **Version:** 1.21.0
- **Author:** Francisco Caballero Portero
- **License:** MIT
- **npm:** smart-context-mcp
- **Source:** https://github.com/Arrayo/smart-context-mcp
- **Compatible clients:** claude-code, cursor, copilot, gemini (basis: transport)

## Trust

60/100 (B), scored on the package rubric
- Publisher verified: no
- Install scripts: nothing suspicious found
- Prompt-injection scan: not run
- Obfuscation scan: not run
- Evidence age: 0 days

## Security scan

- **Status:** clean
- **Scanned:** 2026-09-18T09:42:19.617Z
- **Version scanned:** 1.21.0
- **CVEs:** none found by OSV at scan time

## Tools

22 declared. Statically extracted from the shipped source — a floor on the surface, not a census.
- `smart_read`
- `smart_read_batch` — Read multiple files in one call. Each item accepts path, mode (prefer outline/signatures/symbol/explain — full saves 0 tokens), symbol, startLine, endLine, maxT
- `smart_search`
- `smart_context`
- `smart_shell` — Run a diagnostic shell command from an allowlist. Allowed: pwd, ls, find, rg, git (status/diff/show/log/branch/rev-parse), npm/pnpm/yarn/bun (test/run/lint/buil
- `smart_test`
- `smart_review`
- `smart_code`
- `smart_output`
- `smart_playbook`
- `global_memory`
- `build_index` — Build a lightweight symbol index for the project. Speeds up smart_search ranking and smart_read symbol lookups. Pass incremental=true to only reindex files with
- `warm_cache` — Preload frequently accessed files into OS cache to reduce cold-start latency. Analyzes last 30 days of access patterns and warms the top 50 most-used files (con
- `git_blame` — Get symbol-level git blame attribution. Modes: symbol (blame for specific file symbols), file (aggregated file stats), author (find symbols by author), recent (
- `cross_project` — Work with multiple related projects (monorepos, microservices, shared libraries). Modes: discover (list related projects), search (search across projects), read
- `smart_summary`
- `smart_status` — Display the current session context including goal, status, recent decisions, touched files, and progress. Returns a formatted summary of what has been done and
- `smart_doctor` — Run an operational health check for local devctx state. Aggregates repo hygiene, SQLite `storageHealth`, retention/compaction hygiene, and legacy JSON/JSONL cle
- `smart_edit` — Batch edit multiple files with pattern replacement. Supports literal string replacement or regex patterns. Use for bulk refactoring, removing patterns (comments
- `smart_turn`
- `smart_resume` — Lightweight entry point for the first prompt of a substantial task. Equivalent to smart_turn(phase=start, ensureSession=true, verbosity=minimal): rehydrates the
- `smart_metrics`

## Install

**Verdict: review** — Installable, but 1 thing to check first: No publisher has proved control of this listing; it is indexed, not vouched for.
**Cautions** (coverage gaps and advisories — never blocking)
- No publisher has proved control of this listing; it is indexed, not vouched for.
**Config** (claude-code):
```json
"{\n  \"mcpServers\": {\n    \"smart-context\": {\n      \"command\": \"npx\",\n      \"args\": [\n        \"-y\",\n        \"smart-context-mcp\"\n      ]\n    }\n  }\n}"
```

## Blast radius

Extensive to critical — no credential declaration found, from the publisher, the upstream registry, or the README. Known so far: runs commands; runs on your machine.
- Floor 45, ceiling 73 (tier: unknown)
- `unknown` means the floor and ceiling land in different bands — not measured enough to name one. It does not mean low.
- This is impact, not likelihood. A high radius is not a defect: a filesystem server is supposed to write files. It is never part of the trust score.

## Machine-readable views of this entry

- Signed JSON: https://forgeregistry.com/api/v1/packages/smart-context-mcp
- Install plan: https://forgeregistry.com/api/v1/packages/smart-context-mcp/install-plan
- Alternatives: https://forgeregistry.com/api/v1/alternatives/smart-context-mcp
- HTML page: https://forgeregistry.com/registry/smart-context-mcp
- MCP: POST https://forgeregistry.com/api/mcp → `forge_get_package` / `forge_install_plan`

## About this document

Generated by Forge (https://forgeregistry.com) — a compact rendering of the same record served, signed, at the JSON URL above. Trust and scan facts are the registry's own measurements; anything Forge did not measure is named as unmeasured rather than omitted.