English Français العربية

vip.witnessd/witnessd

Official registry Other

Neutral third-party witness: independently fetch, hash, timestamp, archive any URL or API response.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package witnessd-mcp
Claude Code 
claude mcp add witnessd -e 'WITNESSD_URL=<WITNESSD_URL>' -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'WITNESSD_API_KEY=<your witnessd_api_key>' -- npx -y witnessd-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "witnessd": {
            "command": "npx",
            "args": [
                "-y",
                "witnessd-mcp@0.1.1"
            ],
            "env": {
                "WITNESSD_URL": "<WITNESSD_URL>",
                "EVM_PRIVATE_KEY": "<your evm_private_key>",
                "WITNESSD_API_KEY": "<your witnessd_api_key>"
            }
        }
    }
}

Environment variables

  • WITNESSD_URL Base URL of the witnessd service (default https://witnessd.vip)
  • EVM_PRIVATE_KEY secret Wallet key used to auto-pay x402 invoices in USDC on Base (either this or WITNESSD_API_KEY)
  • WITNESSD_API_KEY secret Prepaid witnessd credit key (alternative to EVM_PRIVATE_KEY)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. witnessd-mcp
  2. Tools
  3. Install
  4. Payment — two options
  5. Verify without trusting us
  6. Privacy & scope

witnessd-mcp

MCP server for witnessd — a neutral third-party witness for the machine-readable web.

Give your agent the ability to create tamper-evident evidence: witnessd independently fetches any public URL or API endpoint, hashes and timestamps the response, archives it, and issues a signed certificate. Snapshot hashes are Merkle-batched hourly and anchored on Base, so certificates verify forever — by anyone, without trusting the operator.

Use it before transacting with a counterparty ("witness their published price/terms"), before acting on third-party data ("witness what the API returned"), or whenever a dispute might later hinge on what a URL said at a moment in time.

Tools

ToolPriceWhat it does
witness_url$0.02Independent fetch + hash + timestamp + archive of a URL right now; returns snapshot id + signed certificate
get_certificatefreeCertificate for any snapshot id: manifest, Ed25519 signature, Merkle proof, Base anchor transaction
retrieve_snapshot$0.05The archived response body + certificate — works for any snapshot id, any payer (this is how third parties obtain evidence)

Install

npx -y witnessd-mcp

Claude Desktop / Cursor config:

{
  "mcpServers": {
    "witnessd": {
      "command": "npx",
      "args": ["-y", "witnessd-mcp"],
      "env": {
        "EVM_PRIVATE_KEY": "0x…"
      }
    }
  }
}

Payment — two options

Set one of these environment variables:

  • EVM_PRIVATE_KEY — a wallet key holding USDC on Base. The server auto-pays each call via x402 (the buyer only signs; no ETH needed for gas). Use a small dedicated wallet, never your main one.
  • WITNESSD_API_KEY — a prepaid credit key (buy a $1 pack via POST https://witnessd.vip/api/credits, x402-payable).

Optional: WITNESSD_URL to point at a different witnessd instance (default https://witnessd.vip).

Verify without trusting us

Certificates are self-verifying: leaf_hash = sha256(canonical-json(manifest)), Ed25519-signed, Merkle-proven into an hourly batch root anchored on Base (calldata 0x + wtns1 + root). Standalone checker: witnessd.vip/verify.js.

Privacy & scope

Certificates (hashes, timestamps, proofs) are public; archived content is delivered only to paying requesters and never republished. witnessd only witnesses what any stranger can see — no logins, no private networks, bodies ≤10 MB. Machine-readable service docs: llms.txt · openapi.json · /.well-known/x402.

MIT license.

Frequently asked questions

What is vip.witnessd/witnessd?

Neutral third-party witness: independently fetch, hash, timestamp, archive any URL or API response.

How do I install vip.witnessd/witnessd?

It runs on your machine. In Claude Code: claude mcp add witnessd -e 'WITNESSD_URL=<WITNESSD_URL>' -e 'EVM_PRIVATE_KEY=<your evm_private_key>' -e 'WITNESSD_API_KEY=<your witnessd_api_key>' -- npx -y witnessd-mcp@0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does vip.witnessd/witnessd need an API key?

Yes. It expects EVM_PRIVATE_KEY, WITNESSD_API_KEY, which you set in its configuration.

Is vip.witnessd/witnessd open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains vip.witnessd/witnessd?

It is published by jschunter. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.