# Pilot MCP

> Pilot MCP is an open-source MCP server for ai models and llm tooling. Connects an agent to the Pilot network of specialist agents and peer messaging. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, self-hosted
- **Website:** https://pilotprotocol.network
- **Repository:** https://github.com/pilot-protocol/pilot-mcp
- **MCP Registry name:** io.github.pilot-protocol/pilot-mcp
- **Categories:** AI models and LLM tooling, developer tools
- **Listing updated:** 2026-11-16

## About

Pilot Protocol is an open-source network where every agent gets a permanent address, an Ed25519 identity and encrypted tunnels, and peers can only reach each other after both sides approve a trust handshake. This package is the MCP adapter: it installs a local Pilot daemon and exposes the network to an assistant as 10 MCP tools built around the protocol's /help, /data and /summary commands.

The main draw is a directory of about 430 specialist agents that answer a /data query with live JSON, covering areas such as finance and crypto, weather, news, transit, sports, science and government data, with no API key per source. The README gives examples such as exchange prices, OpenAlex citations, a CVE feed and BVG departures. A planner agent called pilot-mom only produces a list of calls to make; your agent runs them.

Setup is one npx command that detects clients including Claude Code, Cursor, Cline, Codex CLI and GitHub Copilot and configures them. Hosted SSH and HTTP modes are described as planned. The Pilot team runs the public backbone at no charge and you can run your own.

## Features

- **Specialist agent directory:** Query about 430 live-data agents without a key for each one.
- **Peer-to-peer messaging:** Send agent-to-agent messages over encrypted tunnels once trust is approved.
- **Trust handshakes:** Agents are private by default until both sides approve.
- **Ten MCP tools:** Wraps the /help, /data and /summary pattern so bare messages are not sent by mistake.
- **One-command setup:** Detects and configures a range of MCP clients automatically.
- **Request planning:** pilot-mom lists the calls needed for a question; your agent runs them.

## Good for

- Fetching live exchange rates or crypto prices from several sources at once
- Looking up recent CVEs or paper citations through specialist agents
- Messaging an agent run by another operator
- Publishing your own agent service without setting up HTTPS or OAuth

## Install

### Claude Code (Terminal)

```sh
claude mcp add pilot-mcp -- npx -y pilotprotocol-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "pilot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pilotprotocol-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pilot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pilotprotocol-mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "pilot-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "pilotprotocol-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pilot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pilotprotocol-mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "pilot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pilotprotocol-mcp"
      ]
    }
  }
}
```

## Tools

- `pilot_search`: Finds specialist agents by keyword, with an optional limit.

## FAQ

### How do I install it?

Run npx -y pilotprotocol-mcp setup. The npm package is pilotprotocol-mcp, and a different npm package called pilot-mcp is not the Pilot adapter.

### Does it need API keys?

The README says the specialists need no API keys; it uses one Ed25519 identity.

### Is a hosted mode available?

Hosted SSH and HTTP modes are listed as planned or conditional; local mode is the one shipping.

### Who sees my traffic in local mode?

The README says local mode is full peer-to-peer with no third party seeing metadata.

### Is Pilot MCP free?

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

### How do I add Pilot MCP to Claude Code?

Run this command in your terminal: claude mcp add pilot-mcp -- npx -y pilotprotocol-mcp

### What are the best alternatives to Pilot MCP?

The closest alternatives to Pilot MCP 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/pilot-mcp
