Skip to content
Agent Receipts

Installation

Install

Section titled “Install”
Terminal window
go install github.com/agent-receipts/ar/mcp-proxy/cmd/mcp-proxy@latest

Requirements

Section titled “Requirements”
  • Go 1.22+

No CGO or external C libraries required — the proxy uses pure Go SQLite.

Basic usage

Section titled “Basic usage”

Wrap any MCP server by passing its command as arguments:

Terminal window
mcp-proxy node /path/to/mcp-server.js

The proxy intercepts stdin/stdout, logs every tool call, and forwards messages transparently. By default it generates an ephemeral Ed25519 key pair for signing receipts.

Persistent signing key

Section titled “Persistent signing key”

Generate a key pair and use it across sessions:

Terminal window
# Generate a key pair (any Ed25519 PEM tool works)
openssl genpkey -algorithm Ed25519 -out private.pem
openssl pkey -in private.pem -pubout -out public.pem


# Run with persistent key
mcp-proxy --key private.pem node /path/to/mcp-server.js

Next steps

Section titled “Next steps”
  • Configuration for CLI flags, policy rules, redaction, and encryption
  • CLI Commands for querying and verifying the audit trail