Skip to main content

MCP server for language intelligence. 53 tools, 30 languages, speculative execution.

Project description

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.

Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

agent_lsp-0.15.0-py3-none-win_arm64.whl (10.8 MB view details)

Uploaded Python 3Windows ARM64

agent_lsp-0.15.0-py3-none-win_amd64.whl (6.0 MB view details)

Uploaded Python 3Windows x86-64

agent_lsp-0.15.0-py3-none-manylinux2014_x86_64.whl (11.9 MB view details)

Uploaded Python 3

agent_lsp-0.15.0-py3-none-manylinux2014_aarch64.whl (11.4 MB view details)

Uploaded Python 3

agent_lsp-0.15.0-py3-none-macosx_11_0_arm64.whl (11.6 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

agent_lsp-0.15.0-py3-none-macosx_10_12_x86_64.whl (12.0 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

Details for the file agent_lsp-0.15.0-py3-none-win_arm64.whl.

File metadata

  • Download URL: agent_lsp-0.15.0-py3-none-win_arm64.whl
  • Upload date:
  • Size: 10.8 MB
  • Tags: Python 3, Windows ARM64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for agent_lsp-0.15.0-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 ec585a6905ad636e95a8c71d2dde1e984e8c39cfd42ec1d156493b3dd4926e8a
MD5 ed92636c9c2761bdb7c9411d49e5f143
BLAKE2b-256 39a4b82d4dd441130c17f0d0631cd0e704239348cb6467f8efce49c6827d55ea

See more details on using hashes here.

File details

Details for the file agent_lsp-0.15.0-py3-none-win_amd64.whl.

File metadata

  • Download URL: agent_lsp-0.15.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 6.0 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.13

File hashes

Hashes for agent_lsp-0.15.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 2a9e50c0c66ee5463c11ffb8a3b575a6030b2afe9c9673f48d2ec85173f6a850
MD5 243502d28d0c9b4f2ccbd40fbb7d5f7a
BLAKE2b-256 246fe034459e2f2591eac80f4264224474f668d48dc7273c4bc3bee5e69a255f

See more details on using hashes here.

File details

Details for the file agent_lsp-0.15.0-py3-none-manylinux2014_x86_64.whl.

File metadata

File hashes

Hashes for agent_lsp-0.15.0-py3-none-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 43d7f97d626a043d6882120c211d084832d666bf63a52ccccee4dc65ed9da5cf
MD5 cbd1ab1ec367ac1df45a32b9ea6fb20a
BLAKE2b-256 f17c76d6a95a0e78af00be2e21abb838763292fb43c3b2945608a44d0dba0edb

See more details on using hashes here.

File details

Details for the file agent_lsp-0.15.0-py3-none-manylinux2014_aarch64.whl.

File metadata

File hashes

Hashes for agent_lsp-0.15.0-py3-none-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 29a1e184ffb784c6f155b741474a15621762eb6ae29e344f243d42264076857d
MD5 9025bf3107718ee5265ee3c1e7764d40
BLAKE2b-256 0594f8fc5a3b8cbcaf4151c6dc19808a187d4c75bbff012ef82411174f73073e

See more details on using hashes here.

File details

Details for the file agent_lsp-0.15.0-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for agent_lsp-0.15.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 e1dd00b6e52391897336de121cd8b3bba2abf1f8d1952bd0885039fecd362f68
MD5 3850f8ac0b60ede90c8dddccdb69a3ec
BLAKE2b-256 f73b895eb81b27cf6684a1e0ca7b66d76eb0363611c0b321e9facf79dffc27df

See more details on using hashes here.

File details

Details for the file agent_lsp-0.15.0-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for agent_lsp-0.15.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 a3dd6d9459c8939c11ad89729403bae08e54dbc8ef985395ea32dd160c10579c
MD5 6d9658fea898d709eb07260bf5630221
BLAKE2b-256 5ca6efa0bb11ff48fdb8e6d393167aa7f97f93a6080fc5079f894c69b2d73079

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page