context-doctor
Context and token optimizer for LLM agents: see where Claude Code, Cursor, Codex and Gemini CLI tokens go, then cut them: an every-prompt hook, smarter compaction, an autopilot proxy that edits history only when the prompt cache is cold, RAG chunk packing
No outside reports on file
context-doctor fetches arbitrary web URLs and requires API keys or tokens; restrict its folder reach, network access, and credentials before installing.
Based on public adoption and transparency signals as of Oct 19, 2026. Our opinion, not a code audit or security guarantee.
What it can access
- Local filesNo local folder access notedLOW
- Command executionNo shell command runner notedLOW
- Network reachFetches arbitrary web URLsREVIEW
- CredentialsRequires API key or tokenREVIEW
- Package sourcenpm (context-doctor)PUBLIC
Inferred from this listing’s public package details and description. Check the project’s source before installing.
Install
npx -y context-doctorEverything known
We found nothing about this project in the sources we read (last checked 2026-10-30). That does not mean it has no problems.
0 incidents · 0 advisories · 0 news articles · 0 community threads · checked 2026-10-30
Popularity grade: C (from public signals such as stars and downloads, not a code review). Graded 2026-10-20.
Sources we read: OSV, GitHub Advisory Database, CISA Known Exploited Vulnerabilities, 44 security news feeds and our incident library. Last checked 2026-10-30.
About Context Doctor
Context Doctor is an MCP server focused on Developer tools and Files & documents: Context and token optimizer for LLM agents: see where Claude Code, Cursor, Codex and Gemini CLI tokens go, then cut them: an every-prompt hook, smarter compaction, an autopilot proxy that edits history only when the prompt cache is cold, RAG chunk packing.
It is published on npm as context-doctor and hosted on GitHub at kushalp1/context-doctor (2 GitHub stars, 1,357 weekly npm downloads). Based on its public metadata, its operational scope includes: fetches arbitrary web urls, requires api key or token.
Setup
Check these steps against the project’s own instructions before running anything.
Run context-doctor with --ignore-scripts in claude_desktop_config.json or .cursor/mcp.json:
{
"mcpServers": {
"context-doctor": {
"command": "npx",
"args": ["-y", "--ignore-scripts", "context-doctor"]
}
}
}
Why this grade
Signal-based grade (2/7 points): public source code. This reflects adoption and transparency, not a code review.
Popularity and upkeep
- GitHub stars
- 2
- Weekly npm downloads
- 1.4k
- Listing last refreshed
- 2026-10-30
These are public popularity signals, not a maintenance check. Look at the repository’s commit history and open issues.
Risks to watch for
- Untrusted web content & prompt injection: Fetches arbitrary web pages or remote endpoints where hidden instructions could manipulate agent behavior. Restrict outbound domains and review tool outputs.
- Credential & token exposure: Requires API keys or secrets in configuration. Store credentials in environment variables with read-only or minimum required scopes and rotate them regularly.
- Dependency & version pinning: Distributed via npm (context-doctor). Pin an exact release version or commit SHA rather than floating tags so upstream updates are reviewed first.
How to lower the risk
Least-privilege permissions
- Give it access only to the specific folders, accounts or projects it needs, never your whole drive or admin account.
- Use a separate, limited API key or login just for this tool so you can switch it off without affecting anything else.
Network isolation
- Run it on a work computer or sandbox account, not one holding personal or company-sensitive data.
- If your IT team can, limit which websites and services it is allowed to contact.
Monitoring
- Check its activity history or logs weekly at first, and look at what it changed or sent.
- Turn on alerts for new logins or unusual usage on any account it connects to.
Red flags to watch for
- It asks for more access than its job requires, or prompts you to paste passwords.
- It suddenly updates with new owners, or starts contacting unfamiliar websites.
Questions
How do I install Context Doctor?
Run npx -y context-doctor in your terminal, or add the server entry to your claude_desktop_config.json or .cursor/mcp.json as shown in the Setup section on this page. Full setup docs and environment variables are in github.com/kushalp1/context-doctor.
Are there security reports about Context Doctor?
No reports found for this package in our research (last checked 2026-10-30). Context Doctor currently holds Grade C (Moderate risk signals) based on public adoption and transparency signals. Key risk areas to watch include untrusted web content & prompt injection:, credential & token exposure:, dependency & version pinning:.
Is Context Doctor actively maintained?
Context Doctor has 2 GitHub stars and 1.4k weekly npm downloads. Our directory data was last refreshed on 2026-10-30. Check recent commit activity, release tags, and open issues at github.com/kushalp1/context-doctor before pinning it in production.
What are alternatives to Context Doctor?
Compare Context Doctor side by side with similar MCP servers in the Related tools section on this page, or browse all MCP servers on AgentArmorHQ.
README badge and team notes
Maintain or use Context Doctor? Show its live grade in your GitHub README, docs site, or run a check from the terminal before you install.
GitHub README Markdown:
[](https://agentarmorhq.com/skills/kushalp1-context-doctor)HTML embed:
<a href="https://agentarmorhq.com/skills/kushalp1-context-doctor"><img src="https://agentarmorhq.com/api/badge/kushalp1-context-doctor" alt="AgentArmorHQ Risk Grade for Context Doctor" height="20" /></a>Terminal check:
curl -fsSL https://agentarmorhq.com/api/cli | node --input-type=module - check "kushalp1-context-doctor"Share with your security lead
Need sign-off to use context-doctor? Copy this note for Slack, a ticket or a pull request.
### AgentArmorHQ Security Review Memo: context-doctor
- **Listing URL:** https://agentarmorhq.com/skills/kushalp1-context-doctor
- **Type:** App connector
- **Risk Grade:** Grade C (Moderate risk signals)
- **Outside Security Advisories on File:** 0
- **Public Adoption:** 2 GitHub stars, 1.4k weekly npm downloads
#### Permission & Blast-Radius Signals
- **Local files:** No local folder access noted
- **Command execution:** No shell command runner noted
- **Network reach:** Fetches arbitrary web URLs
- **Credentials:** Requires API key or token
- **Package source:** npm (context-doctor)
#### Recommended Hardened Setup
- **Command:** `npx -y --ignore-scripts context-doctor`
- **Controls:** Pin an exact version in `.mcp.json`, scope access to a single workspace folder, and use a least-privilege read-only token where supported.
_Based on public adoption and transparency signals as of Oct 19, 2026. Our opinion, not a code audit or security guarantee._Key facts
- Type
- App connector
- Publisher
- kushalp1
- Source code
- github.com/kushalp1/context-doctor
- Install command
- npm install context-doctor
- Est. context load
- ~750 tokens / turn (~4 tool schemas, 0.38% of 200k context)
- Popularity
- 2 GitHub stars, 1.4k weekly npm downloads
- Last updated
- 2026-10-30
- Last graded
- 2026-10-20
Community
Discussions for Context Doctor
Ask questions or share configuration tips. Governed by our Community Rules & Terms.
No posts match this filter yet.
Be the first to ask a question or share a working tip.
Check before you install, in Claude
Your assistant answers Block, Review or No known issues for any package before it installs it.
Get this check inside Claude