⚓️ Truth Anchor Agent

Truth Anchor Agent es un servidor MCP (Model Context Protocol) para la atestación de citas. Antes de que un agente cite una fuente, puede verificar que la URL se resuelva, registrar el destino final, capturar metadatos ligeros de la página y devolver un hash del contenido de lo que se obtuvo.

El problema: Los agentes de IA a menudo citan URLs muertas, redirigidas o modificadas sin verificar cómo se veía la fuente en el momento de su uso. La solución: Un paso de verificación de pago que registra la disponibilidad de la fuente y metadatos de atestación ligeros antes de que el agente confíe en una cita.

Lo que garantiza

• La URL se obtuvo en el momento de la verificación.

• El servicio informa la URL final, el estado HTTP, el comportamiento de redirección y los metadatos HTML básicos.

• La respuesta incluye un hash content_sha256 para que los sistemas posteriores puedan anclar lo que se observó.

• La coincidencia de reclamaciones opcional es una simple comprobación de subcadena.

Related MCP server: Predicate

Lo que no garantiza

• No es un motor de verificación de hechos semánticos.

• No prueba que una página sea confiable, solo lo que el servicio observó cuando la obtuvo.

• No reemplaza la búsqueda, RAG o la revisión humana para reclamaciones complejas.

🛠 Integración del Protocolo de Contexto de Modelo (MCP)

Este servidor expone una herramienta verify_url que cualquier LLM compatible con MCP (Claude Desktop, ChatGPT, IDEs) puede usar de forma autónoma.

Registro en Claude Desktop

Añada esto a su claude_desktop_config.json:

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

Interfaces

Herramienta MCP

La herramienta MCP utiliza un flujo de dos pasos:

1. Llame a verify_url con una URL.

2. Reciba instrucciones de pago si no se proporciona una prueba de pago.

3. Vuelva a intentarlo con tx_hash después de enviar el pago.

API HTTP

La API HTTP utiliza una clave de API más pagos firmados al estilo x402:

1. POST /auth/provision para obtener una clave de API gratuita.

2. Utilice las primeras 50 solicitudes de forma gratuita.

3. Después de eso, adjunte X-Payment a POST /verify.

💳 El flujo de pago

La API HTTP implementa un flujo 402 Payment Required para solicitudes pagadas después de que se agota el nivel gratuito.

1. Solicitud: El agente llama a /verify con una URL.

2. Desafío: El servidor devuelve 402 Payment Required con instrucciones de pago.

3. Pago: El agente firma una autorización de pago en USDC de Base.

4. Verificación: El agente vuelve a intentarlo con el encabezado X-Payment.

5. Atestación: El servidor verifica el pago y devuelve la verificación de la fuente.

⚡️ Referencia de la API

POST /verify

Verifica que una fuente se resuelva y devuelve metadatos de atestación. Requiere:

• Authorization: Bearer <api_key>

• X-Payment después de que se agote el nivel gratuito

Encabezados:

Cuerpo de la solicitud:

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

Respuesta de éxito (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
}

🏗 Stack tecnológico

• FastAPI — Framework de API de Python de alto rendimiento.

• Web3.py — Verificación en cadena en tiempo real (Base RPC).

• SQLite — Prevención de ataques de repetición e indexación de transacciones.

• Fly.io — Despliegue global en el borde (edge).

• Base — L2 Ethereum para pagos rápidos y de bajo costo en USDC.

Notas de posicionamiento

• Cuña principal: atestación de citas para agentes

• Rechazado por ahora: capa de verdad amplia, verificación de hechos general y expansión de múltiples herramientas

• Las notas sobre brechas de producto y validación se encuentran en docs/product-positioning.md, docs/user-validation.md y docs/user-validation-proxy.md

🛠 Desarrollo local

# 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

📜 Licencia

Distribuido bajo la Licencia MIT. Consulte LICENSE para obtener más información.