# Agent Lsp

> Agent Lsp is an open-source MCP server for developer tools. MCP server that turns language servers into 66 code-intelligence tools for agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/blackwell-systems/agent-lsp
- **MCP Registry name:** io.github.blackwell-systems/agent-lsp
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Rather than being a language server, it manages existing ones such as gopls, rust-analyzer and jdtls and keeps them running between sessions, so an agent avoids a cold start after the first index. One process routes files to the right server, for example .go to gopls and .ts to tsserver, and workspace-wide queries ask every running server.

The distinctive part is safe editing. simulate_edit and preview_edit show the diagnostic change an edit would cause in memory before anything touches disk, simulate_chain finds the first step in a series of dependent edits that breaks, and safe_apply_edit writes only an edit it could verify. blast_radius returns exports and callers, split into test and non-test, in one call. The refactor tool can relay questions from gopls v0.24 as a typed form, with dry_run to preview the result.

The README claims CI runs 32 real language servers against fixture projects, 24 bundled workflow skills such as /lsp-refactor and /lsp-verify, and compact output in GCF format to save tokens. It ships as a single Go binary and an npm package.

## Features

- **Persistent language servers:** Keeps servers indexed across agent sessions.
- **Speculative editing:** Previews diagnostic impact of edits in memory before writing.
- **Blast radius:** Returns exports and callers in one call, split into test and non-test.
- **Multi-language routing:** Sends each file to the matching language server in one session.
- **Workflow skills:** 24 chained pipelines like refactor, safe edit and verify.
- **Interactive refactoring:** Passes gopls refactoring questions to the agent as a typed form.

## Good for

- Rename a symbol across a large codebase with a previewed diff
- Assess the impact of changing an exported function
- Check whether a chain of edits introduces errors before applying
- Give CI tooling programmatic code intelligence
- Find implementations of an interface with type checking

## Install

### Claude Code (Terminal)

```sh
claude mcp add agent-lsp -- npx -y @blackwell-systems/agent-lsp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "agent-lsp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwell-systems/agent-lsp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agent-lsp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwell-systems/agent-lsp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "agent-lsp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@blackwell-systems/agent-lsp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "agent-lsp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwell-systems/agent-lsp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "agent-lsp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwell-systems/agent-lsp"
      ]
    }
  }
}
```

## Tools

- `blast_radius`: Returns exports and callers for a symbol, split into test and non-test.
- `simulate_edit`: Previews an edit's diagnostic delta in memory.
- `safe_apply_edit`: Writes an edit only if it could be verified.
- `preview_edit`: Previews the diagnostic impact of an edit.
- `simulate_chain`: Evaluates a sequence of dependent edits.
- `refactor`: Lists and runs refactorings, relaying server questions.
- `find_symbol`: Searches symbols across running language servers.
- `get_server_capabilities`: Reports capabilities of running language servers.
- `start_lsp`: Starts or connects to a language server.
- `go_to_implementation`: Finds type-checked implementations of an interface.

## FAQ

### Is it a language server?

No. It orchestrates existing language servers and exposes them as MCP tools.

### How many languages are covered?

The README says 32 real language servers are tested in CI.

### How is it installed?

Via an install script for a single Go binary, or the npm package @blackwell-systems/agent-lsp.

### How does it save tokens?

Tool responses use the GCF format instead of JSON, which the README says cuts tokens by 30-84% depending on the tool.

### Is Agent Lsp free?

Yes. Agent Lsp is open source, so you can use and self-host it for free.

### How do I add Agent Lsp to Claude Code?

Run this command in your terminal: claude mcp add agent-lsp -- npx -y @blackwell-systems/agent-lsp

### What are the best alternatives to Agent Lsp?

The closest alternatives to Agent Lsp are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/agent-lsp
