Skip to content
MCP server

Agent Lsp

MCP server that turns language servers into 66 code-intelligence tools for agents

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.24.2
Listing updated
today

Similar MCP servers

About Agent Lsp

Agent Lsp is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "agent-lsp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwell-systems/agent-lsp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "agent-lsp": {
      "command": "npx",
      "args": [
        "-y",
        "@blackwell-systems/agent-lsp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

Free open-source MCP server

Agent Lsp 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.

How AIPoweredBot checks servers