⚓️ Truth Anchor Agent

Truth Anchor Agent는 **인용 증명(citation attestation)**을 위한 MCP(Model Context Protocol) 서버입니다. 에이전트가 소스를 인용하기 전에, 해당 URL이 정상적으로 연결되는지 확인하고, 최종 목적지를 기록하며, 가벼운 페이지 메타데이터를 캡처하고, 가져온 콘텐츠의 해시값을 반환할 수 있습니다.

문제점: AI 에이전트는 사용 시점에 소스가 어떤 상태였는지 확인하지 않고, 죽었거나 리다이렉트되었거나 변경된 URL을 자주 인용합니다. 해결책: 에이전트가 인용을 신뢰하기 전에 소스의 가용성과 가벼운 증명 메타데이터를 기록하는 유료 검증 단계입니다.

보장하는 사항

• 검증 시점에 URL을 가져왔음을 보장합니다.

• 최종 URL, HTTP 상태, 리다이렉트 동작 및 기본적인 HTML 메타데이터를 보고합니다.

• 다운스트림 시스템이 관찰된 내용을 고정할 수 있도록 content_sha256 해시를 포함합니다.

• 선택적인 클레임 매칭은 간단한 부분 문자열 확인을 통해 이루어집니다.

Related MCP server: Predicate

보장하지 않는 사항

• 의미론적 팩트 체크 엔진이 아닙니다.

• 페이지가 신뢰할 수 있음을 증명하는 것이 아니라, 서비스가 가져왔을 때 관찰된 내용만을 증명합니다.

• 복잡한 주장에 대한 검색, RAG 또는 인간의 검토를 대체하지 않습니다.

🛠 Model Context Protocol (MCP) 통합

이 서버는 MCP 호환 LLM(Claude Desktop, ChatGPT, IDE 등)이 자율적으로 사용할 수 있는 verify_url 도구를 제공합니다.

Claude Desktop에 등록

claude_desktop_config.json에 다음을 추가하세요:

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

인터페이스

MCP 도구

MCP 도구는 2단계 흐름을 사용합니다:

1. URL과 함께 verify_url을 호출합니다.

2. 결제 증명이 제공되지 않으면 결제 지침을 받습니다.

3. 결제 후 tx_hash를 사용하여 재시도합니다.

HTTP API

HTTP API는 API 키와 x402 스타일의 서명된 결제를 사용합니다:

1. POST /auth/provision을 호출하여 무료 API 키를 받습니다.

2. 처음 50회 요청은 무료로 사용합니다.

3. 그 이후에는 POST /verify에 X-Payment를 첨부합니다.

💳 결제 흐름

HTTP API는 무료 티어가 소진된 후 유료 요청에 대해 402 Payment Required 흐름을 구현합니다.

1. 요청: 에이전트가 URL과 함께 /verify를 호출합니다.

2. 챌린지: 서버가 결제 지침과 함께 402 Payment Required를 반환합니다.

3. 결제: 에이전트가 Base USDC 결제 승인에 서명합니다.

4. 검증: 에이전트가 X-Payment 헤더와 함께 재시도합니다.

5. 증명: 서버가 결제를 확인하고 소스 확인 결과를 반환합니다.

⚡️ API 참조

POST /verify

소스가 정상적으로 연결되는지 확인하고 증명 메타데이터를 반환합니다. 다음이 필요합니다:

• Authorization: Bearer <api_key>

• 무료 티어 소진 후 X-Payment 필요

헤더:

요청 본문:

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

성공 응답 (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
}

🏗 기술 스택

• FastAPI — 고성능 Python API 프레임워크.

• Web3.py — 실시간 온체인 검증 (Base RPC).

• SQLite — 리플레이 공격 방지 및 트랜잭션 인덱싱.

• Fly.io — 글로벌 엣지 배포.

• Base — 빠르고 저렴한 USDC 결제를 위한 L2 이더리움.

포지셔닝 노트

• 주요 타겟: 에이전트를 위한 인용 증명

• 현재 제외된 사항: 광범위한 진실 계층, 일반적인 팩트 체크, 다중 도구 확장

• 제품 격차 및 검증 노트는 docs/product-positioning.md, docs/user-validation.md, docs/user-validation-proxy.md에 있습니다.

🛠 로컬 개발

# 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

📜 라이선스

MIT 라이선스에 따라 배포됩니다. 자세한 내용은 LICENSE를 참조하세요.