Skip to main content
Glama
AletaIndex Narrative Intelligence

AletaIndex Narrative Intelligence

Official
by AletaIndex

AletaIndex Narrative Intelligence API

PyPI Python License: Apache 2.0 Smithery Glama

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.

Dominant Narrative Evolution — TSLA 180-day view showing 5 persistent narrative threads, article volume, and daily return overlay


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

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

→ Get your API key


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

Available Tools

2 tools
get_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

    A4.5/5.0

    Scored across 2 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    Both tools follow a consistent verb_noun pattern (get_narratives, get_portfolio_risk), making the naming predictable and clear.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers