AI-tagged financial news, sentiment, and trending themes — over a standard REST API and a Model Context Protocol server for Claude Desktop, Cursor, and other agentic clients. Free for hobby use, Pro for production.
np_live_… value once — it's never shown again.curl https://newsprobe.io/api/v1/me \ -H "Authorization: Bearer np_live_…"
All requests require Authorization: Bearer <key>. Keys are tied to your account; rate limits are per key. Revoking a key (in the dashboard) is immediate — no caching window.
For the MCP endpoint only, you may also pass ?key=np_live_… as a query string — Claude Desktop's connector UI doesn't yet let users set Bearer headers. URL-passed keys can leak in HTTP server logs; prefer the mcp-remote bridge so headers stay out of URLs, and rotate the key if it leaks.
Two windows enforced simultaneously: a per-minute burst guard and a per-day cap. Exceeding either returns 429 with a Retry-After header.
| Tier | Per minute | Per day | Pro endpoints |
|---|---|---|---|
| Free | 10 | 50 | No (403) |
| Pro | 60 | 10,000 | Full access |
/api/v1/me is free of quota — call it as often as you need to check usage.
/api/v1/meFreeReturns the authenticated user's plan and current quota usage. Does not consume quota itself.
Request
curl https://newsprobe.io/api/v1/me \ -H "Authorization: Bearer np_live_…"
Response
{
"ok": true,
"userId": "…",
"plan": "free",
"usage": {
"minuteCount": 2,
"minuteLimit": 10,
"dayCount": 14,
"dayLimit": 50
}
}/api/v1/news/searchFreeRecent AI-tagged news for a ticker, ordered by publishedAt desc. Includes per-article sentiment score, AI summary, and catalyst (event) type. Optional ?catalyst= filters to one event type (earnings, m_and_a, fda, guidance, analyst_rating, legal, regulatory, partnership, product, macro, other).
Request
curl "https://newsprobe.io/api/v1/news/search?ticker=AAPL&catalyst=earnings&limit=5" \ -H "Authorization: Bearer np_live_…"
Response
{
"ok": true,
"ticker": "AAPL",
"since": "2026-04-17T…",
"catalyst": "earnings",
"items": [
{ "id": "…", "title": "…", "source": "…", "url": "…",
"summary": "…", "sentimentScore": 0.62, "catalystType": "earnings",
"publishedAt": "…", "relevance": 0.9 }
]
}/api/v1/news/:idFreeFetch a single article by UUID, including catalyst type and all tagged tickers.
Request
curl https://newsprobe.io/api/v1/news/123e4567-… \ -H "Authorization: Bearer np_live_…"
Response
{ "ok": true, "item": { "id": "…", "title": "…", "catalystType": "m_and_a", "tickers": ["AAPL","MSFT"], … } }/api/v1/tickers/searchFreeAutocomplete — resolve "tesla" → TSLA. Returns up to 20 candidate symbols with name + sector.
Request
curl "https://newsprobe.io/api/v1/tickers/search?q=tesla&limit=5" \ -H "Authorization: Bearer np_live_…"
Response
{ "ok": true, "items": [ { "symbol": "TSLA", "name": "Tesla, Inc.", "sector": "Consumer Cyclical" } ] }/api/v1/tickers/:symbolFreeMetadata for a ticker — name, sector, exchange.
Request
curl https://newsprobe.io/api/v1/tickers/AAPL \ -H "Authorization: Bearer np_live_…"
Response
{ "ok": true, "ticker": { "symbol": "AAPL", "name": "Apple Inc.", "sector": "Technology", "exchange": "NASDAQ" } }/api/v1/tickers/:symbol/relatedProTickers that have appeared in the same news as this symbol over the last 90 days (with a same-sector bonus). Descriptive of past co-mention only — not price correlation, not a basket to trade.
Request
curl "https://newsprobe.io/api/v1/tickers/NVDA/related?limit=8" \ -H "Authorization: Bearer np_live_…"
Response
{ "ok": true, "symbol": "NVDA", "items": [ { "symbol": "AMD", "name": "…", "sector": "Technology", "score": 12.5, "coMentionCount": 12, "sharedThemeCount": 0, "sameSector": true } ] }/api/v1/trending/buzzFreeTickers whose news velocity is surging vs. the 30-day baseline.
Request
curl "https://newsprobe.io/api/v1/trending/buzz?limit=10" \ -H "Authorization: Bearer np_live_…"
Response
{ "ok": true, "items": [ { "symbol": "…", "count7d": 23, "surgeMultiple": 4.1, "avgSentiment": 0.4 } ] }/api/v1/trending/swingsProTickers with the largest 7-day shifts in news sentiment (in either direction).
Request
curl https://newsprobe.io/api/v1/trending/swings \ -H "Authorization: Bearer np_live_…"
Response
{ "ok": true, "items": [ … ] }/api/v1/trending/themesProNarrative themes (clusters of related stories) gaining momentum.
Request
curl https://newsprobe.io/api/v1/trending/themes \ -H "Authorization: Bearer np_live_…"
Response
{ "ok": true, "items": [ { "slug": "ai-chips", "title": "AI Chips", "count7d": 41, "surgeMultiple": 2.6 } ] }/api/v1/trending/velocityProTickers ranked by the rate of change of their AI sentiment (velocity) and the change in that rate (acceleration) over the last 7 days. Descriptive of the sentiment series itself, measured after the fact.
Request
curl https://newsprobe.io/api/v1/trending/velocity \ -H "Authorization: Bearer np_live_…"
Response
{ "ok": true, "items": [ { "symbol": "NVDA", "velocity": 0.012, "acceleration": 0.004, "latestSentiment": 0.55, "count": 31 } ] }/api/v1/watchlistProThe authenticated user's watchlist tickers.
Request
curl https://newsprobe.io/api/v1/watchlist \ -H "Authorization: Bearer np_live_…"
Response
{ "ok": true, "items": [ { "ticker": "AAPL", "name": "Apple Inc.", "sector": "Technology", "addedAt": "…" } ] }NewsProbe ships a Model Context Protocol server at https://newsprobe.io/api/mcp using Streamable HTTP transport. Same key, same quota, same Pro gating as the REST surface.
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on your platform. Use the mcp-remote bridge so the Bearer header is set without leaking the key in the URL:
{
"mcpServers": {
"newsprobe": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://newsprobe.io/api/mcp",
"--header",
"Authorization: Bearer np_live_…"
]
}
}
}Restart Claude Desktop. You should see newsprobe in the Connectors list with these tools:
search_newsRecent news for a ticker (optional catalyst filter)get_newsFetch one article by UUIDget_tickerTicker metadatasearch_tickersResolve names → symbolsget_trending_buzzNews-velocity surge listget_trending_swingsLargest 7d sentiment swingsProget_trending_themesTheme momentum (cluster surge)Proget_trending_velocitySentiment velocity & accelerationProget_related_tickersNames often mentioned togetherProget_watchlistYour watchlist tickersProcurl -X POST https://newsprobe.io/api/mcp \
-H "Authorization: Bearer np_live_…" \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'| Status | Body | Meaning |
|---|---|---|
| 401 | {"error":"missing_api_key"} | No Bearer header. |
| 401 | {"error":"invalid_api_key"} | Hash mismatch or unknown prefix. |
| 401 | {"error":"revoked_api_key"} | Key was revoked. Generate a new one. |
| 403 | {"error":"pro_required","upgradeUrl":"/pricing?from=api"} | Endpoint requires Pro. |
| 429 | {"error":"rate_limit_minute","scope":"minute","retryAfter":34} | Per-minute burst exceeded. |
| 429 | {"error":"rate_limit_day","scope":"day","retryAfter":21000} | Daily cap exceeded. |
| 400 | {"error":"invalid_input"} | Bad query params. |
| 404 | {"error":"not_found"} | No row for the requested ID. |
The API is in beta. The endpoint shape is stable but minor fields may be added (never removed without a version bump). Send feedback or request endpoints via the feedback form.
Past data is described retrospectively. Nothing returned by this API is investment advice. Disclaimer.