agent-lsp

MCP server for language intelligence. Give AI agents structured access to language servers: go-to-definition, find-all-references, rename, diagnostics, completions, call hierarchy, and speculative execution.

66 tools. 23 agent workflows. 30 CI-verified languages. Single Go binary.

Why

AI coding agents navigate code with grep and file reads. This wastes 5-34x more tokens than necessary and produces 92-99% false positives on symbol lookups. Language servers already have the answers; agent-lsp makes them accessible via MCP.

Install

pip install agent-lsp

Or via other channels:

brew install blackwell-systems/tap/agent-lsp    # macOS/Linux
npm install -g @blackwell-systems/agent-lsp     # npm
curl -fsSL https://raw.githubusercontent.com/blackwell-systems/agent-lsp/main/install.sh | sh

Usage

# Start with auto-detection
agent-lsp

# Explicit language server
agent-lsp go:gopls typescript:typescript-language-server,--stdio

# HTTP mode
agent-lsp --http --port 8080 go:gopls

Then configure your AI tool's MCP settings to point at agent-lsp.

What it does

66 tools covering navigation, analysis, refactoring, diagnostics, formatting, speculative execution, composite exploration, safe editing, build, test, and more
23 agent workflows (skills) that encode correct multi-step operations: rename safely, analyze blast radius, simulate edits before applying
30 CI-verified languages: Go, Python, TypeScript, Rust, Java, C, C++, C#, Ruby, PHP, Kotlin, Swift, Scala, Zig, Lua, Elixir, Gleam, and more
Speculative execution: preview edits in memory, see what breaks before touching disk
Phase enforcement: blocks out-of-order operations so agents follow correct workflows

Token savings

Measured across 5 codebases (Go, TypeScript, Python):

Codebase	Lines	Savings
agent-lsp	15K	5x
Hono (TypeScript)	24K	13x
FastAPI (Python)	33K	2x
Next.js (TypeScript)	196K	5x
HashiCorp Consul (Go)	319K	34x

Full experiment: agent-lsp.com/token-savings

Works with

Claude Code, Cursor, Windsurf, GitHub Copilot, and any MCP-compatible client.

Release files for agent-lsp 0.19.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for agent-lsp 0.19.3
File	Interpreter	ABI	Platform	Reset
agent_lsp-0.19.3-py3-none-win_arm64.whl 10.8 MB Sep 20, 2026	Python 3	none	Windows ARM64	Details
agent_lsp-0.19.3-py3-none-win_amd64.whl 6.0 MB Sep 20, 2026	Python 3	none	Windows x86-64	Details
agent_lsp-0.19.3-py3-none-manylinux2014_x86_64.whl 12.0 MB Sep 20, 2026	Python 3	none	Linux glibc 2.17+ x86-64	Details
agent_lsp-0.19.3-py3-none-manylinux2014_aarch64.whl 11.4 MB Sep 20, 2026	Python 3	none	Linux glibc 2.17+ ARM64	Details
agent_lsp-0.19.3-py3-none-macosx_11_0_arm64.whl 11.7 MB Sep 20, 2026	Python 3	none	macOS 11.0+ ARM64	Details
agent_lsp-0.19.3-py3-none-macosx_10_12_x86_64.whl 12.1 MB Sep 20, 2026	Python 3	none	macOS 10.12+ x86-64	Details

Total release size: 64.0 MB

Release files / agent_lsp-0.19.3-py3-none-win_arm64.whl

Download URL	agent_lsp-0.19.3-py3-none-win_arm64.whl
Size	10.8 MB
Tags	Python 3 Windows ARM64
SHA-256 checksum How to use checksums	`cacb7a7209c42fc9f910d9e063a92813d1b6822bca42dde5982bafc07254e450`
BLAKE2b-256 checksum How to use checksums	`b522504ec3cffe6a3a098cfdd39b6ef8e1db05503e1abd36631d579ed23ffb7b`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.14`

Release files / agent_lsp-0.19.3-py3-none-win_amd64.whl

Download URL	agent_lsp-0.19.3-py3-none-win_amd64.whl
Size	6.0 MB
Tags	Python 3 Windows x86-64
SHA-256 checksum How to use checksums	`e4484968948fe5be82223eb1c047f3397fb211925105178ec2d24086e93c5975`
BLAKE2b-256 checksum How to use checksums	`800cf5344f1e1335ee24e0766759844e1c0ac443a87d0289e68b10b51878adb2`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.14`

Release files / agent_lsp-0.19.3-py3-none-manylinux2014_x86_64.whl

Download URL	agent_lsp-0.19.3-py3-none-manylinux2014_x86_64.whl
Size	12.0 MB
Tags	Linux glibc 2.17+ x86-64 Python 3
SHA-256 checksum How to use checksums	`df95f4e840ed2bdd9902d47f51f072b2a762cec30b52a8a5a8ed3b9ddbe846c0`
BLAKE2b-256 checksum How to use checksums	`f7b7f90bad91bbdc0a658823c114c5cae4dc0b7b224161d7d3176b4c95545e74`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.14`

Release files / agent_lsp-0.19.3-py3-none-manylinux2014_aarch64.whl

Download URL	agent_lsp-0.19.3-py3-none-manylinux2014_aarch64.whl
Size	11.4 MB
Tags	Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum How to use checksums	`edf37b570d38548293227263bd074675f3969172258cbcbd3e9035393bf96f6f`
BLAKE2b-256 checksum How to use checksums	`5455dfde7308fbce9c2e679bc1c716d0a8620935397a2e3d5e15c6092098ca10`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.14`

Release files / agent_lsp-0.19.3-py3-none-macosx_11_0_arm64.whl

Download URL	agent_lsp-0.19.3-py3-none-macosx_11_0_arm64.whl
Size	11.7 MB
Tags	Python 3 macOS 11.0+ ARM64
SHA-256 checksum How to use checksums	`89aa1ed67dc6a97ff2ed66ba9c47a088c79e9f7ed103deca1ba876b4e29df7c0`
BLAKE2b-256 checksum How to use checksums	`f9797cb41eb2f46687f64da306e5810e8e814736a66d5371cdaffa14b0c5f6ce`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.14`

Release files / agent_lsp-0.19.3-py3-none-macosx_10_12_x86_64.whl

Download URL	agent_lsp-0.19.3-py3-none-macosx_10_12_x86_64.whl
Size	12.1 MB
Tags	Python 3 macOS 10.12+ x86-64
SHA-256 checksum How to use checksums	`a9b2e14339cfd44c40f08137f2d3a5c95aeb289a0fface591ba1fe9c7c25dff4`
BLAKE2b-256 checksum How to use checksums	`10208ed67fabb22048104570f2718f6fdfdc2443f8759f7338333d801ce8454d`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.14`