# Gage

> Gage is an open-source MCP server for security. Signed, sealed handoffs between AI agents, with trust decided by the receiver. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI
- **Website:** https://gage.sh
- **Repository:** https://github.com/warewithall2/gage
- **MCP Registry name:** io.github.warewithall2/gage
- **Categories:** security, developer tools
- **Listing updated:** 2026-11-15

## About

Gage treats a handoff between agents as a security problem. A bundle of files, a prompt and decisions is sealed for one recipient and signed with a key that lives on one machine. The receiving agent is told the contents are data from an identified party with no authority, and if the sender cannot be attributed to a key you accept, the contents are withheld instead of annotated.

Trust is a separate step from the signature. Two people compare four word-pairs derived from the key, aloud on a call or in person, then run `gage confirm`. A key that is only on your list still works but is reported as unconfirmed, and a bundle waits unread in the inbox until you accept it. Bundles can travel by shared folder, git, email, a relay or over a LAN. It ships as a macOS app for Apple Silicon and a command line, and an agent can drive it over MCP with `gage mcp`. It is free, dual-licensed MIT or Apache-2.0, with no account, server or telemetry.

## Features

- **Sealed bundles:** Each bundle is encrypted for exactly one recipient.
- **Signed identities:** Keys are made and kept on one machine, so signatures cannot be forged.
- **Word-pair confirmation:** Four word-pairs derived from a key are compared aloud to confirm a person.
- **Reading frame:** Tells the receiving agent that contents are data, not instructions.
- **Flexible transport:** Moves over a folder, git, email, a relay or a LAN.
- **Mac app and CLI:** Desktop app and command line share the same tool.

## Good for

- Passing a task from one agent to a colleague's agent safely
- Sharing project state between machines without a server
- Reducing prompt-injection risk in agent-to-agent messages
- Confirming who a signing key really belongs to

## Install

### Claude Code (Terminal)

```sh
claude mcp add gage -- npx -y https://github.com/warewithall2/gage/releases/download/v0.3.6/gage-0.3.6-darwin-arm64.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "gage": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/warewithall2/gage/releases/download/v0.3.6/gage-0.3.6-darwin-arm64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gage": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/warewithall2/gage/releases/download/v0.3.6/gage-0.3.6-darwin-arm64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "gage": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/warewithall2/gage/releases/download/v0.3.6/gage-0.3.6-darwin-arm64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gage": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/warewithall2/gage/releases/download/v0.3.6/gage-0.3.6-darwin-arm64.mcpb"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "gage": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/warewithall2/gage/releases/download/v0.3.6/gage-0.3.6-darwin-arm64.mcpb"
      ]
    }
  }
}
```

## FAQ

### Does it need an account or server?

No. The site says there is no account, no server and no telemetry.

### What platforms are supported?

A macOS app for Apple Silicon (macOS 13 or later) and a command line; registry packages are for darwin-arm64 and linux-x86_64.

### What licence is it under?

Dual-licensed MIT or Apache-2.0.

### Is it a new protocol?

No. A bundle is a signed directory that moves over any channel you already use.

### Is Gage free?

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

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

Run this command in your terminal: claude mcp add gage -- npx -y https://github.com/warewithall2/gage/releases/download/v0.3.6/gage-0.3.6-darwin-arm64.mcpb

### What are the best alternatives to Gage?

The closest alternatives to Gage 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/gage-3
