SentiSense Logo
SentiSense
SentiSense Logo
SentiSense
Sign InGet Free API Key

MCP Connector

Connect SentiSense to Claude, Claude Code, Codex, ChatGPT, and Grok with one URL. Eleven read-only MCP tools: market mood, stock snapshots, the SentiSense Rating, news, analyst ratings, 13F flows, options intelligence, the earnings calendar, per-company financial statements, a stock/ETF screener, and the company knowledge graph.

Free + PRO (OAuth, no API key)11 tools
Python SDKNode SDK

Overview

The SentiSense MCP connector is a Model Context Protocol endpoint that lets AI apps like Claude, Claude Code, Codex, ChatGPT, and Grok pull SentiSense market intelligence directly into a conversation. Add it once and your assistant can answer questions about market mood, a stock's sentiment, market-moving news, analyst ratings, and institutional flows.

It is the third way into the same data graph that powers our REST API and the full app. Builders who need the complete surface use the API and the agent skill; the connector is a curated, read-only slice designed for chat.

Add the connector

The connector URL is:

https://app.sentisense.ai/mcp

Claude

  1. In Claude, open Customize, then Connectors.
  2. Choose Add custom connector, paste the URL above, and choose Add.
  3. Sign in with your SentiSense account and approve access.
  4. Start a chat and ask about a ticker or the market.

Custom connectors are available on Free (one custom connector), Pro and Max. On Team and Enterprise, an Owner adds them under Organization settings, then Connectors.

Claude Code

  1. From your project directory, register the connector as a local MCP server:
claude mcp add sentisense -- npx -y mcp-remote@0.1.38 https://app.sentisense.ai/mcp
  1. Start claude, approve the server when prompted, and sign in with your SentiSense account in the browser tab that opens.
  2. Ask about a ticker or the market; the agent picks the tool.

Walkthrough: how to add live market data to your Claude Code agent.

Codex

Codex is included in every ChatGPT plan, Free and Go included.

  1. From your terminal, register the connector and start the OAuth sign-in:
codex mcp add sentisense --url https://app.sentisense.ai/mcp
codex mcp login sentisense
  1. Sign in with your SentiSense account in the browser tab that opens and approve access.
  2. To add it from the Codex desktop app instead, open Plugins, then Manage, then MCP, then Add server. Choose URL and paste the connector URL above. Restart if prompted.
  3. The desktop app, CLI, and IDE extension share the same MCP configuration, so you only need to add the server once. Ask about a ticker or the market; Codex picks the tool.

Walkthrough: how to add live market data to your Codex agent.

ChatGPT

On ChatGPT Pro:

  1. Open Plugins and choose Create MCP App.
  2. Name it SentiSense, set the connection URL to the URL above, and choose OAuth as the authentication. Logo (optional): download ours and upload it.
  3. Sign in with your SentiSense account when asked and approve access.
  4. Ask your question in any chat.

OpenAI lists Pro, Plus, Business, Enterprise and Edu accounts as eligible for MCP apps on the web; on plans other than Pro, OpenAI's guide has you turn on Developer mode under Settings, Security and login first. Free and Go are not listed: use Codex, which is included in every ChatGPT plan.

Grok

  1. Open Connectors in Grok.
  2. Choose New Connector, then Custom, and paste the URL above.
  3. Sign in with your SentiSense account and approve access.
  4. Ask your question in any chat.

Grok calls anything outside its built-in catalog a custom connector, which is what the SentiSense endpoint is.

Grok Bot (pending verification)

Grok Bot, the xAI agent runtime, registers with its own private-scheme callback rather than a web one. We allowlisted that callback on 2026-09-04, so adding the connector URL should now work the same way it does in Grok. We have not yet confirmed a completed connection end to end, so treat this host as pending verification.

Menu labels shift between releases. In ChatGPT the area is "Plugins"; in Claude and Grok, "Connectors". In each, what you want is the option to add an app or connector by its URL.

Tools

Your AI selects the right tool for each question, so you ask in plain English rather than calling tools by name.

Tool What it answers
get_market_mood SentiSense's own fear and greed index: the proprietary 0 to 100 composite for the US market, its phase, and the signal components.
get_stock_snapshot Price plus the SentiSense sentiment, the SentiSense Score, and key stats for a single ticker.
get_rating The SentiSense Rating for a ticker and the composition behind it: the daily letter (A, B, C, D or F), its percentile among every stock rated that day, and the seven dimensions that produced it (crowd sentiment, smart money, options positioning, analysts, fundamentals, earnings, and technicals: where the price sits versus its own history), with the anomaly flags the run evaluated. It is an informational rank of the stocks we cover against each other on that day's cross section, not a recommendation. Recomputed once a night; not every stock is rated every day, and the tool says so when one is not.
get_news News for a stock or a topic. view=documents (default) returns the documents we track as publisher or X author, our derived sentiment and a link to the original, never the headline; ticker and query combine. view=stories returns SentiSense's curated story clusters, each with our own title and one-line summary, when it broke, how many sources it groups, aggregate sentiment and the tickers involved; search them by ticker, by a topic query such as fed decision or MCD traffic value menu, or both, over a lookback of up to 30 days. view=story with a story id returns one story's full narrative: summary, body, bull and bear views, timeline and source links (20 reads a month on FREE, unlimited on PRO, SentiSense Originals free for everyone).
get_analyst_ratings The buy, hold, and sell consensus and price targets for a ticker, one ticker's recent analyst moves, or market-wide rating changes (upgrades, downgrades, and coverage initiations, with reiteration noise filtered out). Tunable lookback window, row count, and direction filter, and every list leads with a shown-versus-total header so the AI knows how much more exists.
get_smart_money Institutional 13F holdings and flows: who is buying and who is selling.
get_options Options intelligence for a ticker (stock or ETF), ranked against its own history: options-implied sentiment, IV rank, put/call percentile, max pain, and, for PRO, 25-delta skew, the heaviest open-interest walls, and unusual contracts. Leave the ticker out for the market radar of the most active options today (stocks only; fetch ETFs by ticker). End-of-day chains, latest session.
get_earnings_calendar view=schedule (default): next earnings report for a ticker (date, timing, confirmation, fiscal quarter, consensus EPS), or the full week=last, week=this or week=next schedule for every tier, with Monday-to-Sunday bounds anchored on US Eastern time. view=ranked: which recent and upcoming reports matter most, with a 14-day lookback, 7-day forward window, resolved bounds, ranking version, shown/total, EPS surprise and distinct measured, provisional live, after-hours or pending readings; FREE sees up to 3 rows per section, PRO up to 12, and ticker/week apply only to schedule.
get_financials Reported income statement, balance sheet, and cash flow for a stock, per fiscal quarter or fiscal year, including margins and other derived ratios, up to 40 quarters or 20 years back. Also returns curated SentiSense company KPIs on PRO. These are reported actuals, not consensus estimates.
screen_stocks Screen and rank the tracked stock or ETF universe by SentiSense signals and market data. Sort by score, mentions, social dominance, market cap, price, change, volume, or 52-week distance, and filter with a compact list like score_7d > 10, market_cap < 10B, change_percent > 0. Call with no arguments for today's sentiment leaders and biggest movers.
entity_brief Who and what sits behind one stock, from the curated SentiSense knowledge graph: executives and founders with the relationship each one has to the company, products and the families they belong to, the companies tracked as peers, and organizations reached through a person. Every entity carries the handle that reads its SentiSense Score. One ticker per call; these are dated, hand-curated relationships, and the graph carries no sentiment or price data.

All eleven are read-only.

The server also advertises one utility tool, sentisense_health, a lightweight connection check. It is not a data tool and does not consume quota.

Tiers

The connector respects the tier of the SentiSense account you sign in with.

  • Free: 1,000 tool calls per month at up to 30 calls per minute. Tool calls share the same monthly quota as your REST API requests. Market Mood and news return full results; stock snapshots, smart money, options, the earnings calendar, and the screener return preview-depth data. Analyst ratings are generous on Free: the price-target band and the market-wide rating-changes feed are full data on every tier, with only the buy/hold/sell counts and deep per-ticker history reserved for PRO. For options, Free shows the headline readings and a short radar, while PRO adds skew, the open-interest walls, unusual contracts, and a longer radar. For the earnings calendar, Free sees the current week (a per-ticker next-report lookup is open to everyone), while PRO adds next week and the full forward window. For the screener, Free returns up to 10 ranked rows and PRO up to 50. For financials, the reported statements are full data on every tier; only the curated company KPIs section is PRO.
  • PRO: full data on every tool, no monthly cap, up to 300 calls per minute.
  • Pro Max and Data License: everything in PRO, at up to 1,500 (Pro Max) or 2,000 (Data License) calls per minute.

You start on whatever tier your account is on. Upgrading to PRO unlocks the full payload through the same connection, with no reconnecting.

How it relates to the REST API

The connector is the fastest way in, not the deepest. It is a read-only surface over the same data graph as the REST API. If you are building a product, an agent, or a dashboard, use the API directly and load the agent skill: you get the full endpoint set, typed SDKs for Python and Node, and direct control. The connector is for asking questions inside Claude, ChatGPT, and Grok.

Example prompts

  • "What's the market mood right now?"
  • "Give me a snapshot of NVDA with its SentiSense score and recent news."
  • "What do analysts think of TSLA, and what are the price targets?"
  • "Which institutions are buying and selling AAPL?"
  • "What's the options sentiment on NVDA, and is IV high right now?"
  • "What options are unusually active today?"
  • "Who reports earnings this week, and when does NVDA report?"
  • "Pull 10 years of annual revenue and free cash flow for AAPL."
  • "What stocks lead by sentiment today?"
  • "Find stocks under $10B market cap with rising sentiment."

Notes

  • Quotes are 15-minute delayed; sentiment, mood, and news are batch. Prices refresh continuously, while the sentiment reads, Market Mood, and news annotations are recomputed on a regular cadence.
  • Coverage spans the most-watched US stocks, not every ticker.
  • The connector provides market information for informational and educational purposes only. It is not investment advice.
  • Use of the MCP connector is governed by the API Terms of Service. Connecting and approving access constitutes acceptance.