tersign
OfficialTersign is an evidence layer for agent commerce, providing a suite of tools to issue, verify, and manage cryptographically signed, hash-chained records for transactions, disclosures, refunds, and disputes.
Issue Signed Receipts: Create x402 offer-receipts (EIP-712) with compliance records for settled payments, optionally counter-signed by the ledger.
Verify Receipts: Authenticate receipt artifacts and optionally enforce an expected signer.
Record Disclosures: Generate counter-signed evidence of AI disclosures, digesting the text locally to protect privacy (e.g., EU AI Act Art. 50).
Verify Compliance Records: Validate compliance record attestations and their digest bindings.
Record Refunds: Link refunds to original receipts in the ledger.
Open Disputes: Start objective disputes with reason codes like not_delivered, wrong_content, or duplicate_charge.
Submit Dispute Evidence: Attach signed evidence to disputes with role-based permissions.
Adjudicate Disputes: Trigger deterministic resolution that may automatically create refund records.
Fetch Dispute Records: Retrieve full dispute details including evidence, verdict, and rationale.
Anchors the Tersign hash-chain head to the Bitcoin blockchain on a six-hourly cron, providing public, immutable timestamping for counter-signed ledger entries.
Uses Cloudflare D1 as an idempotency store for receipt issuance, ensuring duplicate requests do not create duplicate records.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tersignverify the receipt for the last transaction"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Tersign is the evidence layer for the agent economy — a neutral, counter-signed, hash-chained ledger for agent commerce. Sellers sign EIP-712 receipts; Tersign chains them per seller and counter-signs every entry. When the dispute comes, the transcript is already sealed.
Venues rotate. The transcript endures.
Verify a Real Entry — Right Now
No account. No API key. This is the genesis receipt, seq 1 on the production chain:
npx tersign verify 0xe5874f1ffe87f0a6dd9eb157730f67b86ee4538b125fe30fcc4e165213dd3fc4ledger: counter-signed OK (seller tersign-first, seq 1 …) VALIDnpx tersign verify <receipt.json | 0xdigest> [--ledger url] recovers the EIP-712 signature locally. A bare digest is then checked against the Tersign ledger unless --ledger names another; a receipt file verifies offline and touches no chain at all. The ledger consulted is always printed. Prefer raw HTTP? The same proof, no CLI:
curl https://tersign.ai/v1/receipts/0xe5874f1ffe87f0a6dd9eb157730f67b86ee4538b125fe30fcc4e165213dd3fc4/verifyRelated MCP server: touchstone-mcp
One-Call Disclosure Evidence
Counter-signed evidence that your agent presented a disclosure — one command, no account:
npx tersign disclose "You are chatting with an AI assistant." --medium chat --agent-id my-agentThe text is digested locally (only the digest travels — data-minimization by construction). Your key signs the record; the ledger counter-signs it into a per-signer hash chain whose head is submitted for Bitcoin anchoring on a six-hourly cron. First call self-provisions a free signer-keyed account bound set-once to your key (key resolution: TERSIGN_SELLER_KEY env → macOS keychain tersign-signer → ~/.tersign/signer.key, created on first use). Free tier is quota- and rate-limited — limits. What this is: independently verifiable evidence the disclosure was attested at that time. What it is not: a compliance certification.
Chain of Custody
Every entry takes the same path: the seller signs the receipt (EIP-712, x402 offer-receipt extension) → Tersign computes the keccak256 canonical digest → the digest joins that seller's hash chain, each seq n bound to seq n−1 → the neutral ledger counter-signs (secp256k1) → anyone verifies, and any venue gets a serialized envelope.
graph LR
A["agent transaction<br/>x402"] --> B["seller-signed receipt<br/>EIP-712"]
B --> C["canonical digest<br/>keccak256"]
C --> D["per-seller hash chain<br/>seq n binds seq n−1"]
D --> E["neutral counter-signature<br/>secp256k1 ledger"]
E --> F["verifiable by anyone<br/>venue-ready envelope"]Diagram renders on GitHub. On npm, the paragraph above IS the diagram.
Refunds chain back to the original receipt via refundOf. Disputes attach to the digest with objective reason codes. Party statements are structurally segregated behind an UNVERIFIED marker — the evidence stays prompt-injection-hardened.
Enter the Record
npm i tersignwithAssure() wraps your x402 fetch handler so every paid call issues a signed, chained receipt. The full register:
Capability | In the record |
Receipts | Seller-signed EIP-712 (x402 offer-receipt extension), keccak256 canonical digests |
| x402 fetch-handler adapter — a receipt per paid call |
Compliance records | EU Art-226b minimal tier · EN 16931 full tier · HK IRO s.51C retention |
Action records |
|
Refunds | Chained to the original receipt via |
Disputes v0 | Objective reason codes, evidence submission, adjudication |
Venue envelopes | Internet Court (5,000-char slot) · Kleros ERC-1497 · UMA · generic |
Evidence packs |
|
Idempotency | In-memory + Cloudflare D1 stores |
| Audit capture at the MCP boundary — a signed, digest-only action record per tool call (experimental) |
Capture at the MCP Boundary — tersign intercept
An agent's tool calls are usually recorded, if at all, by the party running the agent. Put a recording clamp on the wire instead:
npx tersign intercept -- npx your-mcp-serverThe proxy is a pure observer: bytes reach the server and the client exactly as sent, in
order, unmodified. Every tools/call it sees becomes an ActionRecordV1 signed by your key
and counter-signed into a hash chain — digests only, so the record proves what happened
without carrying arguments or results anywhere. Records go to a configured ledger, and fall
back to a local ~/.tersign/intercepts-<date>.jsonl so evidence is never silently dropped.
Experimental, and deliberately unopinionated about where the protocol lands: it implements the observation semantics of the audit-mode validator described in MCP SEP-2624 (Draft) as a transport-level proxy today, and is structured to move onto the interceptor primitive if and when that stabilizes. It makes no conformance claim to that draft.
For Agents — the MCP Server
npx tersign starts the MCP server (stdio). Official registry entry: io.github.tersignhq/evidence (active).
{
"mcpServers": {
"tersign": {
"command": "npx",
"args": ["tersign"],
"env": { "TERSIGN_SELLER_KEY": "0x<your-seller-key>" }
}
}
}Tools — issue_receipt · verify_receipt · verify_compliance_record · record_disclosure · record_refund · open_dispute · submit_dispute_evidence · adjudicate_dispute · get_dispute
Env var | Required | Purpose |
| yes | 0x-prefixed private key that signs your receipts and records |
| no | hosted ledger for counter-signing + chain checks |
| no | your seller API key on that ledger |
| no | your seller id on that ledger |
| no | issuer name stamped on compliance records |
| no | issuer jurisdiction stamped on compliance records |
Cold to counter-signed in one session: call issue_receipt, then check the issued receipt's digest with npx tersign verify <digest> --ledger <url>.
The agent skill tersign-evidence ships at tersignhq/skills.
The Live Record
Ledger + dashboard — public verify page: https://tersign.ai/verify
Census — hash-chained observations across the live x402 seller catalog, probed autonomously; the numbers are served live, never quoted stale: https://prober.tersign.ai/v1/prober/stats
Conformance — RFC 8785 (JCS) canonical serialization, keccak256 digests, and the public two-sided vector suite (canonical bytes, number domain, content address, chain continuity, completeness, anchored existence, phase separation, offer binding, independence — every criterion carrying both an accepting and an adversarial vector): tersignhq/evidence-record-conformance. Reproduce the bytes and your implementation is conformant — in any language.
Standards — the
compliance-fieldsextension — a typed compliance-record schema plus four evaluator-side disqualifications (independence, completeness/existence, economic-phase separation, and commitment scope — an independence claim reaches exactly as far as the record's own commitments), each executable as a two-sided conformance vector — is under review upstream (x402-foundation/x402#2853) and referenced in the x402 TSC's evidence-record charter agenda (tsc#4). The merged offer-receipt spec already carries the completeness criterion at SHOULD strength (§4.5.1, #2811).
Machine Surfaces
Full URLs, readable without auth. If you are an agent, start here.
Surface | Address |
npm package |
|
MCP registry |
|
ARD catalog (Agentic Resource Discovery) | |
Verify API |
|
Envelope API |
|
Ledger stats |
|
Ledger signer |
|
llms.txt | https://raw.githubusercontent.com/tersignhq/tersign-js/main/llms.txt |
Conformance vectors (RFC 8785 + keccak256) | https://github.com/tersignhq/tersign-js/blob/main/test/fixtures/canonical-vectors.json |
Sample compliance record + digests | https://github.com/tersignhq/tersign-js/blob/main/test/fixtures/compliance-record.json |
Genesis verify |
|
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- FlicenseDqualityCmaintenanceMCP server for the Recite API, enabling receipt scanning, transaction management, batch processing, and local ledger workflows for agents.57

touchstone-mcpofficial
AlicenseNot gradedqualityBmaintenanceLocal MCP server that signs and records agent actions into a tamper-evident log using Ed25519 keys for frictionless integration with Touchstone.54Apache 2.0- AlicenseAqualityAmaintenanceMCP server for GoCertius: certified evidence, dossiers, notifications and chats via AI agents.41173MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server for agent authorization that tests the full effect surface and enforces control over consequential actions before dispatch, emitting verifiable execution evidence.1Apache 2.0
Related MCP Connectors
MCP Server for agents to onboard, pay, and provision services autonomously with InFlow
Hosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.
A paid remote MCP for agent memory MCP, built to return verdicts, receipts, usage logs, and audit-re
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/tersignhq/tersign-js'
If you have feedback or need assistance with the MCP directory API, please join our Discord server