# Truth Foundry - Verified News Intelligence API
> https://truthfoundry.ai

A signed, dated record of world events for humans and AI agents. 5,500+ curated
RSS feeds across 19 languages, frozen day by day. Rich structured fields per
article (entities, signals, events, facts), Ed25519 provenance throughout.

## Endpoints
- GET /v1/search?q={query}&since=7d&limit=20&kind= - Full-text search
- GET /v1/articles?topic=&category=&language=&since=24h&kind= - Browse
- GET /v1/articles/{id} - Article detail with all fields
- GET /v1/articles/{id}/provenance - Ed25519 receipt chain
- GET /v1/ask?q={question}&kind= - Retrieve-then-reason cited answer
- GET /v1/signals?ticker=TSLA&direction=DOWN - Momentum signals
- GET /v1/topics?since=24h - Trending topics
- GET /v1/entities?name=Jensen+Huang&type=person&kind= - Entity search
- GET /v1/events?since=7d&type=deadline&kind= - Event calendar
- GET /v1/facts?subject=Federal+Reserve - Fact search
- GET /health - Service health

## Content kinds (added 2026-06-12)
Every article carries a kind: news | blog | release_notes | spec | forum_social.
Filter with kind= (comma-separated multi-value, e.g. kind=news,blog; invalid
values are a 400). No kind param = all kinds. News surfaces (homepage, digests,
movers) default to news+blog; dev content (Reddit/HN threads, GitHub release
notes, EIP/RFC specs) is segmented behind kind=, not dropped. e.g.
kind=release_notes,spec,forum_social is the dev-radar slice.

## Machine-readable surfaces
- GET /openapi.json - OpenAPI 3.1 spec (live origin injected)
- POST /mcp - MCP JSON-RPC endpoint (Streamable HTTP, 12 tools)
- GET /mcp.json - ready-to-paste MCP client config
- GET /.well-known/mcp/server-card.json - MCP server card
- GET /.well-known/api-catalog - RFC 9727 catalog of these surfaces
- GET /llms.txt - this file

## MCP (Model Context Protocol)
Streamable HTTP MCP server at POST /mcp - 12 tools (search_news, list_articles,
get_article, get_article_provenance, get_signals, get_trending_topics,
search_entities, get_events, search_facts, get_digests, list_query_templates,
run_query).
Client config: GET /mcp.json

## Authentication
X-Newsboy-Key header or Authorization: Bearer. All /v1/* endpoints require a key.
The full record is free to read on the web (no key). Free keys: POST /billing/signup.
Paid plans at /pricing: Pro $29/mo (5,000 API requests/mo included) and Scale
$99/mo (50,000/mo). Keyless agents: 402 + x402 terms (see /auth.md). Usage: GET /v1/usage.

Truth Foundry is an open alpha: expect schema additions and visible sync lag on /health.