⚓️ Truth Anchor Agent

Truth Anchor Agent ist ein MCP-Server (Model Context Protocol) für Zitationsattestierung. Bevor ein Agent eine Quelle zitiert, kann er verifizieren, dass die URL auflösbar ist, das endgültige Ziel aufzeichnen, leichtgewichtige Seitenmetadaten erfassen und einen Content-Hash des Abgerufenen zurückgeben.

Das Problem: KI-Agenten zitieren oft tote, weitergeleitete oder geänderte URLs, ohne zu prüfen, wie die Quelle zum Zeitpunkt der Nutzung aussah. Die Lösung: Ein kostenpflichtiger Verifizierungsschritt, der die Verfügbarkeit der Quelle und leichtgewichtige Attestierungsmetadaten aufzeichnet, bevor sich der Agent auf ein Zitat verlässt.

Was garantiert es?

• Die URL wurde zum Zeitpunkt der Verifizierung abgerufen.

• Der Dienst meldet die endgültige URL, den HTTP-Status, das Weiterleitungsverhalten und grundlegende HTML-Metadaten.

• Die Antwort enthält einen content_sha256-Hash, damit nachgelagerte Systeme verankern können, was beobachtet wurde.

• Optionales Claim-Matching ist eine einfache Teilstring-Prüfung.

Related MCP server: Predicate

Was garantiert es nicht?

• Es ist keine semantische Fact-Checking-Engine.

• Es beweist nicht, dass eine Seite vertrauenswürdig ist, sondern nur, was der Dienst beim Abruf beobachtet hat.

• Es ersetzt nicht die Suche, RAG oder menschliche Überprüfung bei komplexen Behauptungen.

🛠 Integration des Model Context Protocol (MCP)

Dieser Server stellt ein verify_url-Tool bereit, das jeder MCP-kompatible LLM (Claude Desktop, ChatGPT, IDEs) autonom nutzen kann.

Registrierung in Claude Desktop

Fügen Sie dies zu Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "truth-anchor": {
      "command": "npx",
      "args": ["-y", "truth-anchor-agent"],
      "env": {
        "MY_WALLET_ADDRESS": "0x367B9193D4F9cb4877Ca58E6F3ce944d761d8009"
      }
    }
  }
}

Schnittstellen

MCP-Tool

Das MCP-Tool verwendet einen zweistufigen Ablauf:

1. Rufen Sie verify_url mit einer URL auf.

2. Erhalten Sie Zahlungsanweisungen, falls kein Zahlungsnachweis bereitgestellt wurde.

3. Versuchen Sie es erneut mit tx_hash nach dem Senden der Zahlung.

HTTP-API

Die HTTP-API verwendet einen API-Schlüssel sowie signierte Zahlungen im x402-Stil:

1. POST /auth/provision, um einen kostenlosen API-Schlüssel zu erhalten.

2. Nutzen Sie die ersten 50 Anfragen kostenlos.

3. Fügen Sie danach X-Payment zu POST /verify hinzu.

💳 Der Zahlungsablauf

Die HTTP-API implementiert einen 402 Payment Required-Ablauf für kostenpflichtige Anfragen, nachdem das kostenlose Kontingent erschöpft ist.

1. Anfrage: Der Agent ruft /verify mit einer URL auf.

2. Herausforderung: Der Server gibt 402 Payment Required mit Zahlungsanweisungen zurück.

3. Zahlung: Der Agent signiert eine Base USDC-Zahlungsautorisierung.

4. Verifizierung: Der Agent wiederholt die Anfrage mit dem X-Payment-Header.

5. Attestierung: Der Server verifiziert die Zahlung und gibt die Quellenprüfung zurück.

⚡️ API-Referenz

POST /verify

Verifiziert, dass eine Quelle auflösbar ist, und gibt Attestierungsmetadaten zurück. Erfordert:

• Authorization: Bearer <api_key>

• X-Payment nach Erschöpfung des kostenlosen Kontingents

Header:

Anfrage-Body:

{
  "url": "https://base.org",
  "claim": "Base is an Ethereum L2"
}

Erfolgsantwort (200 OK):

{
  "url": "https://base.org",
  "final_url": "https://base.org/",
  "is_live": true,
  "status_code": 200,
  "redirected": false,
  "ssl_valid": true,
  "checked_at": "2026-04-02T12:00:00Z",
  "content_type": "text/html",
  "content_length_bytes": 31245,
  "title": "Base",
  "description": "Base is a secure, low-cost, builder-friendly Ethereum L2.",
  "content_sha256": "9d72c4...",
  "claim": "Base is an Ethereum L2",
  "claim_found": true,
  "claim_match_method": "substring",
  "paid": false,
  "free_requests_remaining": 49
}

🏗 Tech-Stack

• FastAPI — Hochleistungs-Python-API-Framework.

• Web3.py — On-Chain-Verifizierung in Echtzeit (Base RPC).

• SQLite — Schutz vor Replay-Angriffen und Transaktionsindizierung.

• Fly.io — Globales Edge-Deployment.

• Base — L2 Ethereum für schnelle, kostengünstige USDC-Zahlungen.

Positionierungshinweise

• Primärer Ansatz: Zitationsattestierung für Agenten

• Derzeit abgelehnt: breite Wahrheitsebene, allgemeines Fact-Checking und Multi-Tool-Erweiterung

• Produktlücken und Validierungshinweise finden sich in docs/product-positioning.md, docs/user-validation.md und docs/user-validation-proxy.md

🛠 Lokale Entwicklung

# 1. Clone and Install
git clone https://github.com/cristiano-c1/truth-anchor-agent
cd truth-anchor-agent
pip install -r requirements.txt

# 2. Configure
echo "MY_WALLET_ADDRESS=0x367B9193D4F9cb4877Ca58E6F3ce944d761d8009" > .env

# 3. Run
uvicorn main:app --reload

📜 Lizenz

Vertrieben unter der MIT-Lizenz. Siehe LICENSE für weitere Informationen.