cursor-explorer-mcp

Orchestrates a background cursor-agent for batched multi-file codebase analysis with file:line references.

Updated Nov 19, 2025
One-click install
npx skills add https://github.com/sepiabrown/.claude --skill cursor-explorer-mcp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cursor-explorer-mcp
Source: https://github.com/sepiabrown/.claude/tree/main/skills/cursor-explorer
Command: npx skills add https://github.com/sepiabrown/.claude --skill cursor-explorer-mcp

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers perform token-efficient, multi-file codebase analysis by delegating work to a dedicated MCP cursor-agent server. It enables broad searches, architecture mapping, and flow tracing across large codebases without manual, file-by-file reading. Use this in contexts where a single-file answer would be expensive or when you need cross-file insights, not just context-limited explanations.

Core Features & Use Cases

  • Batch multi-file queries: Submit batched questions to the MCP server and receive consolidated file:line references, code snippets, and purposes.
  • Background, asynchronous analysis: Leverages a cursor-agent server to keep your session responsive while long analyses run.
  • Cross-file tracing & architecture mapping: Understand how components interact across files and modules, reducing exploration time.
  • Use Case: When you need to understand how a feature is implemented across multiple files or when tracing a data flow that spans modules, this Skill provides concrete locations and context.

Quick Start

Start a batched query to locate where a symbol is used across the codebase, e.g.: start = mcp__cursor_agent__cursor_agent_start({ "query": "Find where X is used. For each location: file:line, code snippet, and purpose." }) Wait for completion with mcp__cursor_agent__cursor_agent_result and then present the findings.

Frequently Asked Questions about cursor-explorer-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search across multiple files in a large codebase efficiently?

Multi-file codebase search uses batched queries submitted to a background cursor-agent server, which returns consolidated file:line references and code snippets. This approach avoids token-expensive, manual file-by-file reading and keeps your session responsive during long analyses.

Can I trace how a feature is implemented across multiple files?

Cross-file tracing and architecture mapping are core features. Submit a batched query to the MCP cursor-agent asking where a symbol is used or how data flows across modules; receive concrete locations, code context, and purposes without exploring files manually.

What's the best way to map architecture and component interactions in a large codebase?

Architecture mapping uses asynchronous multi-file analysis via the cursor-agent server to identify how components interact across files and modules. Results include file:line references and code snippets, reducing exploration time significantly.

How does token-efficient multi-file analysis work?

Token efficiency is achieved by orchestrating batched queries to a dedicated MCP cursor-agent instead of reading files individually. The agent consolidates findings and falls back to manual reads only if the agent fails, preserving session tokens.

Do I need a cursor-agent server running to use this Skill?

Yes, this Skill requires a running MCP cursor-agent server to delegate multi-file analysis. It provides fallback to manual file reads if the agent is unavailable, ensuring you can still complete codebase exploration.

When should I use batched queries instead of reading files one by one?

Use batched queries when understanding feature implementation across multiple files, tracing data flows spanning modules, or mapping large architecture. Batched queries are essential for large codebases where manual reading would be prohibitively expensive in tokens and time.