Tru8 Evidence Research

io.github.SamYatesSmith由 GitHub 账号 SamYatesSmith 发布v1.0.6更新于 Nov 3, 2026

面向AI智能体的可溯源证据研究。我们整理证据,由你决定。

AI 翻译由 AI 模型根据下方的原文描述翻译,可能有误。

原文描述

Source-traced evidence research for AI agents. We organise the evidence; you decide.

已验证Streamable HTTP可网页运行网页搜索与抓取知识与记忆

概览

Tru8 Evidence Research 的托管 MCP 服务(api.trueight.com);需要 API 密钥;Streamable HTTP;3 个工具。

暂无 AI 概览:以下信息来自注册中心条目和服务本身。

端点
api.trueight.com
最近检查

安装

在 SourceWeft 中

  1. 打开 控制台中的 Tru8 Evidence Research,将其添加到工作区。
  2. 连接 X-API-Key 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.SamYatesSmith%2Ftru8/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "tru8-evidence-research": {
      "type": "http",
      "url": "https://api.trueight.com/mcp/",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

Tru8 — AI-Powered Evidence Research Platform

Tru8 organises evidence so you can decide what matters. Submit a claim or URL, and Tru8 retrieves evidence from the open web and specialist APIs, classifies it by tier (primary / reporting / commentary) and type (data / official / news / analysis / opinion / academic), decomposes claims into elements, maps evidence to those elements, and presents the full landscape — structured, not summarised.

Mission: "We organise; you decide."

Quick Start

Prerequisites

  • Docker & Docker Compose
  • Python 3.11+
  • Node.js 20+

1. Start Infrastructure

bash
docker-compose up -d    # PostgreSQL 16, Redis 7, Qdrant

2. Backend

bash
cd backendpython -m venv venvsource venv/bin/activate    # Windows: venv\Scripts\activatepip install -r requirements.txtcp .env.example .env        # Edit with your API keysalembic upgrade headuvicorn app.main:app --reload    # http://localhost:8000

3. Frontend

bash
cd webnpm installnpm run dev    # http://localhost:3000

Project Structure

tru8/├── backend/              # FastAPI backend + evidence pipeline│   ├── app/│   │   ├── api/v1/       # REST endpoints (checks, agent, verify, payments)│   │   ├── core/         # Config, auth, pricing, manifest signing│   │   ├── models/       # SQLModel schemas (Check, Claim, Evidence, ClaimConsensus)│   │   ├── pipeline/     # Two-phase evidence pipeline│   │   ├── services/     # API adapters, search, payments, consensus│   │   └── utils/        # Classifiers, deduplication, query planning│   ├── alembic/          # Database migrations│   ├── tru8_mcp/         # MCP server package for AI agents│   └── tests/            # 990 unit + integration tests├── web/                  # Next.js 14 frontend│   ├── app/              # Pages (dashboard, developers, public reports)│   ├── components/       # Evidence views, claim map, marketing│   └── lib/              # API client, tiers, diagnostics├── shared/               # Shared TypeScript types├── docker-compose.yml    # PostgreSQL, Redis, Qdrant, MinIO (optional)└── .claude/CLAUDE.md     # Full engineering context

Pipeline

Two-phase pipeline with user claim selection gate (article mode):

Phase 1:  Ingest → Extract claims → Classify article → Rank claims          [PAUSE — user selects claims]
Phase 2:  Fact-check lookup → Decompose into elements → Retrieve evidence →          Score relevance → Classify tier/type → Map evidence to elements →          Derive orientation → Complete
Post:     Coverage recovery (Stage 5.1), video recommendations, auto-archiving

Evidence flows through web search plus specialist source adapters:

CategorySources
Web searchSerper.dev, Brave Search, SerpAPI (fallback chain)
Fact-checkGoogle Fact-Check API
GovernmentGOV.UK, Hansard, GovInfo, Companies House, ONS
LegalUK Legislation (legislation.gov.uk)
EconomicFRED, Marketaux, World Bank
AcademicSemantic Scholar, OpenAlex, PubMed
ClimateNOAA, WeatherAPI, Open-Meteo, GBIF
ArchivesWikipedia (+ reference mining), Library of Congress, Internet Archive
HealthWHO
SportsTransfermarkt, Football-Data.org
VideoYouTube Data API

Six Evidence Views

ViewQuestion it answers
CartographerWhat's the shape of this conversation?
LibrarianIs this the full set, clearly labelled?
InterpreterDoes this evidence answer this sub-question?
ProjectionistWhat's been said on camera?
ChronologistWhen did the evidence appear?
SeekerWhat don't we know yet?

API & Agent Access

Tru8 exposes a developer API and MCP server for AI agents.

Agent Commerce Gateway

bash
# Quick check (~15s, heuristic classification)curl -X POST https://api.trueight.com/api/v1/agent/quick \  -H "X-API-Key: $TRU8_API_KEY" \  -d '{"claim": "UK inflation is 3.2%"}'
# Smart endpoint with tier fallback (lookup → consensus → quick → full)curl -X POST https://api.trueight.com/api/v1/agent/check \  -H "X-API-Key: $TRU8_API_KEY" \  -d '{"claim": "UK inflation is 3.2%", "max_tier": "full"}'
TierCostTimeWhat you get
Lookup~£0.02instantCached prior analysis
Consensus~£0.03instantCross-user aggregate landscape (k>=3 checks)
Quick~£0.07~15sWeb search + heuristic classification
Full~£0.15~60-90sweb + specialist APIs, LLM classification, element decomposition

Three payment rails: x402 (USDC/SIWE), Skyfire (JWT), prepaid credits.

MCP Server

json
{  "mcpServers": {    "tru8": {      "command": "python",      "args": ["-m", "tru8_mcp"],      "env": { "TRU8_API_KEY": "tru8_sk_..." }    }  }}

Tools: tru8_check (evidence research with tier fallback), tru8_get_result (with analytics), tru8_get_result_raw.

Manifest Verification

Every completed check receives an HMAC-SHA256 signed manifest. Verify the signed fields haven't changed since signing:

bash
curl https://api.trueight.com/verify/{check_id}

Testing

bash
cd backendpytest tests/ -v                        # Full suite (990 tests)pytest tests/unit/pipeline/ -v          # Pipeline unit testspytest tests/unit/agent/ -v             # Agent/commerce testspytest tests/integration/ -v            # Integration tests

Infrastructure

ServicePortPurpose
PostgreSQL 165433Primary database (SQLModel)
Redis 76379Cache + rate limiting
Qdrant6333Vector similarity search
MinIO (optional)9000Local S3 for file uploads

Auth: Clerk (JWT + JWKS) for dashboard, API keys for developer access. Payments: Stripe (4 subscription tiers) + Agent per-use payments.

API Documentation

Environment Variables

Copy backend/.env.example to backend/.env. Key groups:

GroupRequiredVariables
DatabaseYesDATABASE_URL
RedisYesREDIS_URL
AuthYesCLERK_SECRET_KEY, CLERK_JWT_ISSUER
LLMYesGOOGLE_AI_API_KEY, OPENAI_API_KEY
SearchYes (at least one)SERPER_API_KEY, BRAVE_API_KEY, SERP_API_KEY
PaymentsFor subscriptionsSTRIPE_SECRET_KEY, STRIPE_WEBHOOK_SECRET
Government APIsOptionalFRED_API_KEY, NOAA_API_KEY, etc.
Manifest signingOptionalMANIFEST_SIGNING_ENABLED, MANIFEST_SIGNING_KEY

Feature flags (all default to sensible values): ENABLE_API_RETRIEVAL, ENABLE_LLM_RELEVANCE_SCORER, ENABLE_QUERY_PLANNING, etc. See backend/.env.example for the full list.

Licence

Private — All rights reserved.

来源:README.md,提交 dd557f4

工具

3

tru8_check

Evidence research

Evidence research for a factual claim or article URL. Submit a claim as text or paste an article URL. URLs are auto-detected and trigger article mode: the pipeline extracts claims from the page and auto-selects up to 5 for evidence research. Tiers (in fallback order): - lookup (~£0.02, instant) — cached prior analysis - consensus (~£0.03, instant) — cross-user aggregate landscape (k≥3 checks) - quick (~£0.07, ~15s) — web search + heuristic classification - full (~£0.15, ~60-90s) — web + specialist APIs, LLM classification, coverage recovery Charges based on tier actually executed, not tier requested. Identical calls within ten minutes return the same check, so a transport retry never runs — or charges — twice. Set max_tier to control maximum spend per call. Output structure: - claims[].claimMap.elements[] — verifiable sub-claims with state (supported/disputed/unresolved) - claims[].claimMap.elements[].evidenceRefs[] — evidence mapped to elements with relationship (supports/challenges/context) and reasoning - claims[].evidence[] — sources classified by tier (primary/reporting/ commentary) and type (data/official/news/analysis/opinion/academic) - claims[].claimMap.orientation — mechanical summary from element states - _meta — execution metadata: executedTier, chargedPence, limitations A run that has not finished after several minutes returns {checkId, status, chargedPence, message} instead of the result: fetch it later with tru8_get_result (free). A run that FAILS raises an error and is not charged. Per-argument guidance lives on the parameters themselves (see the Annotated/Field declarations above), which is where a client can actually read it — a docstring "Args:" block never reaches the tool's inputSchema.

输入参数claim必填compactmax_tiermax_age_hours

tru8_get_result

Get result (with analytics)

Retrieve a previously submitted check with pre-computed analytics. Returns the full result including a _computed block with tier/type distributions, corroboration groups, diagnostic values, timeline analysis, element state summaries, and per-claim dispositions. Use this over tru8_get_result_raw when you want structured analytics ready for summarisation or comparison without post-processing.

输入参数check_id必填

tru8_get_result_raw

Get result (raw)

Retrieve a previously submitted check without computed analytics. Returns claims, elements, evidence, and claim maps only. No _computed block. Smaller response payload. Use this when you will compute your own aggregations or only need specific fields from the raw data.

输入参数check_id必填

版本历史

2
  1. v1.0.6最新Nov 3, 2026
  2. v1.0.4Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。