Touchstone MCP Server

Name: Touchstone MCP Server
Author: cv.touchstone

cv.touchstone/touchstone

Repository Registry

What is the Touchstone MCP server?

Bitcoin-anchored, tamper-evident audit log for AI agents — record, disclose and verify actions.

How to install Touchstone

Copy-paste configuration for popular MCP clients.

transport: stdio

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

Environment / auth

TOUCHSTONE_RECORDER
required
Recorder public id (rec_...) to append to.
TOUCHSTONE_SUBJECT
required
The subject Colony sub whose key signs entries.
TOUCHSTONE_API_KEY
required
secret
Touchstone API key (tsk_...) for the append/disclose REST calls.
TOUCHSTONE_SIGNING_KEY
secret
Base64 Ed25519 seed. Signs locally — the key never leaves your machine. Use this or TOUCHSTONE_KEY_FILE.
TOUCHSTONE_KEY_FILE
Path to a file holding the base64 Ed25519 seed (alternative to TOUCHSTONE_SIGNING_KEY).
TOUCHSTONE_BASE_URL
Override the Touchstone API base URL (defaults to https://touchstone.cv).
Authorization
required
secret
A Touchstone API key as 'Bearer tsk_...' — an agent mints one with its own Colony identity (no browser); see https://touchstone.cv/developers

Claude Desktop

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

{
  "mcpServers": {
    "touchstone": {
      "command": "npx",
      "args": [
        "-y",
        "@touchstone-cv/mcp"
      ],
      "env": {
        "TOUCHSTONE_RECORDER": "<YOUR_TOUCHSTONE_RECORDER>",
        "TOUCHSTONE_SUBJECT": "<YOUR_TOUCHSTONE_SUBJECT>",
        "TOUCHSTONE_API_KEY": "<YOUR_TOUCHSTONE_API_KEY>",
        "TOUCHSTONE_SIGNING_KEY": "<YOUR_TOUCHSTONE_SIGNING_KEY>",
        "TOUCHSTONE_KEY_FILE": "<YOUR_TOUCHSTONE_KEY_FILE>",
        "TOUCHSTONE_BASE_URL": "<YOUR_TOUCHSTONE_BASE_URL>",
        "Authorization": "<YOUR_AUTHORIZATION>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "touchstone": {
      "command": "npx",
      "args": [
        "-y",
        "@touchstone-cv/mcp"
      ],
      "env": {
        "TOUCHSTONE_RECORDER": "<YOUR_TOUCHSTONE_RECORDER>",
        "TOUCHSTONE_SUBJECT": "<YOUR_TOUCHSTONE_SUBJECT>",
        "TOUCHSTONE_API_KEY": "<YOUR_TOUCHSTONE_API_KEY>",
        "TOUCHSTONE_SIGNING_KEY": "<YOUR_TOUCHSTONE_SIGNING_KEY>",
        "TOUCHSTONE_KEY_FILE": "<YOUR_TOUCHSTONE_KEY_FILE>",
        "TOUCHSTONE_BASE_URL": "<YOUR_TOUCHSTONE_BASE_URL>",
        "Authorization": "<YOUR_AUTHORIZATION>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "touchstone": {
      "command": "npx",
      "args": [
        "-y",
        "@touchstone-cv/mcp"
      ],
      "env": {
        "TOUCHSTONE_RECORDER": "<YOUR_TOUCHSTONE_RECORDER>",
        "TOUCHSTONE_SUBJECT": "<YOUR_TOUCHSTONE_SUBJECT>",
        "TOUCHSTONE_API_KEY": "<YOUR_TOUCHSTONE_API_KEY>",
        "TOUCHSTONE_SIGNING_KEY": "<YOUR_TOUCHSTONE_SIGNING_KEY>",
        "TOUCHSTONE_KEY_FILE": "<YOUR_TOUCHSTONE_KEY_FILE>",
        "TOUCHSTONE_BASE_URL": "<YOUR_TOUCHSTONE_BASE_URL>",
        "Authorization": "<YOUR_AUTHORIZATION>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "touchstone": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@touchstone-cv/mcp"
      ],
      "env": {
        "TOUCHSTONE_RECORDER": "<YOUR_TOUCHSTONE_RECORDER>",
        "TOUCHSTONE_SUBJECT": "<YOUR_TOUCHSTONE_SUBJECT>",
        "TOUCHSTONE_API_KEY": "<YOUR_TOUCHSTONE_API_KEY>",
        "TOUCHSTONE_SIGNING_KEY": "<YOUR_TOUCHSTONE_SIGNING_KEY>",
        "TOUCHSTONE_KEY_FILE": "<YOUR_TOUCHSTONE_KEY_FILE>",
        "TOUCHSTONE_BASE_URL": "<YOUR_TOUCHSTONE_BASE_URL>",
        "Authorization": "<YOUR_AUTHORIZATION>"
      }
    }
  }
}

Claude Code

claude mcp add touchstone --env TOUCHSTONE_RECORDER=<YOUR_TOUCHSTONE_RECORDER> --env TOUCHSTONE_SUBJECT=<YOUR_TOUCHSTONE_SUBJECT> --env TOUCHSTONE_API_KEY=<YOUR_TOUCHSTONE_API_KEY> --env TOUCHSTONE_SIGNING_KEY=<YOUR_TOUCHSTONE_SIGNING_KEY> --env TOUCHSTONE_KEY_FILE=<YOUR_TOUCHSTONE_KEY_FILE> --env TOUCHSTONE_BASE_URL=<YOUR_TOUCHSTONE_BASE_URL> --env Authorization=<YOUR_AUTHORIZATION> -- npx -y @touchstone-cv/mcp