Divergence API and MCP

Multi-perspective news your agents can query.

The same event, scored across the political spectrum: editorial divergence, a confirmed-vs-disputed fact ledger, and market sentiment, all as structured data over a REST API and an MCP server.

Free key: 100 requests a day, no card. 5/day without a key.

Editorial disagreement, as a number.

Anyone can aggregate headlines. Divergence scores how far outlets diverge on the same event, then breaks the coverage into claims you can trust and claims that are contested. Nobody else ships that as a queryable feed.

Use it as agent context, as an alt-data signal, or as the backbone of a media-bias tool. The score and the ledger are computed every cycle and returned on every event.

Divergence How far the coverage splits 0–100
Confirmed Claims corroborated across outlets
Disputed Claims outlets contradict !

What you can build

Three things the data is good at, today, with the surface that already exists.

For AI agents

News context for agents MCP

Give an assistant grounded, multi-source context on any event through 13 MCP tools. Connect Claude Desktop, Cursor, or any MCP client.

get_digest · query_news · get_event
For fintech and quant

An alt-data signal

Treat coverage divergence and market sentiment as a feature. Filter events by market relevance, ticker, and sentiment for research and backtests.

/divergence/top · /sentiment/<cat>
For research and media

Media-bias tooling

Per-outlet framing labels, bias positions, and fact cross-checks across 45 outlets, ready to chart, report on, or embed in your own product.

/outlets · /events/<id>

From zero to first call

Hit the REST API with a key, or wire the MCP server into your client. Anonymous requests work too, capped at 5/day.

1 REST: one curl
curl https://divergence.news/api/v2/events?limit=3 \
  -H "X-API-Key: dv_api_your_key_here"

Generate a key on your account page after signing up.

2 MCP: drop in a config
{
  "mcpServers": {
    "divergence": {
      "type": "streamable-http",
      "url": "https://divergence.duckdns.org/mcp/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

MCP tokens are a Max plan feature. See the MCP docs for clients and tools.

The surface

Every tier gets every event-level endpoint and tool. Tiers differ only by daily cap and how far back you can look.

REST endpoints

Base /api/v2, JSON, key in X-API-Key.

/events/events/<id>/search/articles/outlets/stats/divergence/top/divergence/timeseries/sentiment/<cat>/categories/health

MCP tools

13 tools, two layers: analyzed events and raw articles.

get_digestquery_newssearch_newsget_eventget_top_divergentget_market_newsget_ticker_newsscan_portfolioget_market_sentiment_overviewget_trending_tickers

Pick a quota

Start on the free key. The only differences up the ladder are requests a day and lookback depth. Commercial use and redistribution start at Business.

Free
100
requests / day
7-day lookback · with a free key
Pro
500
requests / day
30-day lookback
Max
5,000
requests / day
Full archive · MCP access
Business
50,000
requests / day
Full archive · commercial license

Need bulk exports, higher volume, or custom terms? See all plans or reach out about Enterprise.

Build with the full picture.

A free key takes a minute and gives you 100 requests a day.