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.

Metadata

Release files for agent-lsp 0.21.0

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.21.0
File	Interpreter	ABI	Platform	Reset
agent_lsp-0.21.0-py3-none-win_arm64.whl 10.9 MB Sep 29, 2026	Python 3	none	Windows ARM64	Details
agent_lsp-0.21.0-py3-none-win_amd64.whl 6.1 MB Sep 29, 2026	Python 3	none	Windows x86-64	Details
agent_lsp-0.21.0-py3-none-manylinux2014_x86_64.whl 12.0 MB Sep 29, 2026	Python 3	none	Linux glibc 2.17+ x86-64	Details
agent_lsp-0.21.0-py3-none-manylinux2014_aarch64.whl 11.5 MB Sep 29, 2026	Python 3	none	Linux glibc 2.17+ ARM64	Details
agent_lsp-0.21.0-py3-none-macosx_11_0_arm64.whl 11.7 MB Sep 29, 2026	Python 3	none	macOS 11.0+ ARM64	Details
agent_lsp-0.21.0-py3-none-macosx_10_12_x86_64.whl 12.1 MB Sep 29, 2026	Python 3	none	macOS 10.12+ x86-64	Details

Total release size: 64.3 MB

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

Download URL	agent_lsp-0.21.0-py3-none-win_arm64.whl
Size	10.9 MB
Tags	Python 3 Windows ARM64
SHA-256 checksum How to use checksums	`5a2030165e205ab5028321c82fe6851009d32d3e7c384e641b279b15aafe0a4b`
BLAKE2b-256 checksum How to use checksums	`834cf3b61aad3c03d31918a8e8acfd2103296a1f48f4c638030f5270a63c3279`
Upload date	Sep 29, 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.21.0-py3-none-win_amd64.whl

Download URL	agent_lsp-0.21.0-py3-none-win_amd64.whl
Size	6.1 MB
Tags	Python 3 Windows x86-64
SHA-256 checksum How to use checksums	`d8c28970f4aec1343be9b6e667118a0517aa0d60f10992dce11f4f68b7c4bb80`
BLAKE2b-256 checksum How to use checksums	`6df21a019210e5ef02c1757ce2470cfc690a2e6927cd8d6908eba96cb782fb01`
Upload date	Sep 29, 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.21.0-py3-none-manylinux2014_x86_64.whl

Download URL	agent_lsp-0.21.0-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	`e5a66fe7deb0c65ba47ff221f85495ffacc62064fcd97f40381bce814246ccc7`
BLAKE2b-256 checksum How to use checksums	`8bb6521e4ee910c669ed01b5207dc7be2d08829e6211d91604baf53d1c01cea1`
Upload date	Sep 29, 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.21.0-py3-none-manylinux2014_aarch64.whl

Download URL	agent_lsp-0.21.0-py3-none-manylinux2014_aarch64.whl
Size	11.5 MB
Tags	Linux glibc 2.17+ ARM64 Python 3
SHA-256 checksum How to use checksums	`3ba1c4d86ac31639961adaf5ea74bc3409badbfa881a83073c955e6c4f3ed810`
BLAKE2b-256 checksum How to use checksums	`c9539d44931c663b1581119ef02d08bb4dfd3629e0ee564a6b847478cc6c8b31`
Upload date	Sep 29, 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.21.0-py3-none-macosx_11_0_arm64.whl

Download URL	agent_lsp-0.21.0-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	`6c8355a0c8b42ec114ff31d087a911f2e117abd102c3a660990a7f62e7b1b044`
BLAKE2b-256 checksum How to use checksums	`9f7e0c2da01e9d0abe60fec9cae7264f637f16010249e09437413ec3412f0c7c`
Upload date	Sep 29, 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.21.0-py3-none-macosx_10_12_x86_64.whl

Download URL	agent_lsp-0.21.0-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	`d52fea40c0edbd0f4311c5e08baeb120a0c49fa0728c7b4b1b772edb82f96526`
BLAKE2b-256 checksum How to use checksums	`be33f501b603e28469a8a82caf24eac3c2e706d0ccfeb4d77b6a91fd9d29c132`
Upload date	Sep 29, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.14`