# makeev/alphai-mcp [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/makeev/alphai-mcp  
**GitHub Stars:** 2  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/makeev-alphai-mcp

## Description
Real-time, AI-enriched financial news for trading agents: full-text & ticker search, trending and "actionable-now" feeds, SEC Form 4 insider transactions, and two-ticker read-across. Each story carries per-ticker analysis and a 1-10 relevance score. Hosted at mcp.alphai.io, OAuth, free 100 calls/hour.

## Tools
Capabilities this server exposes over 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** — Biggest stories of the last 48h by relevance
- **alphai_actionable_now** — Breaking, decision-grade news (actionability + novelty gate)
- **alphai_insider_news** — SEC Form 4 insider trades + 13F ownership moves as news
- **alphai_pair_analysis** — Two-ticker read-across (news naming both companies)
- **alphai_article** — Fetch a single article by `uid` (adds a structured `earnings` read on SEC filings)
- **alphai_earnings** — AlphaAI's filing-verified earnings reads per ticker, plus the next report date
- **alphai_calendar** — Scheduled macro releases (CPI, FOMC, jobless claims) with times and the coverage that followed
- **alphai_macro** — Macro-economy feed (prints, central banks, rates, FX, commodities)
- **alphai_tickers** — Discover supported tickers (US stocks, ETFs, crypto & foreign listings, incl. each one's `next_report_date`)

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "alphai-mcp": {
    "command": "npx",
    "args": ["-y","makeev-alphai-mcp"]
  }
}
```

## Documentation

## What makeev/alphai-mcp MCP server does

The makeev/alphai-mcp MCP server exposes AlphaAI’s financial-news platform to MCP-compatible clients. It returns AI-enriched stories with per-ticker analysis, a news category, and a relevance score from 1 to 10. Coverage includes US stocks, ETFs, crypto, foreign listings, insider activity, SEC-related earnings information, macroeconomic releases, central-bank activity, rates, foreign exchange, and commodities.

The service is hosted by AlphaAI at `https://mcp.alphai.io/mcp`; the repository contains the public project home and MCP registry manifest rather than a self-hostable application. It is suitable for agents that need to find, filter, compare, or summarize market news inside an analysis workflow.

## How it works

The makeev/alphai-mcp MCP server uses Streamable HTTP for MCP communication. A compatible client connects to the hosted endpoint and discovers the available tools. OAuth 2.1 with Dynamic Client Registration and PKCE provides authentication; supported clients can discover the authorization metadata automatically.

Most operations are read-only. The alert subscription tools can create, list, or remove subscriptions, but those writes are limited to the authenticated caller’s own ticker alerts. Tool schemas, parameters, defaults, and annotations are advertised by the server.

## Setup and configuration

No local package installation or self-hosting is required. Add `https://mcp.alphai.io/mcp` as an HTTP MCP server in a compatible client, then complete the browser-based OAuth login. Claude Desktop, Cursor, Windsurf, and Cline are named as compatible clients in the project documentation. JSON-configured clients use an HTTP server entry with the endpoint as its URL.

The makeev/alphai-mcp MCP server does not require a manually entered API key. The free plan costs nothing and permits 100 calls per day, with a 20-call-per-minute burst limit. Basic and Pro plans increase the daily and burst limits and enable alert tools; Pro also supports larger page sizes.

## Tools and capabilities

Available capabilities include:

- Search news by text, ticker, category, date range, and relevance.
- Retrieve recent coverage for one ticker, optionally including insider information.
- Find highly relevant stories from the previous 48 hours.
- Filter for breaking stories passing AlphaAI’s actionability and novelty criteria.
- Read SEC Form 4 insider trades and 13F ownership changes as news.
- Compare two tickers through stories that mention both companies.
- Fetch an article by UID, including a structured earnings reading when SEC filings apply.
- Retrieve filing-verified earnings analysis and the next report date for a ticker.
- Inspect scheduled CPI, FOMC, jobless-claims, and other macro releases alongside subsequent coverage.
- Browse macroeconomic news and discover supported tickers and their next report dates.
- Manage the authenticated user’s ticker-alert subscriptions on eligible plans.

## Limitations and notes

The makeev/alphai-mcp MCP server does not provide full article bodies. Responses contain titles, summaries, ticker analysis, categories, and relevance scores instead, so it is not a replacement for retrieving copyrighted source text. Its output summarizes reporting and is explicitly not investment advice or a buy/sell recommendation.

Access requires OAuth when calling tools, even though tool discovery is open. The free plan has lower limits and does not include alert tools. The repository describes the service as hosted, so deploying the repository locally is not the intended operating model.

_Full upstream README: https://allmcps.com/mcp/makeev-alphai-mcp/readme_