# x402 Notary MCP

> x402 Notary MCP is a paid MCP server for security. Signed, chain-anchored receipts that prove which model said what and when. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, API
- **Website:** https://notary.forgemesh.io
- **Repository:** https://github.com/forgemeshlabs/x402-notary-mcp
- **MCP Registry name:** io.github.forgemeshlabs/x402-notary-mcp
- **Categories:** security, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

A receipt here is built from a hash, not your text. The prompt, response, model id and timestamp are canonicalized and hashed, the raw text is discarded, and the notary signs the hash with an Ed25519 key. Receipts are batched into a Merkle tree every ten minutes, and the batch root is written to Base as calldata so anyone can check the timestamp without trusting the notary.

Notarizing costs $0.005 per receipt, paid by the calling agent in USDC through x402 with no account or API key. Four tools are free and need no wallet: verifying a receipt, fetching its proof material, reading live stats and getting the public key for offline checks. Running locally with a wallet key enables the two paid tools; the README advises a dedicated low-balance wallet.

The server only talks to notary.forgemesh.io and refuses to sign for other payees, networks other than Base mainnet or assets other than USDC. Built-in caps are $0.01 per call and $10 per session, and environment variables can only lower them. A remote endpoint is also available, and Solana can be used as the payment rail.

## Features

- **Signed attestations:** Ed25519 signature over a content hash of the inference.
- **Merkle and chain anchoring:** Batch roots are written to Base as calldata.
- **Free verification:** Check signature, hash and Merkle proof with no wallet.
- **Batch notarizing:** Up to 20 receipts in one call.
- **Payment safeguards:** Per-call and per-session spend caps and fixed payee checks.
- **Base or Solana rails:** Choose the payment rail with an environment variable.

## Good for

- Attach proof of which model produced an output
- Keep an audit trail for agent-to-agent work
- Verify a receipt before acting on its output
- Check receipts offline against the published key

## Install

### Claude Code (Terminal)

```sh
claude mcp add x402-notary-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/x402-notary-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "x402-notary-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-notary-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "x402-notary-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-notary-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "x402-notary-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-notary-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "x402-notary-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-notary-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "x402-notary-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@forgemeshlabs/x402-notary-mcp"
      ],
      "env": {
        "WALLET_PRIVATE_KEY": "<WALLET_PRIVATE_KEY>"
      }
    }
  }
}
```

## Tools

- `notarize_inference`: Signed receipt for one prompt, response and model id.
- `notarize_batch`: Up to 20 receipts in one call.
- `verify_attestation`: Check a receipt's signature, content hash and Merkle proof.
- `get_receipt`: Fetch public proof material for an attestation.
- `notary_stats`: Live volume, top models and anchored batches.
- `notary_pubkey`: The notary's Ed25519 public key for offline verification.

## FAQ

### How much does it cost?

Notarizing is $0.005 per receipt in USDC; verification is free.

### Are my prompts stored?

The site says it notarizes the hash and discards the raw text.

### Do I need a wallet?

Only for notarizing. Verification, receipt lookup, stats and the public key work without one.

### What are the spending limits?

$0.01 per call and $10 per session by default, which environment variables can only lower.

### Is x402 Notary MCP free?

No. x402 Notary MCP is a paid product.

### How do I add x402 Notary MCP to Claude Code?

Run this command in your terminal: claude mcp add x402-notary-mcp --env WALLET_PRIVATE_KEY='<WALLET_PRIVATE_KEY>' -- npx -y @forgemeshlabs/x402-notary-mcp

### What are the best alternatives to x402 Notary MCP?

The closest alternatives to x402 Notary MCP are REA, Claude Code Ultimate Guide, Agent Roast, Midplane and Leash.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [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.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud 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.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/x402-notary-mcp
