# Verified Reality for AI Agents | Machine-Readable Ground-Truth API

> A machine-readable API and hosted MCP endpoint for AI agents that need to re-check a file's integrity, search published Exchange listings, or commission a human field verification. Bearer-key endpoints plus keyless public hash checks.

## Key facts
- Three jobs for an agent: re-check a sealed file's hash with no API key, search published Exchange listings with a bearer key, or quote and submit a field-verification bounty for review with a bearer key.
- A hash match confirms this file's bytes still match the sealed packet. It does not confirm the depicted scene was honest, complete, or admissible — a human reviewer makes that call.
- The same tools are available as plain REST (/api/v1/openapi.json) and as a hosted Model Context Protocol endpoint at /mcp (Streamable HTTP). Auth is Bearer API key only — Command Centre session cookies are never used.
- A submitted bounty is queued for HQ review before any human Verifier is contacted — it is not auto-dispatched. Active Verifier coverage today is southwestern Ontario; other cities are travel-dependent or registration-ready, not guaranteed on demand.
- API keys are issued by a signed-in human from the client portal and stored hashed server-side with granular scopes. An autonomous agent cannot self-provision a key today.
- An empty catalog search result means nothing opted-in and HQ-approved currently matches the query — not that the location was checked and found clean.

## Summary
Agents that make decisions for a human increasingly need an independent check on a physical-world claim, not another scraped source. The headless v1 API and the hosted /mcp endpoint expose that check as a plain REST or MCP contract: search the Exchange catalog, generate a licensing quote, quote and submit a field-verification bounty for review, or re-check a sealed file's hash.

Start with the public, keyless hash-check endpoints under /api/public/ (or the verify_media_hash MCP tool) to re-verify a packet an agent already holds a reference for. Move to the bearer-key tools once a human operator has generated an API key from the client portal.

/llms.txt lists this page, the OpenAPI document, and /mcp under Tools for agents, ahead of the general page index, for crawlers and model context tools that read that file first. /llms-full.txt mirrors the full corpus for ingestion.

## Keywords
- AI agent API
- agent-to-agent API
- machine-readable API
- OpenAPI specification
- MCP endpoint
- Model Context Protocol
- LLM tool for ground truth
- verify media hash API
- Truth Packet API
- field verification bounty API
- Agent Card
- bearer API key

Canonical URL: https://verifiedreality.ca/agents