{
  "markdown": "# AlphaAI MCP server\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n[![Official MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.makeev%2Falphai--mcp-blue)](https://registry.modelcontextprotocol.io/v0/servers/io.github.makeev%2Falphai-mcp/versions/latest)\n[![Smithery](https://img.shields.io/badge/Smithery-Listed-000000)](https://smithery.ai/servers/mihail-makeev/alphai-news)\n[![mcp.so](https://img.shields.io/badge/mcp.so-Listed-1c1c1c)](https://mcp.so/server/alphai-news/makeev)\n[![Glama](https://glama.ai/mcp/servers/makeev/alphai-mcp/badges/score.svg)](https://glama.ai/mcp/servers/makeev/alphai-mcp)\n[![Mentioned in Awesome MCP Servers](https://awesome.re/mentioned-badge.svg)](https://github.com/punkpeye/awesome-mcp-servers)\n\n**Real-time, AI-enriched financial news for AI agents and trading bots** — over the\n[Model Context Protocol](https://modelcontextprotocol.io). Hosted at **`mcp.alphai.io`**,\nno install, OAuth (no API key to paste), free tier 100 calls/day.\n\nEvery story is enriched with **per-ticker analysis**, a **category** (14 buckets), and a\n**1–10 relevance score**, so an agent can filter to what actually matters before spending\na reasoning token.\n\n> This repo is the public home + `server.json` manifest of the **hosted** AlphaAI MCP\n> server (the listing on [Smithery](https://smithery.ai/servers/mihail-makeev/alphai-news),\n> [Glama](https://glama.ai/mcp/servers/makeev/alphai-mcp),\n> [mcp.so](https://mcp.so/server/alphai-news/makeev), the\n> [MCP Registry](https://registry.modelcontextprotocol.io) and\n> [Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers)). The product is\n> [AlphaAI](https://alphai.io) — a financial-news platform built for AI agents. There is\n> **nothing to self-host**: to use it, just connect to `https://mcp.alphai.io/mcp`.\n\n## Connect\n\nThe server speaks **Streamable HTTP** at `https://mcp.alphai.io/mcp`. Add it to any\nOAuth-capable MCP client. Claude Code:\n\n```bash\nclaude mcp add --transport http alphai https://mcp.alphai.io/mcp\n```\n\nConnecting opens a browser for **OAuth 2.1** (DCR + PKCE) — a login, no key to\ncopy-paste. ChatGPT, Claude Desktop / claude.ai, Cursor, VS Code, Windsurf and Gemini\nconnect the same way. Or use the one-click listing on\n[Smithery](https://smithery.ai/servers/mihail-makeev/alphai-news).\n\nJSON config clients (Cline, Cursor and similar):\n\n```json\n{\n  \"mcpServers\": {\n    \"alphai\": {\n      \"type\": \"http\",\n      \"url\": \"https://mcp.alphai.io/mcp\"\n    }\n  }\n}\n```\n\n### Other clients\n\n| Client | Config |\n|---|---|\n| **Claude Desktop / claude.ai** | Settings → Connectors → Add custom connector → `https://mcp.alphai.io/mcp` |\n| **Cursor** | `~/.cursor/mcp.json` → `{ \"mcpServers\": { \"alphai\": { \"type\": \"http\", \"url\": \"https://mcp.alphai.io/mcp\" } } }` |\n| **VS Code Copilot** | `.vscode/mcp.json` → `{ \"servers\": { \"alphai\": { \"type\": \"http\", \"url\": \"https://mcp.alphai.io/mcp\" } } }` |\n| **Generic** | Streamable HTTP, URL `https://mcp.alphai.io/mcp`, OAuth 2.1 |\n\n## Tools (14)\n\nMCP Server URL: https://mcp.alphai.io/mcp\n\n- `alphai_news_search` - Full-text + filtered news search (query, tickers, category, dates, relevance)\n- `alphai_ticker_news` - Latest news for one ticker (optionally incl. insider)\n- `alphai_trending` - Biggest stories of the last 48h by relevance\n- `alphai_actionable_now` - Breaking, decision-grade news (actionability + novelty gate)\n- `alphai_insider_news` - SEC Form 4 insider trades + 13F ownership moves as news\n- `alphai_pair_analysis` - Two-ticker read-across (news naming both companies)\n- `alphai_article` - Fetch a single article by `uid` (adds a structured `earnings` read on SEC filings)\n- `alphai_earnings` - AlphaAI's filing-verified earnings reads per ticker, plus the next report date\n- `alphai_calendar` - Scheduled macro releases (CPI, FOMC, jobless claims) with times and the coverage that followed\n- `alphai_macro` - Macro-economy feed (prints, central banks, rates, FX, commodities)\n- `alphai_tickers` - Discover supported tickers (US stocks, ETFs, crypto & foreign listings, incl. each one's `next_report_date`)\n- `alphai_alerts_list` / `alphai_alerts_subscribe` / `alphai_alerts_unsubscribe` - Manage your own ticker alert subscriptions *(Basic/Pro)*\n\nAll tools are **read-only** except the `alphai_alerts_*` writes, which only ever touch the\ncaller's own subscriptions. Full schemas, params and defaults are advertised by the server\n(annotations included) and documented at [alphai.io/mcp](https://alphai.io/mcp).\n\n## Tiers\n\n| | Free | Basic | Pro |\n|---|---|---|---|\n| Price | $0 (no card) | $2.99/mo | $9.99/mo |\n| Rate limit — burst | 20 / min | 60 / min | 150 / min |\n| Rate limit — daily | 100 / day | 10,000 / day | 100,000 / day |\n| Alert tools | — | ✓ | ✓ |\n| Page size | 10 | 10 | up to 50 (bulk) |\n\n## Authentication\n\n**OAuth 2.1** with [Dynamic Client Registration (RFC 7591)](https://datatracker.ietf.org/doc/html/rfc7591)\nand [PKCE](https://datatracker.ietf.org/doc/html/rfc7636) per the\n[MCP authorization spec](https://modelcontextprotocol.io/specification/authorization).\nCompatible clients discover the OAuth metadata automatically — no manual API key setup.\nTool *discovery* (`tools/list`) is open; calling a tool requires the OAuth login.\n\n## Ready-made Claude Code skills\n\nDrop-in skills that drive these tools (stock brief, market pulse, insider radar,\npeer read-across, manage alerts): **[makeev/alphai-claude-skills](https://github.com/makeev/alphai-claude-skills)**.\n\n## Links\n\n- **Playground & docs** — https://alphai.io/mcp\n- **REST API & SDKs** (Python + TypeScript) — https://alphai.io/developers\n- **Smithery listing** — https://smithery.ai/servers/mihail-makeev/alphai-news\n- **Glama connector** — https://glama.ai/mcp/connectors/io.github.makeev/alphai-mcp\n- **MCP Registry** — `io.github.makeev/alphai-mcp`\n- **Changelog** — https://alphai.io/changelog\n\n## Notes\n\n- This is a **hosted** server — to *use* it, connect to `https://mcp.alphai.io/mcp`; there\n  is nothing to self-host. This repo is the catalog home + `server.json` manifest.\n- News, not advice. The tools summarize reporting; they don't give buy/sell calls.\n- `raw_text` (full article bodies) is never served — copyright. Responses carry titles,\n  AI summaries, per-ticker analysis, categories and relevance scores.\n\nMIT licensed. Built by [AlphaAI](https://alphai.io).\n",
  "bytes": 6405,
  "sha": "37d38d0ea4e199e29a193f04c8d4708dfb1b11cf90b3e3b6da2187ca79c3c0cc",
  "repo_slug": "makeev/alphai-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_makeev_alphai_mcp_212a6262/readme"
}