agent-lsp is an **MCP server** that orchestrates existing LSP servers (gopls, rust-analyzer, jdtls, etc.) into agent-native workflows.
Agent Lsp MCP server exists for a simple reason — assistants are far more useful when they can act on Agent Lsp directly instead of describing what you should do. agent-lsp is an MCP server that orchestrates existing LSP servers (gopls, rust-analyzer, jdtls, etc.) into agent-native workflows.
Once Agent Lsp is connected, these are the calls the assistant has available:
Documentation — The Documentation tool exposed by this serverContributing — The Contributing tool exposed by this serverYou will need 2 environment variables: AGENT_LSP_OUTPUT_FORMAT, AGENT_LSP_TOKEN. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.
Installation goes through your MCP client rather than a global install: point it at @blackwell-systems/agent-lsp on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.
Among the knowledge and memory options, the useful question is rarely "what can it do" but "what does it cost you to run" — permissions, credentials, and how much of your context its toolset consumes. Agent Lsp's toolset — Documentation, Contributing — is a fair guide to whether it matches your workflow. It is maintained by blackwell-systems; worth a glance at recent repository activity before you build anything load-bearing on it.
SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.
| Tool | What it does |
|---|---|
| Documentation | The Documentation tool exposed by this server. |
| Contributing | The Contributing tool exposed by this server. |
{
"mcpServers": {
"agent-lsp": {
"command": "npx",
"args": ["-y", "@blackwell-systems/agent-lsp"],
"env": {
"AGENT_LSP_OUTPUT_FORMAT": "your-value",
"AGENT_LSP_TOKEN": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
| Variable | Description | Required |
|---|---|---|
| AGENT_LSP_OUTPUT_FORMAT | Configuration value read at startup. | Optional |
| AGENT_LSP_TOKEN | Credential the server authenticates with. | Yes |
A knowledge graph your assistant keeps between sessions — entities, relations and observations that persist.
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Your workspace, on speaking terms with AI — search, read and write Notion pages and databases.
A structured scratchpad for hard problems — stepwise reasoning with revisions, branches and visible logic.
Symbol-level code navigation, refactoring and memory for coding agents — the IDE brain your assistant has been missing.
Chat with your second brain — search, read and write vault notes through the Local REST API.