Skip to content
MCP server

Gage

Signed, sealed handoffs between AI agents, with trust decided by the receiver

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
macOS, Linux, CLI
Runs
Locally
Version
0.3.6
Listing updated
2 days ago

About Gage

Gage is an open-source MCP server for security. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "gage": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/warewithall2/gage/releases/download/v0.3.6/gage-0.3.6-darwin-arm64.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "gage": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/warewithall2/gage/releases/download/v0.3.6/gage-0.3.6-darwin-arm64.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.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"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Free; dual-licensed MIT or Apache-2.0

Prices change. Check gage.sh before you buy.

Gage 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 to Gage

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools