MCP

MCP (Model Context Protocol) lets AI assistants access AltIndex data directly through conversation. Instead of writing API calls, describe what you want in natural language and get real data back.

Price targets and upside

AltIndex's six-month AI forecast and external analyst targets are different estimates. To match the upside on the public AltIndex forecast page, use get_security_snapshot and read ai.forecast.upside_percent. The external analyst estimate is separate, under market.analyst_forecast.

Both objects include target_price, target_as_of, reference_price, reference_price_as_of, and signed upside_percent. Upside is (target_price / reference_price - 1) × 100, rounded to one decimal; a negative value means downside. The reference is the latest available market price, not the model's original anchor. The target date records when it landed, not necessarily when the model repriced. AI forecasts specify horizon_months: 6; analyst horizons are unavailable. Missing forecasts or upside are omitted, not zero.

For history, get_security_signals accepts ai_price_target and analyst_price_target. The old target_price request remains a permanent alias for analyst_price_target, with the canonical name and a compatibility notice returned. Week/month/year changes measure changes in the target itself, not stock upside. Historical REST forecast anchor_price retains its separate, original-model-reference meaning.

query_market_events exposes ai_price_target_raise and ai_price_target_cut. These describe changes to AltIndex's AI forecast, not analyst actions. Their change_pct compares consecutive daily targets. Momentum and search expose ai_price_target_change_count_30d; search accepts that sort and the ai_price_target_change_in_last_30d filter. Daily duplicates are resolved before counting changes.

Legacy analyst_price_target_raise / analyst_price_target_cut event inputs, the analyst_event_in_last_30d filter, and the analyst_event_count_30d sort remain permanent compatibility aliases. Responses use the corrected AI names and include compatibility_notices. Conflicting old/new filter values return an actionable error. Analyst actions are not available through this event feed; analyst targets remain available separately.

What you can do

Research a stock

Ask about any company's alternative data signals, social trends, fundamentals, and recent events.

"Give me a full overview of Tesla's alternative data signals"

"Show me Apple's social sentiment trend over the last 30 days"

"What news and Reddit discussion is driving NVDA right now?"

Monitor your portfolio

Get an enriched snapshot of your connected portfolio, including AI scores, social momentum, and recent events for each holding.

"How is my portfolio doing?"

"Which of my holdings have the strongest social momentum?"

"Show me the AI score breakdown for my portfolio"

Track your watchlist

Check in on your saved watchlist with the same enriched data available for portfolio holdings.

"Show me my watchlist with AltIndex scores"

"Are any of my watchlist stocks showing unusual activity?"

Scan the market

Search across the full AltIndex universe (~2,960 securities) using filters like AI score, social mentions, insider buying, hiring velocity, and more. Surface market events like earnings surprises, AltIndex AI target changes, and social media spikes.

"Find stocks with rising Reddit mentions and insider buying in the last 90 days"

"What earnings surprises happened this week?"

"Show me the top 10 stocks by social momentum in the technology sector"

"Which stocks had the biggest AI score jumps this month?"

Two ways to connect

There are two ways to connect, and they give you different data.

Sign in with your AltIndex account (OAuth). Your assistant reads your own portfolio and watchlist, and all market data. This needs an AltIndex Starter or Pro subscription. Start at Get connected.

Use a Developer API key. Your assistant reads market data only. Your portfolio and watchlist stay private, because a key is not a person. This needs the Developer rung or above. Start at Connect with an API key.

Get connected

This section is the OAuth method. Your client opens a browser window. Sign in with your AltIndex account. No API key is needed.

Claude and Claude Desktop

Use the remote MCP URL directly. Claude handles auth in the browser.

In Claude or Claude Desktop, go to Settings → Connectors → Add custom connector.
Set the name to altindex and paste this connector URL:

https://mcp.altindex.com

Claude will redirect you to AltIndex's OAuth page.
Sign in with your AltIndex account to grant access.

Claude Code

For the Claude Code terminal app only.

Add the AltIndex MCP server. Run this command in your terminal:

claude mcp add --transport http altindex https://mcp.altindex.com

Inside a Claude Code session, type /mcp to see available MCP servers. Select altindex from the list to trigger the OAuth flow.
A browser window will open. Sign in with your AltIndex account to complete the connection.

Cursor

Edit the MCP config file, then authenticate via OAuth.

In Cursor, go to Settings → Tools & MCP and click the edit icon to open mcp.json, or open it directly at ~/.cursor/mcp.json.
Add altindex to your mcpServers block. If you already have other servers, keep them.

{
  "mcpServers": {
    "altindex": {
      "url": "https://mcp.altindex.com"
    }
  }
}

Save and restart Cursor. Go to Settings → Tools & MCP. AltIndex should appear with a green dot.
Complete the OAuth sign-in when prompted.

ChatGPT

ChatGPT calls a custom MCP server a plugin. You add one in developer mode.

Go to Settings, then Security and login. Switch Developer mode on. ChatGPT marks it "Elevated risk"; that label applies to every custom plugin, not to AltIndex in particular.
Open Plugins in the sidebar. Click the + button at the top right. The New Plugin dialog opens.
Set Name to altindex. Keep Connection on Server URL and enter:

https://mcp.altindex.com

Keep Authentication on OAuth. Tick I understand and want to continue. Click Create.
ChatGPT opens a browser window. Sign in with your AltIndex account to grant access.

Connect with an API key

Use your Developer API key when you want market data in an assistant, or when you have no AltIndex Starter or Pro subscription. Get a key at app.altindex.com/developer (opens in a new tab).

A key gives you these six tools: resolve_security, search_market_universe, get_security_snapshot, get_security_signals, get_security_evidence and query_market_events. It does not give you get_portfolio_snapshot or get_watchlist_snapshot. Use the OAuth method above for your own portfolio and watchlist.

Each tool call counts against the same daily allowance as the REST API. Each rung also has its own limit on MCP calls a minute: the MCP calls per minute column of the plans table.

Claude Code

claude mcp add --transport http altindex https://mcp.altindex.com \
  --header "Authorization: Bearer YOUR_KEY"

Cursor

Add altindex to the mcpServers block in ~/.cursor/mcp.json:

{
  "mcpServers": {
    "altindex": {
      "url": "https://mcp.altindex.com",
      "headers": {
        "Authorization": "Bearer YOUR_KEY"
      }
    }
  }
}

Cursor lists seven tools for this server. Six are AltIndex tools. The seventh, mcp_auth, is a helper that Cursor adds to every MCP server; it is not part of the AltIndex API.

Claude (web, Team and Enterprise)

Go to Settings → Connectors → Add custom connector.
Set the URL to https://mcp.altindex.com.
Set Authentication to None.
Under Request headers, add the name Authorization and the value Bearer YOUR_KEY.

Type the word Bearer before your key. Claude sends the value exactly as you enter it, and the server refuses a value without it.

Request headers are a Claude beta. Anthropic makes this beta available to some organizations only. If you do not see the Request headers section, use the URL method below.

ChatGPT

ChatGPT sends the key as a header. Follow the ChatGPT steps in Get connected for developer mode and the New Plugin dialog, with two changes:

Set Authentication to Access token / API key. A Header scheme field appears. Keep it on Bearer.
Tick I understand and want to continue and click Create. A second dialog, Connect altindex, asks for the token. Paste your key on its own, without the word Bearer. ChatGPT adds the scheme. Click Connect altindex.

ChatGPT then lists the six tools.

Clients with no header field

A few clients accept only a URL. For these, put your key in the URL:

https://mcp.altindex.com/?apikey=YOUR_KEY

⚠️

This URL contains your key. Treat it as a password. Do not put it in a screenshot, a bug report, or a shared configuration file. If it leaks, rotate the key at app.altindex.com/developer (opens in a new tab).

A URL also passes through more logs than a header does, including logs we do not control. Use the header method when your client supports it. Claude Code, Cursor, Claude and ChatGPT all do.

Requirements

Each connection method has its own requirement.

OAuth: an AltIndex Starter ($29/mo) or Pro ($99/mo) subscription. Subscribe at altindex.com (opens in a new tab). No API key is needed. Each account can make 3,000 tool calls a day and 180 a minute, on Starter and Pro. search_market_universe has its own limit of 10 calls a minute. The daily limit resets at midnight UTC, and the minute limit resets at the start of each clock minute.
API key: the Developer rung or above. The Hobbyist rung does not include MCP. Compare the rungs (opens in a new tab).

API Reference Introduction