agent-lsp — Claude Code MCP server: what it does, how to install
Coordinates language servers into 65 agent tools across 32 languages, keeping project indexes warm and testing edits in memory.
claude mcp add agent-lsp -- npx -y @blackwell-systems/agent-lspWhat agent-lsp does
The server bridges AI assistants and language servers such as gopls or pyright. It organizes code analysis into workflows instead of making dozens of repetitive requests. Workspaces remain indexed across conversations. That eliminates cold-start delays.
Instead of plain text searching, the platform executes aggregated queries. A single call to blast_radius maps callers and modified exports, splitting test and application code. Memory-based simulations let the agent preview compiler diagnostics prior to touching files on disk.
Payloads return as GCF rather than standard JSON to curb token consumption. The server requires local installations of the actual language utilities to handle each target language.
What it helps with
- inspect refactoring blast radius across exports and callers
- test diagnostic impact in memory before saving files
- locate interface implementations without relying on text search
- route multiple language servers within a single polyglot project
Example prompts for the agent
- Run blast_radius on calculateTax to see all affected callers
- Use simulate_edit on auth.go and report compiler diagnostics
- Find every implementation of the PaymentGateway interface across the repo
How to install agent-lsp
Platform CLI
claude mcp add agent-lsp -- npx -y @blackwell-systems/agent-lspPlatform CLI
codex mcp add agent-lsp -- npx -y @blackwell-systems/agent-lspConfig file
{
"mcpServers": {
"agent-lsp": {
"command": "npx",
"args": [
"-y",
"@blackwell-systems/agent-lsp"
]
}
}
}Config file
{
"servers": {
"agent-lsp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@blackwell-systems/agent-lsp"
]
}
}
}Platform CLI
gemini mcp add agent-lsp npx -y @blackwell-systems/agent-lspStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about agent-lsp
How to install agent-lsp in Claude Code?
Run claude mcp add agent-lsp -- npx -y @blackwell-systems/agent-lsp in your terminal. This registers the server and exposes its toolset to Claude Code.
What does agent-lsp do?
It manages external language servers and exposes 65 tools for code analysis across 32 languages. Agents can traverse symbols, preview edits, and inspect type hierarchies without raw text search.
How does speculative editing work?
Tools like simulate_edit apply code changes directly in memory and fetch compiler diagnostics immediately. The assistant catches type errors or syntax breaks before saving anything to disk.
