Truth Bear

io.github.CHANGCHINFUPublished by GitHub account CHANGCHINFUv1.0.0Updated Nov 8, 2026

Verifiable official-source records for AI agents: record_hash + Ed25519 citation, x402 per-call

VerifiedStreamable HTTPWeb executableFinanceSecurity & MonitoringData & Analytics

Overview

AI-generated overview

Remote MCP server that gives an assistant verifiable official-source records, with hash and signed citations, and free coverage and citation checks.

What you can do
  • Check coverage and freshness of available signal lines before paying
  • Verify a record hash and get a plain-language reverse lookup of what it attests
  • Cross-verify one interwoven official line across its component series
  • Get the real x402 payment challenge for a paid record endpoint
  • List payment channels and their current status
When to use it
Useful when an assistant needs official public records (macro, energy, weather, health, sanctions, trade, SEC filings) with provenance it can check, or when you want to confirm a citation hash handed to you by another agent before relying on it.
Requirements
Remote streamable HTTP endpoint; no account or API key. Free tools work without payment. Paid records are settled by the caller over x402 in USDC on Base from a funded wallet, or via a subscription Bearer token.
Before you install
Paid records cost money per call in USDC from your own wallet; the server itself never takes payment, so settlement happens outside it. Records are a faithful relay of official sources, not advice or adjudication, and correctness of the source is not warranted. Free tools are read-only lookups.

Installation

In SourceWeft

  1. Open Truth Bear in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.CHANGCHINFU%2Ftruthbear-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "truth-bear": {
      "type": "http",
      "url": "https://api.truthbear.co/mcp"
    }
  }
}

README

Truth Bear — verifiable official-source data for AI agents (MCP)

Neutral, third-party access to official public records — US federal agencies, named registries and standards bodies — where every paid record ships an offline-recomputable record_hash and an Ed25519-signed citation. Pay per call in USDC via x402. No account, no API key.

Truth Bear restates official records faithfully; it does not adjudicate, advise, or endorse. The authoritative source is the official publisher named in every citation — verify and dispute there.


Add it (remote MCP server)

json
{  "mcpServers": {    "truthbear": { "url": "https://api.truthbear.co/mcp" }  }}

JSON-RPC 2.0 over HTTP POST (initialize / tools/list / tools/call). No key needed to list or verify; paid tools return a real x402 payment challenge you settle from your own wallet.

Tools

ToolCostWhat it does
find_signalFREECoverage + freshness: which signals exist, queryable before you pay
verify_citationFREECheck a record_hash, get the official reverse-lookup
purchase_optionsFREEHow to pay for a listed endpoint
verify_triangularFREECross-verify one interwoven official line
get_official_recordx402Returns a real payment challenge; pay, then receive the signed official record

What you pay for

Not the raw public number (free at its source) — the aggregation + official-source provenance + offline cryptographic verifiability, pre-joined into one schema.

Verify offline, against the primary source

Every paid record carries a record_hash (canonical sha256, independently recomputable) and an Ed25519 citation. SEC-filing settlement evidence also ships a durable_anchor (an immutable SEC accession + permanent document URL) that re-verifies at any time, not only at read time.

Coverage (90 industries)

Macro (FRED / US Treasury / BLS), energy (EIA), weather & disaster (NOAA / USGS / NWS / SPC / FEMA), health (openFDA / CDC), sanctions (OFAC / EU), trade (USITC), SEC EDGAR filings, and more.

Try it

bash
# free: what existscurl https://api.truthbear.co/manifest
# free: MCP tool listcurl "https://api.truthbear.co/manifest?platform=mcp"
# settlement evidence feed (x402, $0.01): did an issuer file a form before a cutoff?curl "https://api.truthbear.co/resolve/proposer?entity=AAPL&form=10-K&cutoff=2025-11-15"

Terms

Third-party relay of official records plus cross-source analysis. We warrant faithful relay (the hash recomputes against the cited official source), not the correctness of the source itself. Reference only — not advice, not adjudication, not a market resolution; the independent judgement and decision are the user's own. Full provider notice: https://api.truthbear.co/terms

Links

License

MIT (this listing/readme). The API itself is a hosted service governed by the Terms above.

Source: README.md at commit 31337e9

Tools

5

verify_citation

Verify a Truth Bear record (free)

FREE. Given a record_hash from any Truth Bear record, look it up and recompute the canonical hash server-side, returning whether it is a genuine Truth Bear official record plus a plain-language reverse lookup of what exactly that hash attests. Use this to check a citation you were handed by another agent or document BEFORE relying on it. No payment, no API key.

Parametersrecord_hashrequired

find_signal

Find which signals/entities are covered (free)

FREE coverage + freshness manifest: which signal_id lines exist, how many entities each covers, and fresh/recent/stale counts - so you can check "is my entity covered and how fresh" BEFORE paying. Optional filters: industry, signal_id, entity.

Parametersfullentityindustrysignal_id

get_official_record

Get the x402 payment challenge for a paid record

Returns the REAL x402 payment challenge (accepts[]: network / asset / payTo / amount) for the paid endpoint that serves a given signal_id+entity, or any listed endpoint addressed directly by `path`. This tool does NOT deliver paid data and does NOT take payment - MCP has no payment layer. Pay at the returned url with your own x402 client (USDC on Base or Solana, gasless EIP-3009; pay from a plain EOA) and you receive the record directly, with record_hash you can verify offline. This tool only fetches the 402 challenge; it delivers no paid data and collects no payment.

Parametersdimpathentitysignal_id

purchase_options

How can I actually buy this? (free)

FREE. Ask how to pay for a listed endpoint and get every channel with its REAL status - including the ones that are wired but not open yet. Three channels exist: x402 micropayment (for an agent with a funded USDC wallet on Base), a stateless subscription Bearer token (for a person or team - no wallet, no private key, no account), and a card rail. This tool takes no payment and holds no key; it only tells you which doors exist and which are open today.

Parameterspath

verify_triangular

Cross-check a line of official series & recompute the verdict (free)

FREE. Cross-verify one GAUGE interweave line: it returns each official series ("leg") in the line with its own record_hash, current/previous values, expected direction and per-leg minMove deadband, plus a count-style state (directions_matched / direction_mismatch / inverse_consistent / not_comparable / insufficient) and N-of-M. Everything needed to recompute the verdict OFFLINE is in the response - verify each leg hash with verify_citation, then recompute dir=sign(current-previous) with the minMove deadband. Descriptive only: no forecast, no causation, no advice. No payment, no API key.

Parameterslinerequiredentityrequired

Version history

1
  1. v1.0.0LatestNov 8, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts