# Periscope

> Periscope is an open-source MCP server for developer tools. Rust MCP broker into a live Neovim config for LSP, formatters, linters and DAP. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Linux, CLI, self-hosted
- **Website:** https://qompass.ai/solutions/periscope/
- **Repository:** https://github.com/qompassai/periscope
- **MCP Registry name:** ai.qompass/periscope
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Periscope lets an agent use the same language servers, formatter registry, linter registry and DAP module tree that you edit with, instead of running duplicate servers or translated config files. It is a single Rust binary that speaks MCP over stdio to the client and msgpack-RPC to Neovim.

In the default managed mode it spawns its own headless Neovim in the workspace, so your config loads as normal and your interactive editor is untouched; project-local config execution is refused. Attach mode connects to a Neovim you already started with --listen. The tools are small Lua programs run inside the editor using native APIs, so per-server LSP settings carry over.

Most tools are read-only (definitions, references, hover, diagnostics, symbols and config listings). run_format and run_lint execute the config's own pipelines; formatting returns text for the buffer and never writes to disk. Four attention tools host a MATE joint-attention board where agents publish and compare focus.

## Features

- **Real Neovim config:** Queries the language servers and registries from your actual setup.
- **Managed or attach mode:** Spawns a headless Neovim or connects to one you already run.
- **Code intelligence:** Definitions, references, hover, diagnostics and document symbols.
- **Format and lint pipelines:** Runs your formatters and linters without writing files to disk.
- **DAP and registry listing:** Lists debug adapter modules, formatters, linters and LSP servers.
- **Attention board:** Agents publish focus and get alignment scores or coordination decisions.

## Good for

- Give an agent your editor's diagnostics and definitions
- Format a file with your own formatter pipeline and read the result
- List which linters and LSP servers your config defines
- Coordinate two agents so they do not work the same target

## Install

### Claude Code (Terminal)

```sh
claude mcp add periscope -- npx -y https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "periscope": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "periscope": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "periscope": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "periscope": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "periscope": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb"
      ]
    }
  }
}
```

## Tools

- `broker_status`: Mode, Neovim version, cwd and config root.
- `get_definition`: Merged definition locations across attached clients.
- `get_diagnostics`: Buffer diagnostics from LSP and linter pipelines.
- `get_document_symbols`: Flattened symbol outline with containers.
- `get_hover`: Hover text at a position.
- `get_references`: Merged reference locations across attached clients.
- `list_dap`: DAP modules in the config tree and registered adapters.
- `list_formatters`: Formatter modules in the config tree.
- `list_linters`: Linter modules in the config tree.
- `list_servers`: LSP servers configured or attached to open buffers.
- `run_format`: Format a file with the config's formatter pipeline.
- `attention_publish`: Publish your focus to the coordination board.
- `attention_focus`: Read a partner agent's advertised focus.
- `attention_alignment`: Measure alignment between two agents' focus.
- `attention_decide`: Return a parallel, serialize or reject coordination decision.

## FAQ

### Does it modify files?

No. Formatting is applied to the brokered buffer and returned as text; written is always false.

### Will it disturb my open editor?

Managed mode runs its own headless Neovim, and attach mode never signals or closes an editor it did not spawn.

### What does it ship as?

A Linux x64 MCPB bundle from the v1.0.0 release; the README describes a single Rust binary.

### What is the attention feature?

A coordination board where agents publish an ordered focus and request alignment scores or decisions (MATE protocol).

### Is Periscope free?

Yes. Periscope is open source, so you can use and self-host it for free.

### How do I add Periscope to Claude Code?

Run this command in your terminal: claude mcp add periscope -- npx -y https://github.com/qompassai/periscope/releases/download/v1.0.0/periscope-mcp-1.0.0-linux-x64.mcpb

### What are the best alternatives to Periscope?

The closest alternatives to Periscope are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/periscope
