Tersign Evidence MCP Server

by tersignhqio.github.tersignhq/evidencev0.6.2

Counter-signed evidence records for agent commerce: receipts, verification, dispute envelopes.

1Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Active3d ago

Install Tersign Evidence MCP server

claude mcp add tersign -e TERSIGN_SELLER_KEY='<tersign-seller-key>' -e TERSIGN_LEDGER_API_KEY='<tersign-ledger-api-key>' -- npx -y tersign

{
  "mcpServers": {
    "tersign": {
      "command": "npx",
      "args": [
        "-y",
        "tersign"
      ],
      "env": {
        "TERSIGN_SELLER_KEY": "<tersign-seller-key>",
        "TERSIGN_LEDGER_API_KEY": "<tersign-ledger-api-key>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "tersign": {
      "command": "npx",
      "args": [
        "-y",
        "tersign"
      ],
      "env": {
        "TERSIGN_SELLER_KEY": "<tersign-seller-key>",
        "TERSIGN_LEDGER_API_KEY": "<tersign-ledger-api-key>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "tersign": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tersign"
      ],
      "env": {
        "TERSIGN_SELLER_KEY": "<tersign-seller-key>",
        "TERSIGN_LEDGER_API_KEY": "<tersign-ledger-api-key>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "tersign": {
      "command": "npx",
      "args": [
        "-y",
        "tersign"
      ],
      "env": {
        "TERSIGN_SELLER_KEY": "<tersign-seller-key>",
        "TERSIGN_LEDGER_API_KEY": "<tersign-ledger-api-key>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
TERSIGN_SELLER_KEY	—	yes	Optional: your own 0x-prefixed signing key. Unset or empty, the server uses the key in the macOS keychain (tersign-signer) or ~/.tersign/signer.key, and generates one there on first run. The key never leaves your machine. If your ledger account has a registered signing key, set that key here: the ledger rejects respondent dispute evidence signed by any other key.
TERSIGN_ISSUER_NAME	—	—	Seller/issuer display name
TERSIGN_ISSUER_JURISDICTION	—	—	Seller jurisdiction (e.g. HK)
TERSIGN_ISSUER_TAX_ID	—	—	Seller tax/business-registration id (optional)
TERSIGN_LEDGER_URL	—	—	Ledger base URL (optional). Needed by the dispute tools, and with the API key and seller id by record_refund and chained issue_receipt; record_disclosure defaults to https://tersign.ai
TERSIGN_LEDGER_API_KEY	—	yes	Ledger seller API key (optional). With TERSIGN_LEDGER_URL and TERSIGN_LEDGER_SELLER_ID it enables record_refund and chained issue_receipt; with TERSIGN_LEDGER_URL it authenticates respondent dispute evidence. record_disclosure needs no API key.
TERSIGN_LEDGER_SELLER_ID	—	—	Ledger seller id (optional). With TERSIGN_LEDGER_URL and TERSIGN_LEDGER_API_KEY it enables record_refund and chained issue_receipt.

Freshness

Active — last maintenance signal 3d ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-10-07 · 3d ago · GitHub
Latest release
2026-08-29 · 41d ago · GitHub · v0.4.7
Package published
no data · npm/PyPI
Registry entry updated
2026-10-07 · 3d ago · official registry · v0.6.2

FAQ

›How do I install the Tersign Evidence MCP server in Claude Code?

Run: claude mcp add tersign -e TERSIGN_SELLER_KEY='<tersign-seller-key>' -e TERSIGN_LEDGER_API_KEY='<tersign-ledger-api-key>' -- npx -y tersign. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Tersign Evidence require an API key?

Yes. It expects TERSIGN_SELLER_KEY, TERSIGN_LEDGER_API_KEY, of which 2 are secrets.

›Can I use Tersign Evidence as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Tersign Evidence in the official MCP registry?

Yes, as io.github.tersignhq/evidence.