AlphAI MCP server
Commit Nov 13, 2026Provides AI agents with enriched financial news, stock market sentiment, SEC insider trading data, and macro-economic feeds.
Also known as makeev/alphai-mcp, alphai-mcp
- Stars
- 3
- Tools
- 16
- Downloads, 30 days
- —
- Latest version
- 0.2.0
- Last commit
- Nov 13, 2026
- License
- MIT
What is AlphAI MCP?
AlphAI provides AI agents with enriched financial news, stock market sentiment, SEC insider trading data, and macro-economic feeds. It exposes 16 tools, such as alphai_news_search, alphai_ticker_news, alphai_trending.
Summary generated from the project's README
About AlphAI MCP server
AlphAI provides AI agents and trading bots with a specialized stream of financial intelligence. It delivers enriched news, stock market sentiment, SEC Form 4 insider trading data, and macro-economic feeds. The server is hosted at mcp.alphai.io, meaning there is no local installation required. Users connect via OAuth 2.1, which allows for a login-based setup instead of manual API key management. This makes it compatible with clients like Claude Desktop, Cursor, VS Code, and ChatGPT.
Every news item includes per-ticker analysis, a category from 14 different buckets, and a relevance score from 1 to 10. This structure helps agents filter information effectively. The server offers a free tier with limits of 20 requests per minute and 100 requests per day. Developers can access 21 different tools, including specialized functions for earnings, insider clusters, and macro-economic releases like CPI or FOMC data.
What you can do with it
- 1Monitor insider trading activityAn agent can identify companies where multiple insiders have recently purchased stock on the open market.
- 2Analyze market-wide sentimentA developer can task an AI with tracking news activity and tone across the entire market or a specific watchlist.
- 3Track macro-economic eventsAn AI client can retrieve scheduled economic releases such as interest rates or jobless claims.
- 4Perform cross-ticker analysisA user can request a read-across analysis for two different companies mentioned in the same news event.
Written from the project's README. Every use case is checked against a quote from it.
How to install AlphAI MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall AlphAI MCP in Claude Code
$ claude mcp add --transport http alphai-mcp https://mcp.alphai.io/mcpInstall AlphAI MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"alphai-mcp": {
"url": "https://mcp.alphai.io/mcp"
}
}
}Install AlphAI MCP in VS Code
.vscode/mcp.json
{
"servers": {
"alphai-mcp": {
"type": "http",
"url": "https://mcp.alphai.io/mcp"
}
}
}Install AlphAI MCP in VS Code CLI
$ code --add-mcp '{"name":"alphai-mcp","type":"http","url":"https://mcp.alphai.io/mcp"}'Install AlphAI MCP in Codex
$ codex mcp add alphai-mcp --url https://mcp.alphai.io/mcpInstall AlphAI MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.alphai-mcp] url = "https://mcp.alphai.io/mcp"
Install AlphAI MCP in Gemini CLI
$ gemini mcp add -s user --transport http alphai-mcp https://mcp.alphai.io/mcpInstall AlphAI MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"alphai-mcp": {
"url": "https://mcp.alphai.io/mcp",
"type": "http"
}
}
}AlphAI MCP tools 16
Detected from the READMEalphai_news_searchalphai_ticker_newsalphai_trendingalphai_storiesalphai_storyalphai_actionable_nowalphai_insider_newsalphai_insider_clustersalphai_pair_analysisalphai_articlealphai_earningsalphai_calendar
| alphai_news_search | — | |
| alphai_ticker_news | — | |
| alphai_trending | — | |
| alphai_stories | — | |
| alphai_story | — | |
| alphai_actionable_now | — | |
| alphai_insider_news | — | |
| alphai_insider_clusters | — | |
| alphai_pair_analysis | — | |
| alphai_article | — | |
| alphai_earnings | — | |
| alphai_calendar | — |
Show all 16 toolsShow fewer tools
alphai_macroalphai_tickersalphai_watchlist_briefalphai_radar
| alphai_macro | — | |
| alphai_tickers | — | |
| alphai_watchlist_brief | — | |
| alphai_radar | — |
Automated checks
Ran Nov 13, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablemakeev/alphai-mcp is public and reachablegithub.com/makeev/alphai-mcp ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-08github.com/makeev/alphai-mcp ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model16 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubAlphAI MCP server
A Model Context Protocol (MCP) server for financial
news, stock market sentiment and SEC Form 4 insider trading data — built for AI agents
and trading bots. Hosted at mcp.alphai.io, no install, OAuth (no API key to paste),
free tier 20 req/min and 100 req/day.
Every story is enriched with per-ticker analysis, a category (14 buckets), and a 1–10 relevance score, so an agent can filter to what actually matters before spending a reasoning token.
This repo is the public home +
server.jsonmanifest of the hosted AlphAI MCP server (the listing in the ChatGPT plugin directory, on Smithery, Glama, mcp.so, the MCP Registry and Awesome MCP Servers). The product is AlphAI — a financial-news platform built for AI agents. There is nothing to self-host: to use it, just connect tohttps://mcp.alphai.io/mcp.
Connect
ChatGPT: install AlphAI from the ChatGPT plugin directory. Click Install plugin, then sign in to AlphAI and approve access.
The server speaks Streamable HTTP at https://mcp.alphai.io/mcp. Add it to any
OAuth-capable MCP client. Claude Code:
claude mcp add --transport http alphai https://mcp.alphai.io/mcp
Connecting opens a browser for OAuth 2.1 (DCR + PKCE) — a login, no key to copy-paste. ChatGPT, Claude Desktop / claude.ai, Cursor, VS Code, Windsurf and Gemini connect the same way. Or use the one-click listing on Smithery.
JSON config clients (Cline, Cursor and similar):
{
"mcpServers": {
"alphai": {
"type": "http",
"url": "https://mcp.alphai.io/mcp"
}
}
}
Other clients
| Client | Config |
|---|---|
| ChatGPT | Plugin directory listing → Install plugin |
| Claude Desktop / claude.ai | Settings → Connectors → Add custom connector → https://mcp.alphai.io/mcp |
| Cursor | ~/.cursor/mcp.json → { "mcpServers": { "alphai": { "type": "http", "url": "https://mcp.alphai.io/mcp" } } } |
| VS Code Copilot | .vscode/mcp.json → { "servers": { "alphai": { "type": "http", "url": "https://mcp.alphai.io/mcp" } } } |
| Generic | Streamable HTTP, URL https://mcp.alphai.io/mcp, OAuth 2.1 |
Tools (21)
MCP Server URL: https://mcp.alphai.io/mcp
alphai_news_search- Full-text + filtered news search (query, tickers, category, dates, relevance)alphai_ticker_news- Latest news for one ticker (optionally incl. insider)alphai_trending- Top articles of the last 48h by relevance, reprints collapsedalphai_stories- Stories: events two or more publishers reported, summarised from their articles;list=topranks the last 48h,list=latestpages newest-firstalphai_story- One story bystory_id(the key every news item carries): summary, key facts with sources, per-ticker read, open questions, plus the articles behind italphai_actionable_now- Breaking, decision-grade news (actionability + novelty gate)alphai_insider_news- SEC Form 4 insider-trade newsalphai_insider_clusters- Issuers where several insiders bought on the open market in one run of purchases (Form 4, labeled per buyer)alphai_pair_analysis- Two-ticker read-across (news naming both companies)alphai_article- Fetch a single article byuid(adds a structuredearningsread on SEC filings)alphai_earnings- AlphAI's filing-verified earnings reads per ticker, plus the next report datealphai_calendar- Scheduled macro releases (CPI, FOMC, jobless claims) with times and the coverage that followedalphai_macro- Macro-economy feed (prints, central banks, rates, FX, commodities)alphai_tickers- Discover supported tickers (US stocks, ETFs, crypto & foreign listings, incl. each one'snext_report_date)alphai_watchlist_brief- Recent news and filing events for your saved watchlist, on every planalphai_radar- News activity and tone across the market or your saved watchlist, with linked evidence, 4h/24h windows and snapshot-pinned paginationsearch/fetch- Citation-ready article discovery and retrieval for compatible research clientsalphai_alerts_list/alphai_alerts_subscribe/alphai_alerts_unsubscribe- Manage your own ticker alert subscriptions (Basic/Pro)
All tools are read-only except the alphai_alerts_* writes, which only ever touch the
caller's own subscriptions. Full schemas, params and defaults are advertised by the server
(annotations included) and documented at alphai.io/mcp.
Tiers
| Free | Basic | Pro | |
|---|---|---|---|
| Price | $0 (no card) | $2.99/mo | $9.99/mo |
| Rate limit — burst | 20 / min | 60 / min | 150 / min |
| Rate limit — daily | 100 / day | 10,000 / day | 100,000 / day |
| Alert tools | — | ✓ | ✓ |
| News page size | up to 20 | up to 20 | up to 50 (bulk) |
| News archive | 30 days | 90 days | 180 days |
| Radar market + saved watchlist | ✓ | ✓ | ✓ |
| Radar added delay | 60 min | 15 min | None |
Radar refreshes each minute. Delays apply to the complete snapshot, including supporting headlines; collection and enrichment add processing time. Its descriptive scores are not predictions or confirmed alerts. Radar accepts up to 100 rows per call on every plan, with no separate ticker allowance; saved watchlists retain their existing limits (Free 10 companies, paid unlimited).
Authentication
OAuth 2.1 with Dynamic Client Registration (RFC 7591)
and PKCE per the
MCP authorization spec.
Compatible clients discover the OAuth metadata automatically — no manual API key setup.
Both tool discovery (tools/list) and calls require authentication. Headless
clients can use the same API key as the REST API in an Authorization: Bearer ak_live_… header; never put a key in the URL. OAuth and API keys have tool parity.
Ready-made Claude Code skills
Drop-in skills that drive these tools (stock brief, market pulse, insider radar, peer read-across, manage alerts): makeev/alphai-claude-skills.
Links
- Playground & docs — https://alphai.io/mcp
- REST API & SDKs (Python + TypeScript) — https://alphai.io/developers
- ChatGPT plugin — https://chatgpt.com/plugins/plugin_asdk_app_6ac9df3f46e88191914f16c4af63ce64
- Smithery listing — https://smithery.ai/servers/mihail-makeev/alphai-news
- Glama connector — https://glama.ai/mcp/connectors/io.github.makeev/alphai-mcp
- MCP Registry —
io.github.makeev/alphai-mcp - Changelog — https://alphai.io/changelog
Notes
- This is a hosted server — to use it, connect to
https://mcp.alphai.io/mcp; there is nothing to self-host. This repo is the catalog home +server.jsonmanifest. - News, not advice. The tools summarize reporting; they don't give buy/sell calls.
raw_text(full article bodies) is never served — copyright. Responses carry titles, AI summaries, per-ticker analysis, categories and relevance scores.
MIT licensed. Built by AlphAI.
AlphAI MCP questions
How do I add AlphAI MCP to Claude Code?
Run claude mcp add --transport http alphai-mcp https://mcp.alphai.io/mcp in your terminal. Add --scope user to make it available in every project.
How do I add AlphAI MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does AlphAI MCP provide?
It exposes 16 tools, including alphai_news_search, alphai_ticker_news, alphai_trending, alphai_stories, alphai_story.
Do I need an API key to use this server?
No, it uses OAuth 2.1 which allows you to sign in via a browser without needing to manually copy and paste an API key.
Is there a free tier available?
Yes, there is a free tier that allows for 20 requests per minute and 100 requests per day.
Does the server provide full article text?
No, for copyright reasons, the server does not provide full article bodies; instead, it provides titles, AI summaries, and per-ticker analysis.