marchon/verae-mcp-timestamping-server
Watch
1
0
Fork
You've already forked verae-mcp-timestamping-server
 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
No description
5 commits 1 branch 0 tags 91 MiB
  • 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 107fa785b0 feat: route scope=global stamp/verify to api.veraetime.net 
Evercycle-style local facade: GlobalClient posts /api/timestamp and
/api/verify with Bearer from VERAE_GLOBAL_TOKEN or ~/.verae/auth.properties.
2026-09-20 10:07:41 -04:00
src/verae_mcp_timestamping_server feat: route scope=global stamp/verify to api.veraetime.net 2026-09-20 10:07:41 -04:00
tests feat: route scope=global stamp/verify to api.veraetime.net 2026-09-20 10:07:41 -04:00
.gitignore chore: initialize verae-mcp-timestamping-server 2026-09-20 01:24:13 -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 feat: route scope=global stamp/verify to api.veraetime.net 2026-09-20 10:07:41 -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

standard-readme compliant

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

Global stamp (central VeraeTime):

export VERAE_GLOBAL_URL=https://api.veraetime.net
export VERAE_GLOBAL_TOKEN=  # or put access_token= in ~/.verae/auth.properties
# then call tool stamp with scope=global

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

Contributing

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

License

UNLICENSED © George Lambert