tru8-mcp

MCP server for Tru8 Evidence Research — structured evidence research tools for AI agents.

Submit a claim or URL, get back source-traced evidence organized by tier (primary/reporting/commentary) and type (data/official/news/analysis/opinion/academic), with element decomposition and relationship mapping.

Two ways to connect

Hosted (nothing to install). Point any MCP client that supports remote servers at:

https://api.trueight.com/mcp/

Authenticate with your Tru8 API key, sent either as an X-API-Key header or as Authorization: Bearer. Each request is authenticated on its own, so one endpoint serves every user without their keys ever meeting.

Local (this package). Runs on your own machine over stdio, which means your API key never leaves it. Use this if you would rather not send a credential through anyone else's infrastructure.

Both serve the identical tools from the identical code — pick whichever suits.

Quick Start

pip install tru8-mcp

Or run without installing:

uvx tru8-mcp

Set your API key:

export TRU8_API_KEY=tru8_sk_...

Create an API key at your Tru8 dashboard under Settings > Developer.

Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "tru8": {
      "command": "tru8-mcp",
      "env": {
        "TRU8_API_KEY": "tru8_sk_..."
      }
    }
  }
}

Cline / Cursor

Add to your MCP settings:

{
  "mcpServers": {
    "tru8": {
      "command": "uvx",
      "args": ["tru8-mcp"],
      "env": {
        "TRU8_API_KEY": "tru8_sk_..."
      }
    }
  }
}

From source

git clone https://github.com/SamYatesSmith/tru8-mcp.git
cd tru8-mcp
pip install -e .
tru8-mcp

Tools

A check that is still running after several minutes returns its checkId and status instead of the result. Fetch it later with tru8_get_result (free). Calling tru8_check again with the same claim within ten minutes returns the same check and is not charged twice.

Environment Variables

Security

Store API keys in environment variables or a secrets manager. Never hardcode keys in source code. If a key is compromised, revoke it immediately at your dashboard.