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.12.0-py3-none-win_arm64.whl (10.6 MB view details)

Uploaded Python 3Windows ARM64

agent_lsp-0.12.0-py3-none-win_amd64.whl (5.9 MB view details)

Uploaded Python 3Windows x86-64

agent_lsp-0.12.0-py3-none-manylinux2014_x86_64.whl (11.7 MB view details)

Uploaded Python 3

agent_lsp-0.12.0-py3-none-manylinux2014_aarch64.whl (11.2 MB view details)

Uploaded Python 3

agent_lsp-0.12.0-py3-none-macosx_11_0_arm64.whl (11.4 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

agent_lsp-0.12.0-py3-none-macosx_10_12_x86_64.whl (11.8 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

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

File metadata

  • Download URL: agent_lsp-0.12.0-py3-none-win_arm64.whl
  • Upload date:
  • Size: 10.6 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.12.0-py3-none-win_arm64.whl
Algorithm Hash digest
SHA256 36fa0b91cd63eeafab4bef871a9445dd21b8d40c67540f5ddb824ab22d753504
MD5 ed4713fe6047cfee04831e1d7226e959
BLAKE2b-256 ba5fa33701815c6cb126f9ec8f4495666601c1073a2d4e2c4898a5be99157f66

See more details on using hashes here.

File details

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

File metadata

  • Download URL: agent_lsp-0.12.0-py3-none-win_amd64.whl
  • Upload date:
  • Size: 5.9 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.12.0-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 7194db40cb34211d3e10ea52d5fb169bc887662eb6e518ad40bdc66ab9461a99
MD5 1ab6c2a612bdb30c42e7fb474761574c
BLAKE2b-256 97faf910cad7b55a3f03f7f134c776a089fccff2e2ce5ffa2d35cbfc3584272a

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agent_lsp-0.12.0-py3-none-manylinux2014_x86_64.whl
Algorithm Hash digest
SHA256 00c1df6e0af7ed3ef26242f9eb1df2632ae213ccef4968bb4a01cc38382745c8
MD5 1bbc58553f2906d08e8bb19a3f48146b
BLAKE2b-256 5d4828c497405749043e2edee77a6a1a5262e52044af0b9467147c0865ac36c0

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agent_lsp-0.12.0-py3-none-manylinux2014_aarch64.whl
Algorithm Hash digest
SHA256 4525d08dfe48b20bd4ad49665363e4eadcd34395bdade3a5218721d24bd179d0
MD5 f433f50190286a6a662ecfc4cf75df88
BLAKE2b-256 3864fe0bb23e7df4f7726a83f928e2f5e565f4489617cbf4afda3db2ec5576ee

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agent_lsp-0.12.0-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 d48a2a8638275db6d7f4bd52669f860906590067c201a2f5cad8419b3ce7103d
MD5 3fdc654b7c74f1b934c984a9f826df4c
BLAKE2b-256 0d53a554e9ea279338629eff5923e22f559b10f21d608856608cda27100862b4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for agent_lsp-0.12.0-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 d0621aacda800b116bf9c88218216b577749321b96a52a59ac097621f07080fb
MD5 0cf31a683e46295b991a2259c539d82e
BLAKE2b-256 49746ce11c6c3f9e86a45c1d773b70cd2ac98b994939ab7cb1cb5dc640f940ae

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