# Aga MCP Server

> Aga MCP Server is an open-source MCP server for security. Signed, hash-chained receipts of agent tool-call decisions, verifiable offline. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://attestedintelligence.com
- **Repository:** https://github.com/attestedintelligence/aga-mcp-server
- **MCP Registry name:** io.github.attestedintelligence/aga-mcp-server
- **Categories:** security
- **Listing updated:** 2026-11-16

## About

AGA records the decision a policy gateway made about each tool request, such as `read_document` permitted and `write_file` denied, as a signed receipt linked to the one before it. An export bundles hash-linked receipts, Merkle proofs and a signed checkpoint, and a reviewer can check the bundle offline against an expected issuer key obtained through a trusted channel, without contacting the producer.

The project is unusually explicit about what that proves. A receipt shows a recorded decision, not that a tool ran or what it returned; verification shows integrity of the receipts present, not that every action was captured; argument hashes are commitments, not guaranteed confidentiality; and a key holder could sign another history. The README labels it a published reference implementation before independent pilot validation, and warns that the ledger is volatile and in memory only, so a bundle must be saved before shutdown.

It runs as a local stdio server (npm package, with a Python companion SDK). `AGA_GATEWAY_KEY` or `AGA_GATEWAY_KEY_FILE` fix the Ed25519 signing seed so the public key is stable across restarts. The site suggests starting with static verification of a sample before any runtime use.

## Features

- **Signed receipts:** Each tool-call decision is signed and linked to the previous receipt.
- **Offline verification:** Check an exported bundle against an expected key without a live service.
- **Merkle checkpoint:** A signed checkpoint commits to the count, head and Merkle root.
- **Stable signing key:** Seed from an environment variable or file keeps the public key fixed.
- **Explicit limits:** Documents what the record does and does not prove.
- **Reference proxy:** Hardened proxy with loopback default and rate limits.

## Good for

- Hand a reviewer a signed record of an agent's tool decisions
- Verify an evidence bundle against a pinned issuer key
- Demonstrate denied versus permitted tool requests in a sample
- Evaluate a policy gateway on synthetic inputs

## Install

### Claude Code (Terminal)

```sh
claude mcp add aga-mcp-server --env AGA_GATEWAY_KEY='<AGA_GATEWAY_KEY>' -- npx -y @attested-intelligence/aga-mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "aga-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@attested-intelligence/aga-mcp-server"
      ],
      "env": {
        "AGA_GATEWAY_KEY": "<AGA_GATEWAY_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "aga-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@attested-intelligence/aga-mcp-server"
      ],
      "env": {
        "AGA_GATEWAY_KEY": "<AGA_GATEWAY_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "aga-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@attested-intelligence/aga-mcp-server"
      ],
      "env": {
        "AGA_GATEWAY_KEY": "<AGA_GATEWAY_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "aga-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@attested-intelligence/aga-mcp-server"
      ],
      "env": {
        "AGA_GATEWAY_KEY": "<AGA_GATEWAY_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "aga-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@attested-intelligence/aga-mcp-server"
      ],
      "env": {
        "AGA_GATEWAY_KEY": "<AGA_GATEWAY_KEY>"
      }
    }
  }
}
```

## FAQ

### Does a permitted receipt prove the tool ran?

No. It records a policy decision, not execution.

### Do I need a service to verify a bundle?

No. Once the verifier, sample and expected key are local, verification needs no network.

### Are receipts stored permanently?

No. They are kept in memory, so save an evidence bundle before the server stops.

### Is it production ready?

The README describes it as a reference implementation before independent pilot validation.

### How do I keep the same signing key?

Set AGA_GATEWAY_KEY or AGA_GATEWAY_KEY_FILE to a 64-hex Ed25519 seed.

### Is Aga MCP Server free?

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

### How do I add Aga MCP Server to Claude Code?

Run this command in your terminal: claude mcp add aga-mcp-server --env AGA_GATEWAY_KEY='<AGA_GATEWAY_KEY>' -- npx -y @attested-intelligence/aga-mcp-server

### What are the best alternatives to Aga MCP Server?

The closest alternatives to Aga MCP Server are REA, Agent Roast, Midplane, Leash and Tinplate Edge AI Safety, Security & EU Compliance.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Agent Roast](https://ai-powered.com/mcp/agent-roast): Agent Roast is an open-source MCP server for developer tools.
- [Midplane](https://ai-powered.com/mcp/midplane): Midplane is an open-source MCP server for databases.
- [Leash](https://ai-powered.com/mcp/leash): Leash is a free MCP server for security.
- [Tinplate Edge AI Safety, Security & EU Compliance](https://ai-powered.com/mcp/tinplate-edge-ai-safety-security-and-eu-compliance): Tinplate Edge AI Safety, Security & EU Compliance is a freemium MCP server for security.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [SynomosAI Governance MCP](https://ai-powered.com/mcp/synomosai-governance-mcp-2): SynomosAI Governance MCP is an open-source MCP server for security.

---
Source: https://ai-powered.com/mcp/aga-mcp-server
