The evidence landscape behind any claim. One API call.

Three Steps

# Store your key as an environment variable — never hardcode it
export TRU8_API_KEY="tru8_sk_..."

curl -X POST https://api.trueight.com/api/v1/agent/quick \
  -H "X-API-Key: $TRU8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"claim": "Global average temperature rose 1.1°C since pre-industrial times"}'

curl https://api.trueight.com/api/v1/agent/result/{check_id} \
  -H "X-API-Key: $TRU8_API_KEY"

Four depths. One record shape.

Agent API calls are charged per call, deducted from your prepaid credit balance. Every tier returns the same record shape — the price buys retrieval depth, not a different contract.

MCP Server

Tru8 exposes three tools via the Model Context Protocol. Any MCP-compatible agent (Claude, GPT, Gemini) can discover and use Tru8 automatically.

{
  "mcpServers": {
    "tru8": {
      "command": "python",
      "args": ["-m", "tru8_mcp"],
      "env": {
        "TRU8_API_KEY": "tru8_sk_..."
      }
    }
  }
}

Non-Blocking Submission

# Submit async
curl -X POST "https://api.trueight.com/api/v1/agent/full?async=true" \
  -H "X-API-Key: $TRU8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"claim": "The UK left the EU in 2020"}'

# Response: 202 Accepted
{
  "checkId": "abc-123",
  "status": "processing",
  "tier": "full",
  "chargedPence": 15,
  "pollUrl": "/api/v1/agent/result/abc-123",
  "estimatedSeconds": 60
}

# Poll for result
curl "https://api.trueight.com/api/v1/agent/result/abc-123" \
  -H "X-API-Key: $TRU8_API_KEY"
# While processing: { "status": "processing", "checkId": "abc-123", "hit": false }
# When complete:   { full result payload }

Multi-Claim Submission

curl -X POST https://api.trueight.com/api/v1/agent/batch \
  -H "X-API-Key: $TRU8_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "quick",
    "claims": [
      { "claim": "Global sea levels rose 3.6mm per year since 2006" },
      { "claim": "The Amazon rainforest produces 20% of world oxygen" },
      { "claim": "Electric vehicles have lower lifetime emissions than petrol cars" }
    ]
  }'

# Response: 202 Accepted
{
  "accepted": 3,
  "tier": "quick",
  "totalChargedPence": 21,
  "estimatedSeconds": 15,
  "checks": [
    { "index": 0, "checkId": "...", "pollUrl": "/api/v1/agent/result/..." },
    { "index": 1, "checkId": "...", "pollUrl": "/api/v1/agent/result/..." },
    { "index": 2, "checkId": "...", "pollUrl": "/api/v1/agent/result/..." }
  ]
}

Event Notifications

{ "checkId": "...", "status": "completed", "tier": "quick" }

{ "checkId": "...", "status": "failed", "error": "Pipeline timed out" }

Self-Service Endpoints

Throttling

Error Codes

What You Get Back

{
  "id": "check-uuid",
  "status": "completed",
  "claims": [
    {
      "text": "Global average temperature rose 1.1°C since pre-industrial times",
      "claimType": "statistical",
      "claimMap": {
        "elements": [
          {
            "elementId": "e1",
            "text": "Global average temperature increase",
            "state": "supported",
            "evidenceRefs": [
              {
                "evidenceId": "ev1",
                "relationship": "supports",
                "reasoning": "NASA GISS dataset confirms 1.1°C anomaly..."
              }
            ]
          }
        ],
        "orientation": "Evidence broadly supports this claim..."
      },
      "evidence": [
        {
          "evidenceId": "ev1",
          "title": "GISS Surface Temperature Analysis",
          "url": "https://data.giss.nasa.gov/gistemp/",
          "tier": "primary",
          "evidenceType": "data",
          "snippet": "Global mean surface temperature anomaly..."
        }
      ]
    }
  ],
  "_meta": {
    "executedTier": "quick",
    "chargedPence": 7,
    "limitations": ["heuristic_classification", "no_coverage_recovery"],
    "cached": false,
    "landscape": {
      "sourceDiversity": { "uniqueDomains": 5, "typeCoverage": 3 },
      "freshness": { "freshestDaysAgo": 2, "undatedCount": 1 },
      "gaps": [],
      "providerStatus": null
    }
  },
  "_manifest": {
    "checkId": "check-uuid",
    "landscapeHash": "a1b2c3d4...",
    "signedAt": "2026-03-09T12:00:00Z",
    "signature": "hmac-sha256:...",
    "kid": "tru8-2026-03",
    "verifyUrl": "/verify/check-uuid"
  },
  "_computed": {
    "summary": { "totalElements": 3, "supported": 2, "disputed": 0, "unresolved": 1 },
    "evidenceByTier": { "primary": 4, "reporting": 8, "commentary": 2 },
    "evidenceByType": { "data": 3, "official": 2, "news": 5, "analysis": 3, "academic": 1 },
    "corroboration": { "groups": [...], "convergenceCount": 3 },
    "diagnosticValues": [...]
  }
}

Documentation

Frequently asked questions

How do I get started with the Tru8 API?

Create an API key in your dashboard settings, then POST a claim or URL to the API. The Quick Start above shows a working request; a single call returns a structured evidence landscape.

What does a Tru8 API call return?

A structured evidence landscape: each claim is decomposed into 1–5 elements, evidence is mapped to those elements with supports, challenges or context relationships, every source is classified by tier and type, gaps are named, and the response carries an HMAC-signed manifest. It does not return a true/false verdict. We organise; you decide.

Is there an MCP server for Claude and other AI agents?

Yes. The tru8-mcp package is published on PyPI and exposes tools for submitting a check and retrieving results, so Claude and other agents can request an evidence landscape directly.

How are API calls priced?

Calls are metered per request across four tiers — lookup, consensus, quick and full — billed from prepaid credits. See the Tiers & Pricing section above for the current per-tier rates.

How can an agent confirm a result has not changed?

Every response includes a signed _manifest. A caller can verify the signed fields have not changed since signing by calling GET /verify/{check_id}.

How long does a check take?

Typically 15–90 seconds depending on the tier, because Tru8 retrieves and classifies evidence across 30+ sources rather than returning passages and a score.