stock-sentiment

# Stock Sentiment & Financial Data

Stock sentiment analysis and US equity research tools. Query multi-engine AI sentiment scores, SEC filings, analyst ratings, earnings transcripts, social media sentiment, macro indicators, and price data for 2000+ stocks — all through 27 MCP tools.

## References

- `references/tools.md` — full tool reference with parameters and descriptions
- `references/workflows.md` — step-by-step research workflows (stock analysis, sentiment, macro, deep search)

## Quick Start

No token or registration needed. Free tier: 20 requests/day per IP.

**Check data coverage:**
```
mcp__alphafactoryx__get_archive_stats()
```

**Research a stock:**
```
mcp__alphafactoryx__sa_overview(symbol="AAPL")
mcp__alphafactoryx__edgar_latest(symbol="AAPL", form_type="10-K")
mcp__alphafactoryx__stocknews_articles(symbol="AAPL")
mcp__alphafactoryx__kline(symbol="AAPL")
```

**Search across archives:**
```
mcp__alphafactoryx__edgar_search(query="revenue guidance", symbol="AAPL")
mcp__alphafactoryx__sa_search(query="AI chips")
mcp__alphafactoryx__sa_transcript_search(query="margin expansion")
```

**Check sentiment:**
```
mcp__alphafactoryx__stocknews_articles(symbol="AAPL")
mcp__alphafactoryx__polygon_news_articles(symbol="AAPL")
mcp__alphafactoryx__x_sentiment(symbol="AAPL")
```

**Get macro data:**
```
mcp__alphafactoryx__fred_macro()
```

## Tool Categories

| Category | Tools | Key Capabilities |
|----------|-------|-----------------|
| General | 1 | Archive stats and data coverage |
| SEC EDGAR | 5 | Filings (10-K, 10-Q, 8-K, Form 4), full text, full-text search |
| Seeking Alpha | 10 | Articles, news, earnings transcripts, ratings, financials, comments, search |
| Stock News | 2 | News articles with Grok + DeepSeek + GPT-5 sentiment, search |
| Polygon News | 2 | News with per-ticker AI sentiment insights + reasoning, search |
| X/Twitter | 3 | Tweets by engagement, filtered posts, high-engagement threads |
| FRED Macro | 2 | 25 macro indicators (rates, CPI,...