AletaIndex Narrative Intelligence
OfficialThe AletaIndex Narrative Intelligence server provides financial narrative analysis and risk assessment for stocks, with two core capabilities:
Get Narrative Intelligence for Stocks (
get_narratives): Retrieve structured narrative data for up to 10 tickers per request, including persistent story threads ("global narratives") with titles, dominance scores, and sentiment; daily article clusters showing how narratives evolve; individual articles with relevance scores; and sentiment trajectories (e.g., Escalating, Stable, Declining) over custom date ranges (default: last 7 days).Analyze Portfolio Narrative Risk (
get_portfolio_risk): Assess narrative risk across up to 50 holdings by grouping narratives into macro themes (e.g., "AI Regulation", "Interest Rate Sensitivity"). Identifies concentrated narrative exposure across multiple positions, provides weighted exposure scores per theme based on portfolio allocation, and returns an overall portfolio narrative concentration score.
Coverage: Free tier includes 10 tickers (TSLA, NVDA, AAPL, MSFT, AMZN, GOOGL, META, AMD, NFLX, JPM); paid plans cover 109 tickers. Accessible via MCP integration or direct REST API.
AletaIndex Narrative Intelligence API
Give your AI agent a financial narrative brain.
AletaIndex tracks how financial stories evolve across thousands of news sources in real time — clustering articles into structured narratives, measuring sentiment momentum, and mapping narrative risk across portfolios. Available for 109 tickers across all major sectors.
Instead of raw news feeds or simple sentiment scores, your agent gets narrative-level intelligence: what the market is talking about, how strongly, and whether it's shifting.

What Your Agent Can Do
💡 For best results, paste this at the start of your conversation:
You have access to the Aleta Index MCP, which provides narrative intelligence
derived from institutional news sources.
When analyzing stocks, prioritize the narrative layer: global narratives,
daily topics, sentiment scores, mention counts, sentiment trends, and
behavioral patterns. The narrative layer aggregates signal across hundreds
of sources and contains sufficient information for analysis — avoid reading
individual article bodies unless specifically necessary.You: "What narratives are driving NVDA right now? Any sentiment shifts?"
Agent: NVDA is currently dominated by two narratives:
1. "AI Infrastructure Supercycle" — 47 articles, sentiment +0.68, trending up
2. "Export Control Headwinds" — 23 articles, sentiment -0.41, stable
Sentiment on "Export Control Headwinds" has improved +0.12 over the past week,
suggesting the market is pricing in less risk from the latest policy signals.No prompt engineering required. The agent knows how to query the data automatically.
Related MCP server: TickerDB
Three Ways to Integrate
Option A — MCP Server via PyPI (Local install, recommended)
One-line config via uvx. Works with Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible agent.
→ MCP Quickstart
Option B — MCP Directories (Zero install)
One click on Smithery or Glama. Works with Claude, Cursor, Windsurf, and any MCP-compatible agent — no local setup required. → Add on Smithery · Add on Glama
Option C — REST API
Direct HTTP calls. Works with any language or framework. → API Reference
Pricing
Tier | Tickers | History | Credits | Price |
Free Trial | 10 tickers | 90 days | 500 (one-time) | Free, 7 days |
Plus | All 109 tickers | 180 days | 2,500/month | $99/mo |
Scale | All 109 tickers | Full history | Custom | Custom — contact us |
Free tickers: TSLA NVDA AAPL MSFT AMZN GOOGL META AMD NFLX JPM
Quick Example
import requests
from datetime import date, timedelta
API_KEY = "nk_your_key_here"
BASE_URL = "https://aletaindex-narrative.com"
to_date = date.today()
from_date = to_date - timedelta(days=6) # 7-day window (inclusive)
resp = requests.get(
f"{BASE_URL}/v1/narratives/comprehensive",
headers={"X-API-Key": API_KEY},
params={
"tickers": "NVDA",
"from_date": from_date.isoformat(),
"to_date": to_date.isoformat(),
},
)
data = resp.json()
for narrative in data["results"][0]["global_narratives"]:
sentiment = narrative["sentiment"]
print(narrative["title"], "-", sentiment["sentiment_label"], f"({sentiment['avg_sentiment']:.2f})")Example response (truncated):
{
"results": [
{
"ticker": "NVDA",
"global_narratives": [
{
"narrative_id": 142,
"title": "AI Infrastructure Supercycle",
"dominance_score": 0.847,
"is_active": true,
"daily_topics": [
{
"event_date": "2026-05-10",
"article_count": 14,
"sentiment": {
"avg_sentiment": 0.71,
"sentiment_label": "Positive",
"trajectory": "Escalating"
}
}
]
},
{
"narrative_id": 89,
"title": "Export Control Headwinds",
"dominance_score": 0.312,
"is_active": true,
"daily_topics": [
{
"event_date": "2026-05-10",
"article_count": 6,
"sentiment": {
"avg_sentiment": -0.38,
"sentiment_label": "Negative",
"trajectory": "Stable"
}
}
]
}
]
}
]
}Documentation
API Reference — endpoints, parameters, response schemas
Data Model — narrative hierarchy explained
MCP Quickstart — agent integration in 2 minutes
Direct API Guide — REST integration guide
Example Prompts — prompt templates for trading agents
Available Tools
2 toolsget_narrativesA
Get financial narrative intelligence for one or more stocks.
Returns structured narrative data: persistent story threads (global narratives),
daily article clusters, individual articles, and sentiment scores. Use this to
understand what stories are driving a stock and how sentiment is evolving.
Args:
tickers: Comma-separated ticker symbols. Examples: "NVDA" or "NVDA,TSLA,AAPL".
Maximum 10 tickers per request. Free tier: TSLA, NVDA, AAPL, MSFT,
AMZN, GOOGL, META, AMD, NFLX, JPM. Plus/Scale: all 109 tickers.
from_date: Start date in YYYY-MM-DD format. Defaults to 7 days ago.
to_date: End date in YYYY-MM-DD format. Defaults to today.
Returns:
Dict with narrative data per ticker, including global_narratives (persistent story
threads with title, sentiment, and dominance), daily_topics (day-level article
clusters), and articles (individual news items with relevance and sentiment scores).
Inputs: tickers (required), from_date, to_date.
get_portfolio_riskA
Analyze narrative risk across a portfolio of stocks.
Groups narratives across all holdings by macro theme (e.g. "AI Regulation",
"Interest Rate Sensitivity") and identifies which stories create concentrated
narrative exposure across multiple positions simultaneously.
Args:
holdings: Portfolio positions as TICKER:WEIGHT pairs, comma-separated.
Weights represent portfolio allocation (should sum to ~1.0).
Example: "NVDA:0.30,AAPL:0.25,TSLA:0.20,MSFT:0.25"
Maximum 50 holdings.
Returns:
Dict with macro risk themes, each showing affected tickers, dominant narrative
titles, sentiment trajectory, and weighted exposure score. Also includes an
overall portfolio narrative concentration score.
Inputs: holdings (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: get_narratives retrieves narrative data for specific tickers, while get_portfolio_risk analyzes cross-holding narrative exposure. There is no overlap in functionality.
Both tools follow a consistent verb_noun pattern (get_narratives, get_portfolio_risk), making the naming predictable and clear.
With only 2 tools, the surface is slightly thin, but they cover the core use cases of narrative retrieval and portfolio risk analysis. The small count is acceptable given the focused domain.
The tools cover the primary functions for narrative intelligence: retrieving narratives for stocks and assessing portfolio risk. Minor gaps exist (e.g., no narrative search or comparison), but the set is sufficient for its stated purpose.
Maintenance
Related MCP Connectors
Financial intelligence for AI agents: market events, sentiment, technicals, news feed.
Evidence-backed capital-change intelligence and sourced financial data for AI agents
Realtime financial context for AI agents: what changed, who is affected, and what to watch next. One suite covering news, events, guidance, filing changes, sentiment, stakeholders, and alerts. Information-efficient responses with evidence for every result. First-class point-in-time safety for backtests. Pairs well with web search and a market-data API. All data is our own.
Real-time financial news for AI agents: search by ticker and source, with sentiment and entities.
Related MCP Servers
- FlicenseNot gradedqualityNot gradedmaintenanceSocial Arbitrage Intelligence: real-time X/Twitter sentiment, narrative velocity & contrarian signals for AI agents, powered by Grok-
- AlicenseAqualityBmaintenancePoint-in-time market data for AI agents: stocks, ETFs and crypto as named bands plus raw values.105MIT
- AlicenseAqualityBmaintenanceReal-time financial news for AI agents and trading bots — AI-enriched stories with per-ticker analysis, a 1–10 relevance score, SEC Form-4 insider transactions, plus trending and "actionable-now" feeds. Free tier, OAuth, no API key to paste.2113MIT
- AlicenseAqualityDmaintenanceNarrative & signal intelligence for AI agents: crypto/AI/macro convergence & divergence.21MIT