How do I use ai-context-inspector?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ai-context-inspector scan my project for all AI configurations" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

ai-context-inspector

by cocaxcode

Overview Schema Related Servers Score Discussions

TypeScript

The most comprehensive AI ecosystem scanner available. AI Context Inspector discovers every AI configuration file, MCP server, custom skill, agent, and persistent memory in your project — across 19 tools — and gives you the full picture in seconds. Export your entire AI setup and import it into any of 7 supported tools (Claude, Cursor, Windsurf, Copilot, Gemini, Codex, OpenCode) with automatic secret redaction. Zero config. Zero runtime dependencies beyond MCP SDK and Zod. Everything runs locally — your configs and credentials never leave your machine.

Quick Start

npx -y @cocaxcode/ai-context-inspector@latest

That's it. An HTML dashboard opens with everything your AI tools know about your project.

# Scan a specific directory
npx -y @cocaxcode/ai-context-inspector@latest --dir /path/to/project

# Include user-level configs (~/.claude, ~/.gemini, etc.)
npx -y @cocaxcode/ai-context-inspector@latest --user

# Live-connect to each MCP server and list its tools
npx -y @cocaxcode/ai-context-inspector@latest --introspect

# Output raw JSON instead of HTML
npx -y @cocaxcode/ai-context-inspector@latest --json

Flag	Description	Default
`--dir <path>`	Directory to scan	`.` (current)
`--user`	Include user-level configs (`~/`)	`false`
`--introspect`	Connect to MCP servers and list tools	`false`
`--timeout <ms>`	Introspection timeout per server	`10000`
`--json`	Output JSON instead of HTML	`false`
`--mcp`	Run as MCP server (stdio transport)	`false`

Related MCP server: Mother MCP Skills

MCP Server Setup

Run as an MCP server so your AI tools can inspect their own ecosystem.

Claude Code

claude mcp add --scope user ai-context-inspector -- npx -y @cocaxcode/ai-context-inspector@latest --mcp

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "ai-context-inspector": {
      "command": "npx",
      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
    }
  }
}

Cursor / Windsurf — add to .cursor/mcp.json or equivalent:

{
  "mcpServers": {
    "ai-context-inspector": {
      "command": "npx",
      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
    }
  }
}

VS Code — add to .vscode/mcp.json:

{
  "servers": {
    "ai-context-inspector": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
    }
  }
}

Codex CLI:

codex mcp add ai-context-inspector -- npx -y @cocaxcode/ai-context-inspector@latest --mcp

Or add directly to any .mcp.json:

{
  "mcpServers": {
    "ai-context-inspector": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@cocaxcode/ai-context-inspector@latest", "--mcp"]
    }
  }
}

What It Detects

Tool	Context Files	What's Found
Claude Code	`CLAUDE.md`, `.claude/`, `.mcp.json`	Instructions, MCP config, skills, agents, memory
Cursor	`.cursorrules`, `.cursor/rules/`, `.cursorignore`	Rules, ignore patterns
Windsurf	`.windsurfrules`, `.windsurf/rules/`	Codeium/Windsurf rules
GitHub Copilot	`.github/copilot-instructions.md`, `.github/agents/`	Instructions, custom agents
Gemini CLI	`GEMINI.md`, `.gemini/`, `.geminiignore`	Config, rules
OpenAI Codex	`AGENTS.md`, `AGENT.md`, `.codex/`	Agent instructions
OpenCode	`OPENCODE.md`, `.opencode/`, `opencode.json`	CLI config
Aider	`.aider.conf.yml`, `.aiderignore`	Config, model settings
Cline	`.clinerules`, `.clineignore`	Rules (file or directory)
Roo Code	`.roo/rules/`, `.roorules`, `.rooignore`	Rules
Continue.dev	`.continuerules`, `.continue/config.yaml`	Rules, config
Amazon Q	`.amazonq/rules/`	Developer rules
Augment	`.augment/rules/`, `.augment-guidelines`	Code rules
Replit	`.replit.md`	Agent instructions
Firebase Studio	`.idx/airules.md`	AI rules
VS Code	`.vscode/mcp.json`	MCP configuration
Tabnine	`.tabnine.yaml`	AI config
Sourcegraph	`.sourcegraph/`	Cody config
Universal	`CONVENTIONS.md`	Multi-tool conventions

Tip: Pass --user to also scan user-level configs: ~/.claude/, ~/.gemini/, ~/.codex/, ~/.continue/, ~/.aider.conf.yml, ~/.augment/, ~/.github/agents/, ~/.codeium/, ~/.opencode/, ~/.tabnine/.

Beyond context files, the scanner also detects:

MCP servers from .mcp.json, ~/.claude.json, .vscode/mcp.json, Claude Desktop config — with optional live introspection
Custom skills in .claude/skills/ (including symlinks from npx skills add)
Custom agents in .claude/agents/ with memory detection
Persistent memories — Claude Memory, agent memory, engram, OpenSpec, ATL

Features

Scan

npx -y @cocaxcode/ai-context-inspector@latest
npx -y @cocaxcode/ai-context-inspector@latest --user --introspect

Generates a self-contained HTML dashboard with dark/light mode, search, collapsible sections, file previews, and color-coded tool badges. Pass --json for raw output.

Export

# Export your AI ecosystem to .aci/bundle.json
npx -y @cocaxcode/ai-context-inspector@latest export

# Export only MCP and context configs, redact secrets
npx -y @cocaxcode/ai-context-inspector@latest export --only mcp,context --secrets none

Flag	Description	Default
`--dir <path>`	Directory to export	`.`
`--output <path>`	Output directory	`.aci/`
`--include-user`	Include user-level configs	`false`
`--only <categories>`	Filter: `mcp,skills,agents,memories,context`	all
`--secrets <mode>`	`none` (redact) or `all` (include)	interactive

Import

# Import into a Cursor project
npx -y @cocaxcode/ai-context-inspector@latest import --target cursor

# Auto-detect tool, skip confirmation, overwrite existing
npx -y @cocaxcode/ai-context-inspector@latest import --yes --force

Flag	Description	Default
`[file]`	Path to bundle JSON	auto-detect `.aci/bundle.json`
`--dir <path>`	Target directory	`.`
`--target <tool>`	Target tool (see table)	auto-detect
`--scope <scope>`	`project` or `user`	per-resource
`--force`	Overwrite existing resources	`false`
`--yes`	Skip confirmation prompt	`false`
`--only <categories>`	Filter: `mcp,skills,agents,memories,context`	all
`--secrets <mode>`	`none` or `all`	interactive

Supported Import Targets

Target	MCP Config	Context File	Rules Dir	Skills	Agents
`claude`	`.mcp.json`	`CLAUDE.md`	--	`.claude/skills/`	`.claude/agents/`
`cursor`	`.cursor/mcp.json`	`.cursorrules`	`.cursor/rules/`	--	--
`windsurf`	`.mcp.json`	`.windsurfrules`	`.windsurf/rules/`	--	--
`copilot`	`.vscode/mcp.json`	`.github/copilot-instructions.md`	`.github/instructions/`	--	`.github/agents/`
`gemini`	`.gemini/settings.json`	`GEMINI.md`	`.gemini/rules/`	--	--
`codex`	`.mcp.json`	`AGENTS.md`	`.codex/rules/`	--	--
`opencode`	`opencode.json`	`OPENCODE.md`	`.opencode/rules/`	--	--

Note: Secrets handling has three modes: none (redact all — safe for sharing), all (include as-is), or interactive (prompt per variable, CLI default). Environment variables in MCP configs are detected automatically.

MCP Tool Reference

When running as an MCP server (--mcp), five tools are exposed:

`scan`

Discover the complete AI ecosystem in a project directory.

Parameter	Type	Required	Description
`directory`	string	No	Path to scan (default: cwd)
`include_user`	boolean	No	Include user-level configs
`introspect`	boolean	No	Live-connect to MCP servers
`timeout`	number	No	Introspection timeout (ms)

`introspect_mcp`

Connect to a specific MCP server and list its tools, resources, and prompts.

Parameter	Type	Required	Description
`command`	string	Yes*	Command to launch the server
`args`	string[]	No	Arguments for the command
`env`	object	No	Environment variables
`url`	string	Yes*	URL for HTTP/SSE servers
`transport`	string	No	`stdio` (default) or `http`
`timeout`	number	No	Connection timeout (ms)

*Either command (stdio) or url (http) is required.

`generate_report`

Generate a standalone HTML dashboard from scan results.

Parameter	Type	Required	Description
`directory`	string	No	Path to scan
`include_user`	boolean	No	Include user-level configs
`introspect`	boolean	No	Introspect MCP servers
`timeout`	number	No	Introspection timeout (ms)

`export_ecosystem`

Export the complete AI ecosystem to a portable .aci/bundle.json.

Parameter	Type	Required	Description
`dir`	string	No	Directory to scan (default: cwd)
`include_user`	boolean	No	Include user-level configs
`only`	string[]	No	Categories: `mcp`, `skills`, `agents`, `memories`, `context`
`secrets`	string	No	`"none"` (default), `"all"`, or `["VAR1", "VAR2"]`

`import_ecosystem`

Import a bundle into a project, adapting configuration to the target tool.

Parameter	Type	Required	Description
`file`	string	No	Path to bundle (auto-detects `.aci/bundle.json`)
`dir`	string	No	Target directory (default: cwd)
`target`	string	No	Target tool (auto-detects): `claude`, `cursor`, `windsurf`, `copilot`, `gemini`, `codex`, `opencode`
`scope`	string	No	`project` or `user`
`force`	boolean	No	Overwrite existing resources
`confirm`	boolean	No	Execute import (default: `false` = dry-run)
`only`	string[]	No	Categories to import
`secrets`	string	No	`"none"`, `"all"`, `["VAR1"]`, or `{"VAR1": "value"}`

Warning: import_ecosystem defaults to dry-run mode (confirm: false). Set confirm: true to actually write files.

Architecture

src/
├── index.ts              # Entry: CLI vs MCP mode routing
├── cli.ts                # CLI arg parsing + orchestration
├── server.ts             # createServer() MCP factory
├── scanner/              # 6 parallel scanners (Promise.all)
│   ├── catalog.ts        # AI_FILE_CATALOG — 50+ entries, 19 tools
│   ├── context-files.ts  # Scan .md, rules, configs
│   ├── mcp-configs.ts    # Parse .mcp.json, ~/.claude.json, etc.
│   ├── mcp-introspect.ts # Connect to servers, list tools/resources
│   ├── skills.ts         # Skills + symlinks + frontmatter
│   ├── agents.ts         # Agents + memory detection
│   └── memories.ts       # engram, openspec, .atl, claude memory
├── ecosystem/            # Export/import engine
│   ├── export.ts         # Scan → bundle → .aci/bundle.json
│   ├── import.ts         # Load → plan → execute
│   ├── target-map.ts     # Path configs for 7 AI tools
│   ├── detect-target.ts  # Auto-detect tool in project
│   └── secrets.ts        # Env var detection + redaction
├── report/               # HTML dashboard generator
│   ├── generator.ts      # generateHtml(ScanResult) → string
│   ├── sections.ts       # Section renderers
│   ├── styles.ts         # CSS (dark/light)
│   └── scripts.ts        # JS (collapse, search, preview)
└── tools/                # 5 MCP tool handlers
    ├── scan.ts
    ├── introspect.ts
    ├── report.ts
    ├── export.ts
    └── import.ts

Stack: TypeScript 5 (strict, ESM) / MCP SDK / Zod / tsup / Vitest

MIT · Built by cocaxcode

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

Need Help?

Related Servers

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/cocaxcode/ai-context-inspector'

If you have feedback or need assistance with the MCP directory API, please join our Discord server