MCP Server

three.ws Provenance MCP Server

Name: three.ws Provenance MCP Server
Author: io.github.nirholas

io.github.nirholas/provenance-mcp

Repository Registry

What is the three.ws Provenance MCP server?

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

How to install three.ws Provenance

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

THREE_WS_BASE
Base 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_MS
Per-request timeout in milliseconds for the ledger reads/appends.
THREE_WS_TOKEN
required
secret
Bearer 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.
THREE_WS_SIGNER_KEY
secret
Optional 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.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

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

Cursor

~/.cursor/mcp.json

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

Windsurf

~/.codeium/windsurf/mcp_config.json

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

VS Code

.vscode/mcp.json

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

Claude Code

claude mcp add provenance-mcp --env THREE_WS_BASE=<YOUR_THREE_WS_BASE> --env THREE_WS_TIMEOUT_MS=<YOUR_THREE_WS_TIMEOUT_MS> --env THREE_WS_TOKEN=<YOUR_THREE_WS_TOKEN> --env THREE_WS_SIGNER_KEY=<YOUR_THREE_WS_SIGNER_KEY> -- npx -y @three-ws/provenance-mcp

Related MCP servers

3D AI Agent Avatar

3D AI Agent Avatar — render any GLB, give it a Solana wallet, a voice, and pump.fun powers.

View repository →

three.ws 3D Agent Tools

MCP tools from three.ws: free + paid text-to-3D, rigging, agent reputation, market intel.

View repository →

UCAI

UCAI — The ABI-to-MCP Server Generator. Convert any smart contract ABI into an AI-ready MCP server.

View repository →

three.ws Activity

Trending agents and coins, the $THREE holder leaderboard, and the site-wide activity ticker.

View repository →

three.ws AgenC

Browse the AgenC on-chain task marketplace, query the agent registry, and link identities.

View repository →

Agent Sniper

Self-custodial pump.fun sniper: arm strategies, snipe, manage positions. Simulate by default.

View repository →