Skip to content
MCP server

Aga MCP Server

Signed, hash-chained receipts of agent tool-call decisions, verifiable offline

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
3.6.2
Listing updated
1 day ago

About Aga MCP Server

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

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • AGA_GATEWAY_KEYEd25519 seed, 64 hex characters, that signs this server's evidence-bundle receipts and checkpoint, so gateway_public_key (get_server_info) is the same after a restart and can be pinned. Set in your MCP client's configuration, the seed sits inside the governed client's trust domain. Receipts are kept in memory only; save a generate_evidence_bundle result before the server stops. Unset or invalid: a new key each start, warned on stderr. When set, even to an invalid value, AGA_GATEWAY_KEY_FILE is not read.
  • AGA_GATEWAY_KEY_FILEPath to a file holding the 64-hex Ed25519 seed; read only when AGA_GATEWAY_KEY is unset or empty, with the same effect. A stdio server started by your MCP client runs as the client's OS user, so the file sits inside the governed client's trust domain. Missing, unreadable or invalid: a new key each start, warned on stderr.

What it does

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

Pricing

Open source

Reference implementation; commercial pricing not stated

Prices change. Check attestedintelligence.com before you buy.

Aga MCP Server 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 to Aga MCP Server

  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. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  3. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  4. Leash

    MCP server

    Review what your AI touched, approve risky actions and undo supported changes

    • 1 tool
    • Remote
    • Free
    • 1 GitHub star
    • Security
  5. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security