three.ws Provenance
Append-only, signed, on-chain-verifiable agent action log — record and audit what agents…
- 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-mcpAdd 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.RequiredTHREE_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