Tru8 Evidence Research

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Remote HTTP

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "tru8-evidence-research": {
      "url": "https://api.trueight.com/api/v1/agent/quick"
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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 backend
python -m venv venv
source venv/bin/activate    # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env        # Edit with your API keys
alembic upgrade head
uvicorn app.main:app --reload    # http://localhost:8000

3. Frontend

bash

cd web
npm install
npm run dev    # http://localhost:3000

Project Structure

Code

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):

Code

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:

Category	Sources
Web search	Serper.dev, Brave Search, SerpAPI (fallback chain)
Fact-check	Google Fact-Check API
Government	GOV.UK, Hansard, GovInfo, Companies House, ONS
Legal	UK Legislation (legislation.gov.uk)
Economic	FRED, Marketaux, World Bank
Academic	Semantic Scholar, OpenAlex, PubMed
Climate	NOAA, WeatherAPI, Open-Meteo, GBIF
Archives	Wikipedia (+ reference mining), Library of Congress, Internet Archive
Health	WHO
Sports	Transfermarkt, Football-Data.org
Video	YouTube Data API

Six Evidence Views

View	Question it answers
Cartographer	What's the shape of this conversation?
Librarian	Is this the full set, clearly labelled?
Interpreter	Does this evidence answer this sub-question?
Projectionist	What's been said on camera?
Chronologist	When did the evidence appear?
Seeker	What 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"}'

Tier	Cost	Time	What you get
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, element decomposition

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

MCP Server

config.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:

Terminal

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

Testing

bash

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

Infrastructure

Service	Port	Purpose
PostgreSQL 16	5433	Primary database (SQLModel)
Redis 7	6379	Cache + rate limiting
Qdrant	6333	Vector similarity search
MinIO (optional)	9000	Local 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

Swagger UI: http://localhost:8000/api/docs
ReDoc: http://localhost:8000/api/redoc
Health: http://localhost:8000/api/v1/health/

Environment Variables

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

Group	Required	Variables
Database	Yes	`DATABASE_URL`
Redis	Yes	`REDIS_URL`
Auth	Yes	`CLERK_SECRET_KEY`, `CLERK_JWT_ISSUER`
LLM	Yes	`GOOGLE_AI_API_KEY`, `OPENAI_API_KEY`
Search	Yes (at least one)	`SERPER_API_KEY`, `BRAVE_API_KEY`, `SERP_API_KEY`
Payments	For subscriptions	`STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`
Government APIs	Optional	`FRED_API_KEY`, `NOAA_API_KEY`, etc.
Manifest signing	Optional	`MANIFEST_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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit

2d ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Tru8 Evidence Research

Tru8 Evidence Research is a hosted MCP server. Add it as a remote server in your client's config: "mcpServers": { "tru8-evidence-research": { "url": "https://api.trueight.com/api/v1/agent/quick" } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Tru8 Evidence Research AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/tru8-evidence-research?style=directory)](https://allmcps.com/mcp/tru8-evidence-research)

HTML Embed

<a href="https://allmcps.com/mcp/tru8-evidence-research"><img src="https://allmcps.com/api/badge/tru8-evidence-research?style=directory" alt="Tru8 Evidence Research on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

10/14 checks healthy over the last 45d

40Quality signal: Fair · 40/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to Tru8 Evidence Research →Install in Claude Desktop Install in Cursor Install in VS Code Setup guides for all 13 MCP clients

Tru8 Evidence Research

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

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Remote HTTP

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "tru8-evidence-research": {
      "url": "https://api.trueight.com/api/v1/agent/quick"
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

Tru8 — AI-Powered Evidence Research Platform

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 backend
python -m venv venv
source venv/bin/activate    # Windows: venv\Scripts\activate
pip install -r requirements.txt
cp .env.example .env        # Edit with your API keys
alembic upgrade head
uvicorn app.main:app --reload    # http://localhost:8000

3. Frontend

bash

cd web
npm install
npm run dev    # http://localhost:3000

Project Structure

Code

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):

Code

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:

Category	Sources
Web search	Serper.dev, Brave Search, SerpAPI (fallback chain)
Fact-check	Google Fact-Check API
Government	GOV.UK, Hansard, GovInfo, Companies House, ONS
Legal	UK Legislation (legislation.gov.uk)
Economic	FRED, Marketaux, World Bank
Academic	Semantic Scholar, OpenAlex, PubMed
Climate	NOAA, WeatherAPI, Open-Meteo, GBIF
Archives	Wikipedia (+ reference mining), Library of Congress, Internet Archive
Health	WHO
Sports	Transfermarkt, Football-Data.org
Video	YouTube Data API

Six Evidence Views

View	Question it answers
Cartographer	What's the shape of this conversation?
Librarian	Is this the full set, clearly labelled?
Interpreter	Does this evidence answer this sub-question?
Projectionist	What's been said on camera?
Chronologist	When did the evidence appear?
Seeker	What 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"}'

Tier	Cost	Time	What you get
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, element decomposition

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

MCP Server

config.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:

Terminal

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

Testing

bash

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

Infrastructure

Service	Port	Purpose
PostgreSQL 16	5433	Primary database (SQLModel)
Redis 7	6379	Cache + rate limiting
Qdrant	6333	Vector similarity search
MinIO (optional)	9000	Local 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

Swagger UI: http://localhost:8000/api/docs
ReDoc: http://localhost:8000/api/redoc
Health: http://localhost:8000/api/v1/health/

Environment Variables

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

Group	Required	Variables
Database	Yes	`DATABASE_URL`
Redis	Yes	`REDIS_URL`
Auth	Yes	`CLERK_SECRET_KEY`, `CLERK_JWT_ISSUER`
LLM	Yes	`GOOGLE_AI_API_KEY`, `OPENAI_API_KEY`
Search	Yes (at least one)	`SERPER_API_KEY`, `BRAVE_API_KEY`, `SERP_API_KEY`
Payments	For subscriptions	`STRIPE_SECRET_KEY`, `STRIPE_WEBHOOK_SECRET`
Government APIs	Optional	`FRED_API_KEY`, `NOAA_API_KEY`, etc.
Manifest signing	Optional	`MANIFEST_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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit

2d ago

Most recent push to the default branch.

Directory activity

1 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Tru8 Evidence Research

Tru8 Evidence Research is a hosted MCP server. Add it as a remote server in your client's config: "mcpServers": { "tru8-evidence-research": { "url": "https://api.trueight.com/api/v1/agent/quick" } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/tru8-evidence-research?style=directory)](https://allmcps.com/mcp/tru8-evidence-research)

HTML Embed

<a href="https://allmcps.com/mcp/tru8-evidence-research"><img src="https://allmcps.com/api/badge/tru8-evidence-research?style=directory" alt="Tru8 Evidence Research on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

10/14 checks healthy over the last 45d

40Quality signal: Fair · 40/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools16/30

Adoption & activity4/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.