lsp-explore

Requires the agent-lsp MCP server.

lsp-explore

"Tell me about this symbol" — hover, implementations, call hierarchy, and references in a single pass. Use when navigating unfamiliar code: you get type info, doc comments, who calls it, what implements it, and every reference site without issuing four separate commands.

Read-only — does not modify any files.

Invocation: User provides a symbol name in dot notation (e.g. "codec.Encode", "Buffer.Reset"). Optionally provide workspace_root to scope the search.

---

Prerequisites

If LSP is not yet initialized, call mcp__agent-lsp__start_lsp with the workspace root first. Auto-inference applies when file paths are provided.

---

Phase 1 — Locate the symbol

Call mcp__agent-lsp__go_to_symbol with symbol_path set to the user-provided name:

mcp__agent-lsp__go_to_symbol({
  "symbol_path": "Package.SymbolName",   // dot notation; e.g. "codec.Encode"
  "workspace_root": "<root>"             // optional
})
→ returns: file, line, column (1-indexed)

Record the returned file, line, and column. If go_to_symbol returns nothing, report:

Symbol not found: <name> Check the dot-notation path (e.g. "Package.Symbol") and ensure the workspace root covers the file.

Stop immediately — do not proceed to Phase 2.

Then open the file so the language server has it in view:

mcp__agent-lsp__open_document({
  "file_path": "<file from go_to_symbol>"
})

---

Phase 2 — Hover (always available)

Call mcp__agent-lsp__inspect_symbol at the definition location:

mcp__agent-lsp__inspect_symbol({
  "file_path": "<file from Phase 1>",
  "line": <line from Phase 1>,
  "column": <column from Phase 1>
})

Store the result as hover_text. If the call fails or returns nothing, set hover_text to an empty string. Do not stop.

---

Phase 3 — Implementations (capability-gated)

Call mcp__agent-lsp__get_server_capabilities to see what the server supports:

mcp__agent-lsp__get_server_capabilities()
→ returns: supported_tools list