witnessd

witnessd is a plugin for Claude Code from jschunter/witnessd-mcp. Its manifest loads nothing; the 1 skill it bundles cost 187 tokens per session together, scanned A, original, MIT.

A connection to witnessd, a service that captures a public URL or API response, signs and timestamps it, and anchors its fingerprint on the Base blockchain. Calls cost money and use USDC, a cryptocurrency designed to track the U.S. dollar.

In plain words
What is it for?
Use it when a web page or API response may matter later as evidence, while observing the service's payment and approval limits.
Why use it?
It gives you independently verifiable evidence of what a website returned, instead of relying solely on records kept by your own system.

Plugin for Claude Code

Written for Claude Code: a Claude Code plugin manifest. Also seen: positional $N argument.

Good fit Use it when a web page or API response may matter later as evidence, while observing the service's payment and approval limits.

Compare 6 plugins from other repositories ↓
Install in Claude Code
/plugin marketplace add jschunter/witnessd-mcp
/plugin install witnessd
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Clone the repo
git clone --depth 1 https://github.com/jschunter/witnessd-mcp

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for witnessd

README.md
[![agentmods](https://agentmods.dev/badge/plugins/jschunter/witnessd-mcp/plugin/github.svg)](https://agentmods.dev/plugins/jschunter/witnessd-mcp/plugin)
Your own site
<a href="https://agentmods.dev/plugins/jschunter/witnessd-mcp/plugin"><img src="https://agentmods.dev/badge/plugins/jschunter/witnessd-mcp/plugin/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for witnessd

Your own site · 80×15
<a href="https://agentmods.dev/plugins/jschunter/witnessd-mcp/plugin"><img src="https://agentmods.dev/badge/plugins/jschunter/witnessd-mcp/plugin.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session not measured What this adds to a session before it is invoked.
When invoked not measured The manifest loads nothing itself; its 1 skill cost 187 tokens a session between them.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Security

Grade A, and why

witnessd scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured today.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugin/.claude-plugin/plugin.json · 39 lines

What it actually says

{
  "name": "witnessd",
  "version": "1.0.1",
  "displayName": "witnessd: neutral web witness",
  "description": "Teaches Claude when to get tamper-evident, third-party evidence of what a public URL or API returned, and connects the witnessd MCP server ($0.02 per snapshot via x402 USDC on Base, Merkle-anchored on-chain, verifiable by anyone).",
  "author": { "name": "witnessd" },
  "homepage": "https://witnessd.vip",
  "repository": "https://github.com/jschunter/witnessd-mcp",
  "license": "MIT",
  "keywords": ["evidence", "notary", "witness", "timestamp", "x402", "mcp", "agent-payments", "audit"],
  "mcpServers": {
    "witnessd": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": {
        "WITNESSD_URL": "https://witnessd.vip",
        "EVM_PRIVATE_KEY": "${user_config.evm_private_key}",
        "WITNESSD_API_KEY": "${user_config.witnessd_api_key}"
      }
    }
  },
  "userConfig": {
    "evm_private_key": {
      "type": "string",
      "title": "Wallet private key (USDC on Base)",
      "description": "Key of a SMALL dedicated wallet holding a few dollars of USDC on Base. Used only to pay witnessd per call ($0.02 witness, $0.05 retrieve). Leave empty if you use an API key instead, or for free certificate lookups only.",
      "sensitive": true,
      "default": ""
    },
    "witnessd_api_key": {
      "type": "string",
      "title": "witnessd API key (optional alternative)",
      "description": "Prepaid witnessd credit key (starts with wk_). Use this OR the wallet key. Leave empty if unused.",
      "sensitive": true,
      "default": ""
    }
  }
}
Contents

What it installs

The manifest is a name and a version. 1 skill travel with it, and installing the plugin installs all of them — 187 tokens a session between them. Each is measured on its own page, and each can be installed alone.

Files

What ships with it

1 file beside plugin.json in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. today First seen · 39 lines scan A 322f2ea680dc

Subscribe to this mod's changes

witnessd is a plugin published in the GitHub repository jschunter/witnessd-mcp (0 stars, last pushed today), licensed MIT. Its token cost is not measured: this kind of file is read by the harness, not the model. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-10-27.