# agent-lsp

Coordinates language servers into 65 agent tools across 32 languages, keeping project indexes warm and testing edits in memory.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 164
- Author: blackwell-systems
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/blackwell-systems/agent-lsp
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/agent-lsp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agent-lsp -- npx -y @blackwell-systems/agent-lsp
```

### Codex

**Platform CLI**
```bash
codex mcp add agent-lsp -- npx -y @blackwell-systems/agent-lsp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-lsp": {
            "command": "npx",
            "args": [
                "-y",
                "@blackwell-systems/agent-lsp"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-lsp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@blackwell-systems/agent-lsp"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add agent-lsp npx -y @blackwell-systems/agent-lsp
```

## When to use it
- 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
- 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

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md