Touchstone

MCP server · by cv

AI Agents npmStreamable HTTP v1.1.0

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

View source ↗ Generate config for multiple servers More servers

Install

Pin version registry version 1.1.0

npm
npx -y @touchstone-cv/mcp

npm
npx -y @touchstone-cv/mcp@1.1.0

Streamable HTTP
https://touchstone.cv/mcp

Setup by client

Pick your client — the config below is generated for this server (both local and hosted-endpoint forms). Copy respects the “Pin version” switch above.

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>"
      }
    }
  }
}

{
  "mcpServers": {
    "touchstone": {
      "command": "npx",
      "args": [
        "-y",
        "@touchstone-cv/mcp@1.1.0"
      ],
      "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>"
      }
    }
  }
}

Remote (hosted) endpoint

https://touchstone.cv/mcp

Claude Desktop: Settings → Connectors → Add custom connector, paste this URL, and provide: Authorization.

Format verified against the official Claude Desktop docs ↗.

terminal

claude mcp add --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> touchstone -- npx -y @touchstone-cv/mcp

claude mcp add --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> touchstone -- npx -y @touchstone-cv/mcp@1.1.0

terminal

claude mcp add --transport http touchstone https://touchstone.cv/mcp --header "Authorization: Bearer <YOUR_AUTHORIZATION>"

Format verified against the official Claude Code docs ↗.

.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>"
      }
    }
  }
}

{
  "mcpServers": {
    "touchstone": {
      "command": "npx",
      "args": [
        "-y",
        "@touchstone-cv/mcp@1.1.0"
      ],
      "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>"
      }
    }
  }
}

.cursor/mcp.json (hosted endpoint)

{
  "mcpServers": {
    "touchstone": {
      "url": "https://touchstone.cv/mcp",
      "headers": {
        "Authorization": "<YOUR_AUTHORIZATION>"
      }
    }
  }
}

Format verified against the official Cursor docs ↗.

.vscode/mcp.json

{
  "servers": {
    "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>"
      }
    }
  }
}

{
  "servers": {
    "touchstone": {
      "command": "npx",
      "args": [
        "-y",
        "@touchstone-cv/mcp@1.1.0"
      ],
      "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>"
      }
    }
  }
}

.vscode/mcp.json (hosted endpoint)

{
  "servers": {
    "touchstone": {
      "type": "http",
      "url": "https://touchstone.cv/mcp",
      "headers": {
        "Authorization": "<YOUR_AUTHORIZATION>"
      }
    }
  }
}

Format verified against the official VS Code docs ↗.

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>"
      }
    }
  }
}

{
  "mcpServers": {
    "touchstone": {
      "command": "npx",
      "args": [
        "-y",
        "@touchstone-cv/mcp@1.1.0"
      ],
      "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>"
      }
    }
  }
}

mcp_config.json (hosted endpoint)

{
  "mcpServers": {
    "touchstone": {
      "serverUrl": "https://touchstone.cv/mcp",
      "headers": {
        "Authorization": "<YOUR_AUTHORIZATION>"
      }
    }
  }
}

Format verified against the official Windsurf docs ↗.

Environment variables

Defined in the server's official registry manifest. Required secrets are shown as <YOUR_…> placeholders in the configs above.

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 header — A Touchstone API key as 'Bearer tsk_...' — an agent mints one with its own Colony identity (no browser); see https://touchstone.cv/developers

GitHub

最近更新于 56 天前 · Apache-2.0 license

About this server

touchstone mcp Local MCP server for Touchstone — record what your agent did into a tamper evident, externally anchored log. This server runs on your machine and holds your Ed25519 signing key. It signs each event locally and appends it to your recorder, so an agent only has to call touchstone record…

Summary from the project README — github.com/Touchstone-CV/touchstone-mcp

Distributed as npm, Streamable HTTP, listed under AI Agents. Review our MCP security guide before granting access to real data.

Frequently asked questions

What does the Touchstone MCP server do?

How do I install Touchstone?

Run the install command shown above, then paste the config for your client (Claude Desktop, Claude Code, Cursor, VS Code or Windsurf) into its MCP settings and restart the client.

Is Touchstone free to use?

The MCP server itself is free to install. The source is public on https://github.com/Touchstone-CV/touchstone-mcp. Any third-party service it calls may require its own API key and account.

Which clients support Touchstone?

Any MCP-compatible client can use it, including Claude Desktop, Claude Code, Cursor, VS Code, Windsurf and custom agents.

Add this badge

Publish this server? Link back with a badge on your README or site — copy either snippet.

Markdown

[![Listed on MCPNav](https://mcpnav.net/badge/touchstone.svg)](https://mcpnav.net/server/touchstone/)

HTML

<a href="https://mcpnav.net/server/touchstone/"><img src="https://mcpnav.net/badge/touchstone.svg" alt="Listed on MCPNav" height="20"></a>