Tvarka Proof

Eight tools to seal files with a qualified timestamp and capture web pages as evidence, with page monitors and evidence bundles. Each proof gets a PDF certificate and a check link. Remote server at https://sign-api.tvarka.pro/mcp/proof, sign in by OAuth or API key, paid per proof from a prepaid balance.

Hosted MCP Server

npx add-mcp 'https://sign-api.tvarka.pro/mcp/proof'

Installs into Claude Code, Codex, Cursor and more

Documentation

Tvarka Proof API

Version 1.30.0

A fact is fixed at a moment in time. A file is sealed with a qualified timestamp. A web page is captured as it looked. Every proof carries a code and a link that anyone can check.

Create your first proof

One POST to /v1/timestamps returns a sealed proof with a PDF certificate and a check link. The file can stay with you, because its fingerprint (hash) is enough. Each proof is paid from the balance.

BASE=https://sign-api.tvarka.pro
# TVARKA_KEY holds your API key.
HASH=$(openssl dgst -sha256 -binary contract.pdf | base64)
curl -sS "$BASE/v1/timestamps" \
  -H "Authorization: Bearer $TVARKA_KEY" -H 'Content-Type: application/json' \
  -d "{\"hash\": {\"algorithm\": \"sha256\", \"value\": \"$HASH\"}}"
curl -sS "$BASE/v1/timestamps" \
  -H "Authorization: Bearer $TVARKA_KEY" -H 'Content-Type: application/json' \
  -d '{"page": {"url": "https://example.com/offer"}, "title": "Offer page"}'

Web capture collections

POST /v1/capture-monitors: give page.url, everyHours (default 24), maxCaptures (default 30), and optionally endsAt. The first capture starts now. Pause or resume with PATCH /v1/capture-monitors/{monitorId} and status: paused or active. Queued work continues; missed intervals are skipped. Each completed capture has its normal price.

POST /v1/capture-bundles: give urls (1–20 distinct addresses), optional shared page settings and externalId for the matter. Read its state, then download /v1/capture-bundles/{bundleId}/file. The ZIP includes a qualified timestamped manifest, an exhibit index, certificates and archives. Failed URLs remain listed. Bundle assembly adds no fee.

Every capture reports page.quality, separate from job completion. Challenge pages, login forms, partial captures and missing artifacts are explicit. Quality findings are observations, not a guarantee of complete collection. Use monitorId or bundleId to filter GET /v1/timestamps. Corresponding MCP tools are listed under MCP server.

Timestamps and web page capture

POST /v1/timestamps takes exactly one of document, hash or page (v1.22.0). Each result has its own reference code and a public check page in verifyUrl.

  • document: one of content (base64, up to 15 MiB), fileToken from POST /v1/files, url (public HTTPS), markdown (rendered to an A4 PDF) or documentId (a vault document). A PDF comes back as the same PDF with a document timestamp (output: pdf). Any other file comes back in an ASiC-S container (output: asics). Answers 201.
  • hash: {"algorithm": "sha256", "value": "<base64>"} for a file you keep. The token comes back in token and as the file (output: token). Answers 201.
  • page: a public HTTPS address. The page is opened in a browser, captured as a full-page screenshot with its HTML, and sealed in a certificate PDF under one qualified timestamp. Answers 202 with status: pending. Poll GET /v1/timestamps/{timestampId} until completed or failed, or set webhookUrl for timestamp.completed and timestamp.failed.

The place of capture. page.location opens the page through a home internet connection in a chosen place (v1.24.0): country (ISO code, such as DE), and optionally a state or a city, and a zip. The exit address and its place are recorded in page.exit and in the certificate. When no exit in that country can be confirmed, the capture fails with location_unavailable and is not charged. page.locations compares 2 to 5 places in one certificate (v1.25.0). page.device (desktop or mobile), page.locale, page.consent: reject (the cookie test) and page.recheckAt (a recapture with what changed) are optional. secondTimestamp: true adds a second qualified timestamp from another authority. language sets the certificate language.

{"page": {"url": "https://example.com/offer", "location": {"country": "DE", "city": "Berlin"}},
 "title": "Offer page", "externalId": "case-118"}

Qualified or simple. Every timestamp is qualified by default. Send "qualified": false for a document or a hash to take a simple timestamp (v1.23.0). A web page capture is always qualified. GET /v1/timestamps lists the latest ones, filtered by source, monitorId or bundleId. GET /v1/timestamps/{timestampId}/file returns the PDF, the ASiC-S container or the token. MCP: timestamp_document, certify_webpage and get_timestamp.

Prices, one charge per completed timestamp, excluding VAT: qualified timestamp or web page capture EUR 0.19, simple timestamp EUR 0.13, a capture from a chosen place EUR 0.49 per place, the cookie test EUR 0.99. A failed capture is not charged. 503 timestamp-unavailable means no authority answered and nothing was charged. Retry it.