Agent Lsp
MCP server that turns language servers into 66 code-intelligence tools for agents
- 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-lspAdd to claude_desktop_config.json
{
"mcpServers": {
"agent-lsp": {
"command": "npx",
"args": [
"-y",
"@blackwell-systems/agent-lsp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"agent-lsp": {
"command": "npx",
"args": [
"-y",
"@blackwell-systems/agent-lsp"
]
}
}
}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.


