⚓️ Truth Anchor Agent

Truth Anchor Agent — это MCP-сервер (Model Context Protocol) для аттестации цитат. Прежде чем агент процитирует источник, он может проверить, разрешается ли URL-адрес, записать конечный пункт назначения, захватить легкие метаданные страницы и вернуть хеш содержимого того, что было получено.

Проблема: ИИ-агенты часто ссылаются на неработающие, перенаправленные или измененные URL-адреса, не проверяя, как выглядел источник на момент использования. Решение: Платный этап верификации, который записывает доступность источника и легкие метаданные аттестации до того, как агент начнет полагаться на цитату.

Что он гарантирует

• URL-адрес был получен во время верификации.

• Сервис сообщает конечный URL, HTTP-статус, поведение перенаправления и базовые HTML-метаданные.

• Ответ включает хеш content_sha256, чтобы последующие системы могли закрепить то, что было обнаружено.

• Опциональное сопоставление утверждений — это простая проверка подстроки.

Related MCP server: Predicate

Чего он не гарантирует

• Это не семантический движок для проверки фактов.

• Он не доказывает, что страница заслуживает доверия, а лишь фиксирует то, что сервис наблюдал при ее получении.

• Он не заменяет поиск, RAG или проверку человеком для сложных утверждений.

🛠 Интеграция с Model Context Protocol (MCP)

Этот сервер предоставляет инструмент verify_url, который любой LLM, совместимый с MCP (Claude Desktop, ChatGPT, IDE), может использовать автономно.

Регистрация в Claude Desktop

Добавьте это в ваш claude_desktop_config.json:

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

Интерфейсы

MCP-инструмент

MCP-инструмент использует двухэтапный процесс:

1. Вызов verify_url с URL-адресом.

2. Получение инструкций по оплате, если подтверждение оплаты не предоставлено.

3. Повторная попытка с tx_hash после отправки платежа.

HTTP API

HTTP API использует API-ключ плюс платежи с подписью в стиле x402:

1. POST /auth/provision для получения бесплатного API-ключа.

2. Используйте первые 50 запросов бесплатно.

3. После этого добавьте X-Payment к POST /verify.

💳 Платежный процесс

HTTP API реализует процесс 402 Payment Required для платных запросов после исчерпания бесплатного лимита.

1. Запрос: Агент вызывает /verify с URL-адресом.

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 — глобальное развертывание на границе сети (edge).

• Base — L2 Ethereum для быстрых и недорогих платежей в USDC.

Заметки о позиционировании

• Основной вектор: аттестация цитат для агентов

• Отклонено на данный момент: широкий слой истины, общая проверка фактов и расширение с помощью множества инструментов

• Пробелы в продукте и заметки о валидации находятся в 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 для получения дополнительной информации.