Watch

No description

HTML 75.2%
Python 19.3%
JavaScript 4.9%
Shell 0.6%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
George Lambert e96fa13edd docs: sample MCP page for stamp, verify, and hash report WhatToChange: recommended-changes/2026-09-21-sample-page/ What-to-Change.md What-to-Change-To.md How-to-implement-the-changes.md What was actually done: - site/index.html calls stamp, verify, or hash_report over Streamable HTTP. - README points at the sample page and https://mcp.georgelambert.org/. What was not done: - The public host does not reverse-proxy the MCP listener. A page on the internet cannot call 127.0.0.1, and the VeraeTime bearer token stays off an open listener.		2026-09-21 14:14:45 -04:00
debug-trace	docs: 100000-stamp load test (99999 ok, 1 fail)	2026-09-20 21:59:04 -04:00
docs	docs: HTML and PDF set plus optional CORS	2026-09-21 14:13:07 -04:00
recommended-changes	docs: sample MCP page for stamp, verify, and hash report	2026-09-21 14:14:45 -04:00
scripts	docs: HTML and PDF set plus optional CORS	2026-09-21 14:13:07 -04:00
site	docs: sample MCP page for stamp, verify, and hash report	2026-09-21 14:14:45 -04:00
src/verae_mcp_timestamping_server	docs: HTML and PDF set plus optional CORS	2026-09-21 14:13:07 -04:00
tests	feat: stamp wait=true so MCP skips HTTP job polling	2026-09-20 13:16:22 -04:00
.gitignore	fix: keep global HTTP off the event loop	2026-09-21 14:11:29 -04:00
LICENSE	chore: initialize verae-mcp-timestamping-server	2026-09-20 01:24:13 -04:00
pyproject.toml	feat: hash-only stamp, verify, and hash_report MCP tools	2026-09-20 02:59:00 -04:00
README.md	docs: sample MCP page for stamp, verify, and hash report	2026-09-21 14:14:45 -04:00
uv.lock	feat: hash-only stamp, verify, and hash_report MCP tools	2026-09-20 02:59:00 -04:00

README.md

verae-mcp-timestamping-server

Verae MCP timestamping server. Hash-only stamps via leaf locald/NATS.

The MCP process never hashes content. Clients send a SHA-256 hex digest. scope=local writes ~/.verae/mcp-timestamp-local.json. scope=global POSTs to https://api.veraetime.net/api/timestamp (same wire as verae-timestamp/global.Client). want_scope=global verifies against that API as the central source of truth. Bearer token: VERAE_GLOBAL_TOKEN or ~/.verae/auth.properties.

Install

cd /Users/marchon/research/modelcontextprotocol/verae-mcp-timestamping-server
uv sync --group dev

Usage

Inspector (stdio, memory ledger):

uv run mcp dev src/verae_mcp_timestamping_server/server.py

Streamable HTTP (http://127.0.0.1:8000/mcp):

VERAE_MCP_TRANSPORT=streamable-http uv run verae-mcp-timestamping-server

Tests:

uv run pytest

HTTP stamp traces (HTML viewer) live under debug-trace/<YYYY-MM-DDTHHMMSSZ>-<slug>/:

uv run python scripts/transaction_log_test.py
open debug-trace/2026-09-20T143541Z-verae-debug-test/transaction-log-test.html

Global stamp (central VeraeTime). Token lives at ~/.verae/auth.properties (mode 600):

# refresh: POST https://api.veraetime.net/auth/login → access_token=
# or: export VERAE_GLOBAL_TOKEN=...
# then stamp with scope=global

Do not send file bytes to stamp. Local receipts persist at ~/.verae/mcp-timestamp-local.json (VERAE_LEDGER_PATH).

Printed and HTML copies of the operator guide, architecture, tool API, and standards:

bash scripts/build-docs.sh
open docs/html/index.html

Sources: docs/operator-guide.md, docs/architecture.md, docs/api.md, docs/standards.md.

Sample page (talks to Streamable HTTP on this machine):

open site/index.html

Public copy of the page and the docs: https://mcp.georgelambert.org/.

Contributing

Questions: this research workspace. PRs welcome. Protocol questions belong at https://github.com/modelcontextprotocol. Timestamp ledger questions belong with verae-timestamp / locald.

README.md

verae-mcp-timestamping-server

Install

Usage

Contributing

License