MCP server

News for AI agents.

Plug alphai into ChatGPT, Claude, Gemini, Cursor, VS Code, Windsurf, or any other client that speaks MCP over Streamable HTTP. Setup is one OAuth login, about a minute. After that your agent can search scored, ticker-linked news, pull insider filings, and triage what's breaking in real time. Behind the tools we scan 10,000+ articles from 6,900+ sources every day, score them 1–10, and let fewer than one in five into the feed.

Get a free API key See pricing

OAuth 2.1 or API key · Streamable HTTP · Free, Basic, and Pro plans

Install

Apps · IDEs · SDKs · frameworks

Settings → Connectors → Add custom connector

  Name: alphai
  URL:  https://mcp.alphai.io/mcp

Claude Desktop opens your browser to log in to alphai and approve
the connection. After that, the alphai tools appear in the tool
list automatically. No API key to copy — auth uses OAuth 2.1.

If login doesn't start

Connecting opens a browser window to authorize (OAuth 2.1); approve it while the client is still running. If the callback tab shows “This site can't be reached”, the client that started the login was restarted mid-flow. Toggle the server off and on (or reconnect) to get a fresh login window, then approve promptly.

Using the mcp-remote bridge? Stale state lives in ~/.mcp-auth; delete that directory and reconnect to restart the flow clean. And a bare curl of the server URL answering 401 is expected: that response is what tells your client to start OAuth.

Running headless, or the browser dance keeps failing? Use an API key instead: create one under Account and send it as Authorization: Bearer ak_live_... (see the “API key (headless)” tab above). No OAuth involved.

Claude Code

Drop-in skills for Claude Code.

Skip the prompting. alphai-claude-skills is an open-source pack of Claude Code skills that wrap these tools into ready-made workflows: a one-ticker brief, a market pulse, an insider-activity scan, a two-ticker read-across, and alert management. Copy them into ~/.claude/skills/ and ask in plain English.

Browse the skills →All examples →Terminal dashboard: alphai-tui →

# 1. connect the MCP
claude mcp add --transport http alphai https://mcp.alphai.io/mcp

# 2. add the skills
git clone https://github.com/makeev/alphai-claude-skills
cp -r alphai-claude-skills/skills/* ~/.claude/skills/

Tools

13 tools · Streamable HTTP · OAuth 2.1 or API key

alphai_news_search

Query the news feed with a free-text query or structured filters — tickers, category, date range, and relevance. Company names, tickers and topic words in query resolve to filters; limit is an alias for page_size. Set collapse_stories=true to get one row per story instead of every article about it (syndicated reprints and independent write-ups of one event group together), with sources_count: how many distinct outlets carried it, usually 1 because most stories run at a single outlet. For repeated polling, sort="ingested" returns rows in the order they entered the feed: next_cursor is always returned, and an empty items list means you are caught up. Every item carries created_at, the moment AlphaAI received the article, next to its time_published.

alphai_ticker_news

Latest news for a specific ticker, newest first; insider filings included by default. Takes the same min_relevance floor as alphai_news_search, so you can ask for one ticker's material news only. Paginates with a cursor; sort="ingested" flips it to delta polling (only rows added since your cursor). collapse_stories=true collapses reprints and other articles covering the same event. Delisted symbols serve their history with delisted=true, and renamed_to points to the ticker the company continues under. Any share class of an issuer serves rows tagged with its other listed classes (GOOGL includes GOOG). Bare crypto names resolve to their -USD form (DOGE serves Dogecoin).

alphai_trending

Top stories of the last 48 hours by relevance score decayed by article age, so fresh stories lead, with at most two stories per ticker. Reprints and independent write-ups collapsed to one representative per story, with story_id, sources_count and sources on each item; pass dedupe=false to keep every article instead.

alphai_actionable_now

Breaking news from the last few hours, gated to high-actionability "act on this today" items for triage loops — widen the floor with min_actionability="medium" to include position-shaping stories.

alphai_macro

The market-wide macro tape from the last N hours: central-bank decisions, inflation and jobs prints, commodities and geopolitics in one call, ordered novelty-first so on a release day the release itself leads and the commentary follows. Macro rows are market-wide events and mostly carry no tickers; each item still carries the full analysis inline. Narrow with categories, or raise min_relevance to 7 to keep roughly the release-day events.

alphai_calendar

The forward half of the macro loop: scheduled US releases from the official agency calendars — FOMC decisions (with SEP and press-conference markers) and minutes, CPI, PPI, the jobs report, GDP estimates, PCE, retail sales, weekly jobless claims and JOLTS. Each occurrence has a stable uid that survives reschedules, a phase (upcoming or elapsed; elapsed means the scheduled moment passed, check schedule_status for postponements) and, on elapsed occurrences, coverage: the top feed stories about that release, ready to expand via alphai_article. days_back counts from today's UTC midnight, so the default still includes today's already-released prints. Ask it what is coming this week, then read alphai_macro for what a release meant.

alphai_insider_news

Insider-transaction news: SEC Form 4 trades by directors, officers and 10%+ owners, filterable by ticker, date, minimum relevance, and 10b5-1 status (is_10b5_1=false leaves the discretionary trades, dropping sales that ran on a plan scheduled months earlier). Items include structured trade fields: side, shares, average price, total value, the reporting owner, and when the filing landed (filed_at, plus late_filing for the ones that missed the two business day deadline). sort="ingested" flips it to delta polling, which is the mode to use for watching new filings: a Form 4 is filed days after the trade it reports, so a new event often enters the feed below the newest page.

alphai_pair_analysis

Cross-ticker read-across: stories naming both tickers, plus each one's own recent tape side by side.

alphai_article

Fetch a single article by UID with full enrichment (key entities, context, market relevance).

alphai_tickers

List supported tickers with metadata (name, sector, exchange).

alphai_alerts_list

List your active ticker news-alert subscriptions and their filters. (Basic/Pro)

alphai_alerts_subscribe

Subscribe a ticker to news alerts, with optional category and relevance filters. (Basic/Pro)

alphai_alerts_unsubscribe

Remove one of your ticker news-alert subscriptions. (Basic/Pro)

ChatGPT connector contract: natural-language news search — ticker symbols, company names, and topic words in the query resolve to filters. Powers ChatGPT deep research; agents with precise filters should prefer alphai_news_search.

fetch

ChatGPT connector contract: fetch one article by the id a search result returned — enriched digest plus the canonical alphai.io URL for citation.

Limits by plan

Same tools, deeper reach.

Every plan sees all thirteen tools. Tiers differ on cadence, page depth (page_size caps at 20 on Free and Basic and 50 on Pro; oversized requests are clamped, not rejected), how far back search reaches, and alert capacity. MCP calls are metered per account, with a per-minute burst cap and a per-day volume cap, separately from the REST quota.

Full pricing →

	Free	Basic	Pro
Burst / min	20	60	150
Volume / day	100	10,000	100,000
Max page size	10	10	50
News archive depth	30 days	90 days	180 days
Ticker alerts	—	10	50
Alert delivery	—	Daily digest	Instant

Workflows people ship

What an MCP-connected agent can do.

One OAuth flow connects all thirteen tools. Your agent taps the same news index you read yourself.

01MCP

"Claude, what moved NVDA today?"

alphai_news_search → MCP

Try it

02REST API

"Send only high-relevance earnings news for my watchlist."

/api/news/?category=earnings · min_relevance=7

Try it

03REST API

"Build a Telegram bot for market-moving news in 10 minutes."

/api/news/trending/ + your bot framework

Try it

04MCP

"Any insider buying in my watchlist this week?"

alphai_insider_news → MCP · /api/news/insider/

Try it

05MCP

"Feed my agent relevance-scored financial news via MCP."

OAuth 2.1 · 13 tools · Streamable HTTP

Try it

Not a mock

What your agent gets right now.

The stories alphai_trending returns at this moment, trimmed to the core fields. Ask Claude what's moving and these are the rows behind the answer.

Rendered 17:30 UTC, Aug 15

alphai_trending · output excerpt

[
  {
    "title": "Motorola Solutions (MSI) Q2 2026 Earnings Call Transcript",
    "tickers": [
      "MSI"
    ],
    "relevance_score": 9,
    "category": "earnings",
    "published": "2026-08-15T11:57:40Z"
  },
  {
    "title": "Wolverine World Wide Q2 Earnings Call Highlights",
    "tickers": [
      "WWW"
    ],
    "relevance_score": 9,
    "category": "earnings",
    "published": "2026-08-15T10:15:00Z"
  },
  {
    "title": "Gilat Satellite Networks Targets Defense, In-Flight Growth With Comtech Deal",
    "tickers": [
      "GILT"
    ],
    "relevance_score": 9,
    "category": "mergers_acquisitions",
    "published": "2026-08-15T09:45:00Z"
  }
]

Example prompt

Claude, what's moving in chips today?

Once alphai is installed, Claude reaches for the right tools on its own; you never have to name a tool in the prompt. The same articles you read in the feed end up in Claude's context window.

Transcript · Claude Code

You

What's driving semiconductor stocks today? Focus on the last 24 hours.

Claude

[invoking alphai_news_search with tickers=["NVDA","AMD","TSM"], min_relevance=8, from_date=yesterday]

Three threads are driving chip names today: (1) the White House is expected to tighten Nvidia export curbs to China on Friday — Reuters, rel 9/10; (2) TSMC reaffirmed 2026 capex despite a softer Q1 — FT, rel 8/10; (3) AMD said its MI400 is sampling with three hyperscalers — Bloomberg, rel 8/10…

Changelog

Still shipping.

Full changelog →

August 15, 2026API · MCP

Date windows on the news feeds

August 14, 2026MCP

Relevance floor on the per-ticker feed

August 13, 2026API · MCP

Insider feed: 10b5-1 filter, joint-filing names

Statusuptime over the last 30 days

Live status →

100%

Website

100%

REST API

100%

Public API gate

100%

MCP server

The probes run from GitHub Actions, outside our own infrastructure, so the status page stays reachable when our services are not. The API probe is a deep one and passes only when the database and the cache both answer. Response times, history and past incidents are public.

Questions

What is the alphai MCP server?

A hosted financial-news MCP server. It exposes alphai's scored, ticker-linked news feed, SEC Form 4 insider filings, and trending-story triage as Model Context Protocol tools that any compliant client can call. Connect once over OAuth 2.1 and your agent reads the same enriched newswire that powers alphai.io.

Which MCP clients work with alphai?

Any spec-compliant MCP client that speaks Streamable HTTP. ChatGPT, Claude Desktop, Claude Code, Gemini, Cursor, VS Code, and Windsurf are all tested. Point the client at https://mcp.alphai.io/mcp and authenticate with OAuth in the browser, or send an alphai API key as a Bearer header where no browser is available.

Can I connect without a browser, for a bot or a server?

Yes. The same API keys that authenticate the alphai REST API work on the MCP server: send Authorization: Bearer ak_live_... with every request and skip the OAuth flow entirely. Create a key under Account, then paste it into any client that supports custom headers, such as n8n, cron agents, CI jobs, or an SDK. The key carries the same plan limits as an OAuth session.

Is there a free tier for the MCP server?

Yes. The Free plan connects to the MCP server with an allotment of 20 requests a minute and 100 a day, which is enough to wire an agent up and evaluate the tools before paying. Basic and Pro raise the caps for production and commercial use.

How do I connect Claude to financial news?

In Claude Desktop, open Settings → Connectors → Add custom connector, name it alphai, and paste https://mcp.alphai.io/mcp. Claude walks you through the OAuth login, then reaches for the alphai tools on its own whenever a prompt needs market news.

Claude + the newswire.

The Free tier is 100 calls a day, no card. Sign up, connect your MCP client, and your agent is reading the feed in about a minute.

Get a free API key See plans