Skip to content
MCP server

three.ws Provenance

Append-only, signed, on-chain-verifiable agent action log — record and audit what agents…

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
0.1.3
Listing updated
5 days ago

About three.ws Provenance

three.ws Provenance is an open-source MCP server. It runs locally on your machine and is started by your AI client.

Append-only, signed, on-chain-verifiable agent action log — record and audit what agents did.

Install

Run in a terminal

claude mcp add provenance-mcp --env THREE_WS_TOKEN='<THREE_WS_TOKEN>' --env THREE_WS_SIGNER_KEY='<THREE_WS_SIGNER_KEY>' -- npx -y @three-ws/provenance-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "provenance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/provenance-mcp"
      ],
      "env": {
        "THREE_WS_TOKEN": "<THREE_WS_TOKEN>",
        "THREE_WS_SIGNER_KEY": "<THREE_WS_SIGNER_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "provenance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/provenance-mcp"
      ],
      "env": {
        "THREE_WS_TOKEN": "<THREE_WS_TOKEN>",
        "THREE_WS_SIGNER_KEY": "<THREE_WS_SIGNER_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "provenance-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/provenance-mcp"
      ],
      "env": {
        "THREE_WS_TOKEN": "<THREE_WS_TOKEN>",
        "THREE_WS_SIGNER_KEY": "<THREE_WS_SIGNER_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "provenance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/provenance-mcp"
      ],
      "env": {
        "THREE_WS_TOKEN": "<THREE_WS_TOKEN>",
        "THREE_WS_SIGNER_KEY": "<THREE_WS_SIGNER_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "provenance-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/provenance-mcp"
      ],
      "env": {
        "THREE_WS_TOKEN": "<THREE_WS_TOKEN>",
        "THREE_WS_SIGNER_KEY": "<THREE_WS_SIGNER_KEY>"
      }
    }
  }
}

Configuration

  • THREE_WS_BASEBase URL of the three.ws API that serves the agent-actions ledger. Override only when self-hosting or targeting a preview deployment.
  • THREE_WS_TIMEOUT_MSPer-request timeout in milliseconds for the ledger reads/appends.
  • THREE_WS_TOKENBearer token authenticating every call — a three.ws API key (sk_live_…) or an OAuth access token. The ledger is owner-scoped: you can read and append actions only for agents your token owns. Required for all three tools. Treat like a password.Required
  • THREE_WS_SIGNER_KEYOptional 0x-prefixed EVM private key. When set, append_agent_action ERC-191-signs each action so anyone can ecrecover the signer and verify authorship on-chain. A per-call `signer_key` arg overrides it. Omit to append unsigned. Treat like cash.

Pricing

Open source

Prices change. Check three.ws before you buy.

three.ws Provenance FAQ

Is three.ws Provenance free?

Yes. three.ws Provenance is open source, so you can use and self-host it for free.

How do I add three.ws Provenance to Claude Code?

Run this command in your terminal: claude mcp add provenance-mcp --env THREE_WS_TOKEN='<THREE_WS_TOKEN>' --env THREE_WS_SIGNER_KEY='<THREE_WS_SIGNER_KEY>' -- npx -y @three-ws/provenance-mcp