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 分

    請在儲存庫或註冊中心條目中宣告授權條款。