MCP Connector | SentiSense API Documentation

Overview

The SentiSense MCP connector is a Model Context Protocol endpoint that lets AI apps like Claude and ChatGPT 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.

What it is: five read-only tools, exposed over MCP. No trading, no account changes, no writes.
Auth: zero-config OAuth. There is no API key to paste. You sign in with your SentiSense account inside the AI app and approve access, and the connection is remembered.
Hosts: Claude and ChatGPT, both supported and verified.

Add the connector

The connector URL is:

https://app.sentisense.ai/mcp

Claude

In Claude, open Settings, then Connectors.
Add a custom connector and paste the URL above.
Sign in with your SentiSense account and approve access.
Start a chat and ask about a ticker or the market.

ChatGPT

In ChatGPT, turn on developer mode under Settings, then Connectors. This is what lets you add a connector by URL.
Add a connector and paste the same URL.
Sign in with your SentiSense account and approve access.
Ask your question in any chat.

The exact menu labels shift between releases; look for "Connectors" and an option to add one by 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`	The proprietary 0 to 100 fear-to-greed 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 ticker.
`get_news`	Recent, sentiment-tagged market-moving news for a ticker, each with a link to the source.
`get_analyst_ratings`	The buy, hold, and sell consensus and price targets for a ticker.
`get_smart_money`	Institutional 13F holdings and flows: who is buying and who is selling.

All five 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, analyst ratings, and smart money return preview-depth data.
PRO: full data on every tool, no monthly cap, up to 300 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 and ChatGPT.

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?"

Notes

Quotes are real-time; sentiment, mood, and news are batch. Prices update live, but 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.