Skip to main content
Glama
truth-anchor-agent

truth-anchor-agent

by cristiano-c1

⚓️ Truth Anchor Agent

License: MIT Built on Base MCP x402

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:

Header

Beschreibung

Authorization

API-Schlüssel, der von POST /auth/provision zurückgegeben wurde

X-Payment

Signierte x402/EIP-3009 Zahlungs-Payload nach dem kostenlosen Kontingent

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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that provides autonomous, multi-source web research capabilities for AI agents. It delivers comprehensive, validated information through deep research tools while maintaining security and compatibility with various LLM providers.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for AI agent trust verification, enabling agents to verify identities, check trust scores, and build reputation across multiple blockchain and web platforms.
      12
      15 npm
      1
      MIT