# Truestamp

> Truestamp issues independently verifiable cryptographic proofs that specific data
> existed at a specific time and has not changed since. It proves WHEN data was
> submitted, within a verifiable submission window (not when it was created, and not
> authorship). Anyone can verify a proof offline, without trusting Truestamp.

This file is a map for LLM agents, not a manual. It deliberately does not embed how
Truestamp works (that would go stale). Discover current, code-synced knowledge and
operate Truestamp through the tools and endpoints below; prefer them over memory.

## Knowledge base (how Truestamp works)

A code-synced knowledge base covers every concept:
product, verification, cryptography, merkle, entropy, blockchain, items, teams, accounts, api, integrations, glossary, library. Reach it with three tools
(index-first, then drill), available over the MCP server below:

- `kb_search(query, domain?, limit?)` returns lightweight hits (concept id, title,
  summary, section anchors), no bodies.
- `kb_fetch(id, anchor?)` returns one concept TOC-first, or one section by anchor.
  Fetch id `"<domain>/index"` to list a domain, or `"index"` for the whole base.
- `kb_links(id, direction?)` returns a concept's related and prerequisite concepts
  plus its backlinks, to traverse between concepts.

Use these for any "how does X work" question instead of answering from memory; the
knowledge base is the authoritative source of truth.

## MCP server (operate Truestamp)

Native MCP server at `https://www.truestamp.com/mcp` (MCP Streamable HTTP transport, OAuth 2.1, no API
key to paste). A compliant client (Claude Code, Claude.ai connectors, IDE agents)
discovers the authorization server, self-registers, and runs the sign-in and consent
flow, then connects with a short-lived token. Call `quickstart` first to orient.
This is the preferred surface for operating Truestamp from an agent, and how you reach
`kb_search` / `kb_fetch`. Add it to Claude Code:

    claude mcp add --transport http truestamp https://www.truestamp.com/mcp

## HTTP APIs (integrate over REST / GraphQL)

To write integration code against the API-key HTTP surfaces, start with the full guide
(authentication, team-context headers, conventions, proof generate and verify, plus an
auto-generated endpoint and GraphQL-operation index):

- [Full API guide for agents](https://www.truestamp.com/llms-full.txt) : start here to integrate over HTTP
- [GraphQL Playground](https://www.truestamp.com/gql/playground) : interactive GraphQL explorer
- [JSON:API Swagger UI](https://www.truestamp.com/api/json/swaggerui) : interactive REST reference
- [OpenAPI spec](https://www.truestamp.com/api/json/open_api) : machine-readable OpenAPI 3.0 for code generation
- [Public entropy beacon](https://www.truestamp.com/beacons) : live verifiable randomness from the latest block

## Optional (human pages)

- [Home](https://www.truestamp.com/) : platform overview, features, and use cases
- [Security](https://www.truestamp.com/security) : security practices and architecture
- [Privacy Policy](https://www.truestamp.com/privacy-policy)
- [Terms of Service](https://www.truestamp.com/terms-of-service)