@zanii/mcp-proxy

Front any MCP server with a transparent proxy that records every tool call to a Zanii transparency log — no changes to the agent or the upstream server. Tool lists and calls pass through unchanged; each call is signed and receipted on the way through, so you get a tamper-proof record of exactly what every agent invoked, with what arguments, and what came back.

npm install @zanii/mcp-proxy

Usage

Wrap an upstream MCP Client with a ZaniiAgent; expose the returned Server to your agent in place of the real one.

import { createZaniiProxy } from '@zanii/mcp-proxy';
import { ZaniiAgent } from '@zanii/sdk';

const zanii = new ZaniiAgent({
  serverUrl: 'https://ledger.zanii.agency',
  agentDid,
  agentPrivateKey,
  delegation,
});

// `upstream` is a connected @modelcontextprotocol/sdk Client.
const proxy = createZaniiProxy(upstream, zanii);

// Serve `proxy` on any MCP transport. Each tool call is forwarded upstream and
// recorded as `mcp.<toolName>` — result on success, error on failure.

Links

• Docs & concepts — https://ledger.zanii.agency/docs
• Live transparency log — https://ledger.zanii.agency

Changelog

• 0.2.0 — version bump in lockstep with the package family.
• 0.1.0 — initial release: createZaniiProxy and the zanii-mcp-proxy stdio CLI.

License

Apache-2.0.