Skip to content
MCP server

x402 Notary MCP

Signed, chain-anchored receipts that prove which model said what and when

Runs locallyStatus and history
Install
Pricing
Paid
Platforms
CLI, API
Runs
Locally
Version
0.1.12
Listing updated
2 days ago

About x402 Notary MCP

x402 Notary MCP is a paid MCP server for security. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

Configuration

  • WALLET_PRIVATE_KEYDedicated low-balance Base wallet private key for x402 USDC micropayments. Optional — verification tools work without it. Never use your primary wallet.
  • NOTARY_RAILPayment rail: base or solana. Defaults to base, or solana when NOTARY_BASE_URL contains notary-solana.

Tools this server provides (6)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Paid

$0.005 per notarization in USDC via x402; verification free

Prices change. Check notary.forgemesh.io before you buy.

x402 Notary MCP 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 to x402 Notary MCP

  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. MCP server for searching the Claude Code Ultimate Guide from any MCP client

    Runs locally
    • Open source
    • 6.5K GitHub stars
    • AI models and LLM tooling
  3. 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
  4. 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
  5. Leash

    MCP server

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

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

    MCP server

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

    • 7 tools
    • Remote
    • Free
    • Security