marchon/verae-mcp-timestamping-server-go

Watch

Go MCP timestamping server + pkg/tsnats (sibling to Python server)

Go 96.6%
Shell 3.4%

Find a file

Repository files (latest commit first)
Filename	Latest commit message	Latest commit date
George Lambert 2eb9ec72c6 Some checks failed test-and-deploy / test (push) Failing after 10m46s Details test-and-deploy / deploy-138 (push) Has been cancelled Details feat(mcp): oauth_start / oauth_complete for social login Browser OAuth via customer.verae.ai portal (authentik at auth.verae.ai). oauth_start returns authorize_url+state; oauth_complete polls until xVerae- access_token. Open without bearer on public MCP; welcome/register copy updated.		2026-10-20 16:40:50 -04:00
.forgejo/workflows	Add an ns1 test-and-deploy workflow for the Go MCP server.	2026-10-11 05:52:17 +00:00
cmd/verae-mcp-timestamping-server	feat: single-billing edge path for MCP + open public signup	2026-10-12 14:59:31 -04:00
deploy	chore: shadow systemd unit and parity smoke script	2026-09-29 12:14:46 -04:00
docs	docs: L5/L7 PASS after laptop VeraeTime login refresh	2026-09-29 12:33:19 -04:00
examples/tsnats-bulk	docs: cutover checklist and tsnats usage	2026-09-29 12:14:46 -04:00
internal	feat(mcp): oauth_start / oauth_complete for social login	2026-10-20 16:40:50 -04:00
pkg	feat: pkg/tsnats digests-only NATS timestamp client	2026-09-29 11:52:35 -04:00
scripts	fix(auth): clear public write errors and Grok client path	2026-10-12 14:09:22 -04:00
.gitignore	feat: single-billing edge path for MCP + open public signup	2026-10-12 14:59:31 -04:00
go.mod	feat(mcp): optional receipt_format on stamp/verify (text/PDF/JSON/MD/CSV/TSV)	2026-10-20 16:02:20 -04:00
go.sum	feat(mcp): optional receipt_format on stamp/verify (text/PDF/JSON/MD/CSV/TSV)	2026-10-20 16:02:20 -04:00
README.md	feat(mcp): optional receipt_format on stamp/verify (text/PDF/JSON/MD/CSV/TSV)	2026-10-20 16:02:20 -04:00

README.md

verae-mcp-timestamping-server-go

MCP server for digests-only timestamping (public HTTP and local stdio).

Background
Install
Usage
Contributing
License

Background

Public writes require caller Bearer (DEC-654). Optional VERAE_MCP_EDGE_URL bills via zap.verae.ai. Account and auth are required for use. On connect, instructions tell the AI to welcome the user and call tool welcome, then signup / login. Only welcome, signup, and login work without a bearer. signup / login return access_token (public HTTP never writes the host credential). Grok: bearer_token_file or local stdio. Job-complete is core NATS only.

Co-contributors: Grok (xAI), George Lambert, Scott "R00tPiG Security" Lindsey — Verae Inc. (verae.com).

Install

go build -o bin/verae-mcp-timestamping-server ./cmd/verae-mcp-timestamping-server

Usage

./bin/verae-mcp-timestamping-server -transport http -addr :8000
# or -transport stdio for laptop host auth

Optional receipt_format on stamp / verify: omit → text; receipt / PDF-Receipt → PDF; JSON-Receipt → JSON; MD / MD-Receipt; CSV / CSV-Receipt; TSV / TSV-Receipt. Stdio writes under ~/.verae/receipts; public MCP returns content_text / content_base64 only.

Contributing

Questions: open an issue on the project Forgejo/GitHub remote, or contact Verae engineering. PRs are accepted when they include tests and do not leak secrets.