@helm-protocol/ttt-mcp

Reference implementation of draft-helmprotocol-tttps-00 (IETF Experimental)

MCP Server for OpenTTT — Proof of Time tools for AI agents

AI Agent A and Agent B both trigger a payment at the same time. Who was first?

OpenTTT answers this with cryptographic Proof of Time — synthesized from multiple independent time sources, verified through GRG integrity shards, and signed with Ed25519 for non-repudiation.

Quick Start

npm install @helm-protocol/ttt-mcp

// claude_desktop_config.json
{
  "mcpServers": {
    "ttt": {
      "command": "npx",
      "args": ["@helm-protocol/ttt-mcp"]
    }
  }
}

That's it. Your AI agent now has access to 5 Proof of Time tools.

Tools

| Tool | Description | |------|-------------| | pot_generate | Generate a Proof of Time for a transaction | | pot_verify | Verify a Proof of Time using its hash and GRG shards | | pot_query | Query PoT history from local log and on-chain subgraph | | pot_stats | Get turbo/full mode statistics for a time period | | pot_health | Check system health: time sources, subgraph sync, uptime |

Tool Parameters

pot_generate

Generate a Proof of Time for a transaction. Returns potHash, timestamp, stratum, and GRG integrity shards.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | txHash | string | Yes | Transaction hash (hex with 0x prefix) | | chainId | number | Yes | Chain ID (e.g. 8453 for Base, 84532 for Base Sepolia) | | poolAddress | string | Yes | DEX pool contract address |

pot_verify

Verify a Proof of Time using its hash and GRG shards. Returns validity, mode (turbo/full), and timestamp.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | potHash | string | Yes | PoT hash to verify (hex with 0x prefix) | | grgShards | string[] | Yes | Array of hex-encoded GRG integrity shards | | chainId | number | Yes | EVM chain ID (e.g. 84532 for Base Sepolia) | | poolAddress | string | Yes | Uniswap V4 pool address (0x-prefixed) |

pot_query

Query Proof of Time history from local log and on-chain subgraph.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | startTime | number | No | Start time (unix ms). Default: 24h ago | | endTime | number | No | End time (unix ms). Default: now | | limit | number | No | Max entries to return. Default: 100, max: 1000 |

pot_stats

Get PoT statistics: total swaps, turbo/full counts, and turbo ratio for a given period.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | period | "day" | "week" | "month" | Yes | Time period for statistics |

pot_health

Check PoT system health: time source status, subgraph sync, server uptime, and current mode.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | (none) | — | — | This tool takes no parameters |

Example: Generate and Verify a PoT

// In your AI agent's tool call:
const pot = await pot_generate({
  txHash: "0xabc123...",
  chainId: 84532,
  poolAddress: "0xdef456..."
});

// pot.potHash — unique Proof of Time hash
// pot.grgShards — GRG integrity shards for verification
// pot.timestamp — synthesized nanosecond timestamp
// pot.mode — "turbo" (honest) or "full" (requires full verification)

const verification = await pot_verify({
  potHash: pot.potHash,
  grgShards: pot.grgShards
});
// verification.valid — true if integrity shards reconstruct correctly

How It Works

1. Time Synthesis — Queries multiple independent time sources (NIST, Google, Cloudflare) via HTTPS/NTP and synthesizes a median timestamp with uncertainty bounds
2. GRG Pipeline — Encodes transaction data through a multi-layer integrity pipeline, producing verifiable shards
3. Ed25519 Signing — Signs the PoT hash for non-repudiation
4. Adaptive Mode — Honest builders get turbo mode (fast, profitable); tampered sequences get full mode (slow, costly) — natural economic selection

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "ttt": {
      "command": "npx",
      "args": ["@helm-protocol/ttt-mcp"]
    }
  }
}

Config file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Requirements

• Node.js >= 18
• Network access for time synthesis (HTTPS to time.nist.gov, time.google.com, time.cloudflare.com)

Learn More

• OpenTTT SDK — The underlying SDK
• IETF Draft: draft-helmprotocol-tttps-00 — TTTPS Protocol Specification
• Helm Protocol — GitHub

License

MIT