Summary
Brings Indian stock market intelligence into Claude via 10 MCP tools that combine live NSE/BSE news, NLP sentiment scoring, and technical indicators. You get tools like explain_price_change (why did a stock move today), analyze_stock_enhanced (full research report), and get_rag_evidence (semantic search over the news corpus). The backend REST API aggregates sentiment at both stock and sector levels, pulls price data, and calculates technicals like RSI and MACD. Runs locally via stdio or connects to hosted endpoints at sentimatix-mcp.up.railway.app. Useful if you're building trading workflows in Claude and want real-time context on what's moving Indian markets and why.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
10 tools
explain_price_changeAnalyzes and explains the driving factors behind an NSE stock's price movement over a specific timeframe. It synthesizes recent financial news, entity-level sentiment scores, and technical indicators to provide a comprehensive narrative of market behavior.3 params
Analyzes and explains the driving factors behind an NSE stock's price movement over a specific timeframe. It synthesizes recent financial news, entity-level sentiment scores, and technical indicators to provide a comprehensive narrative of market behavior.
Parameters* required
end_datestringThe end date of the analysis period in YYYY-MM-DD format.
start_datestringThe start date of the analysis period in YYYY-MM-DD format.
symbolstringThe stock ticker symbol on the National Stock Exchange of India (e.g., RELIANCE, TCS).
analyze_stock_enhancedGenerates a deep, AI-driven single-stock research report. Combines historical price data, moving averages, and news sentiment into a structured analysis to evaluate the overall health and momentum of the equity.3 params
Generates a deep, AI-driven single-stock research report. Combines historical price data, moving averages, and news sentiment into a structured analysis to evaluate the overall health and momentum of the equity.
Parameters* required
end_datestringThe end date for data collection in YYYY-MM-DD format.
start_datestringThe start date for data collection in YYYY-MM-DD format.
symbolstringThe stock ticker symbol on the National Stock Exchange of India (e.g., INFY, HDFCBANK).
compare_stocksPerforms a side-by-side quantitative and qualitative comparison of two NSE stocks. Useful for pair trading analysis or sector peer evaluation based on price performance and media sentiment.4 params
Performs a side-by-side quantitative and qualitative comparison of two NSE stocks. Useful for pair trading analysis or sector peer evaluation based on price performance and media sentiment.
Parameters* required
end_datestringThe end date in YYYY-MM-DD format.
start_datestringThe start date in YYYY-MM-DD format.
symbol1stringThe primary stock ticker symbol (e.g., TATAMOTORS).
symbol2stringThe secondary stock ticker symbol for comparison (e.g., MARUTI).
get_stock_summaryFetches fundamental price metrics and recent performance summaries for an NSE-listed stock. Returns the latest closing price, percentage change, daily high/low, and trading volume.2 params
Fetches fundamental price metrics and recent performance summaries for an NSE-listed stock. Returns the latest closing price, percentage change, daily high/low, and trading volume.
Parameters* required
period_daysintegerThe number of days to look back for the summary metrics (e.g., 7, 30, 90).
symbolstringThe NSE stock ticker symbol.
get_historical_pricesRetrieves the daily Open, High, Low, Close, and Volume (OHLCV) time-series data for an Indian equity. Essential for charting and custom technical analysis.3 params
Retrieves the daily Open, High, Low, Close, and Volume (OHLCV) time-series data for an Indian equity. Essential for charting and custom technical analysis.
Parameters* required
end_datestringEnd date (YYYY-MM-DD).
start_datestringStart date (YYYY-MM-DD).
symbolstringThe NSE stock ticker symbol.
get_news_sentimentFetches recent financial news articles specifically mentioning the target Indian stock, complete with proprietary NLP sentiment scores (ranging from strongly negative to strongly positive) for each article.3 params
Fetches recent financial news articles specifically mentioning the target Indian stock, complete with proprietary NLP sentiment scores (ranging from strongly negative to strongly positive) for each article.
Parameters* required
end_datestringEnd date (YYYY-MM-DD).
start_datestringStart date (YYYY-MM-DD).
symbolstringThe NSE stock ticker symbol.
get_sentiment_aggregateCalculates the aggregated market mood and sentiment statistics for an NSE stock over a specified period. Useful for tracking sentiment shifts over time.3 params
Calculates the aggregated market mood and sentiment statistics for an NSE stock over a specified period. Useful for tracking sentiment shifts over time.
Parameters* required
end_datestringEnd date (YYYY-MM-DD).
start_datestringStart date (YYYY-MM-DD).
symbolstringThe NSE stock ticker symbol.
get_technical_analysisCalculates and returns key technical indicators for an NSE stock, including Relative Strength Index (RSI), Moving Average Convergence Divergence (MACD), Bollinger Bands, and support/resistance levels.2 params
Calculates and returns key technical indicators for an NSE stock, including Relative Strength Index (RSI), Moving Average Convergence Divergence (MACD), Bollinger Bands, and support/resistance levels.
Parameters* required
period_daysintegerThe lookback period in days for calculating the indicators (standard is 14 for RSI).
symbolstringThe NSE stock ticker symbol.
calculate_correlationComputes the Pearson correlation coefficient between the daily returns of two NSE stocks over a specific period to measure their statistical relationship.4 params
Computes the Pearson correlation coefficient between the daily returns of two NSE stocks over a specific period to measure their statistical relationship.
Parameters* required
end_datestringEnd date (YYYY-MM-DD).
start_datestringStart date (YYYY-MM-DD).
symbol1stringFirst NSE stock ticker symbol.
symbol2stringSecond NSE stock ticker symbol.
get_rag_evidencePerforms a semantic search over the Sentimatix financial news corpus. Retrieves specific quotes and evidence related to a query for a particular NSE stock to ground AI responses in factual reporting.2 params
Performs a semantic search over the Sentimatix financial news corpus. Retrieves specific quotes and evidence related to a query for a particular NSE stock to ground AI responses in factual reporting.
Parameters* required
querystringThe natural language question or topic to search the news corpus for (e.g., 'Q3 earnings report results').
symbolstringThe NSE stock ticker symbol.
Sentimatix
Real-time Indian stock market sentiment intelligence for AI agents and retail traders.
Sentimatix provides live NSE/BSE news sentiment, aggregated stock & sector signals, and a Model Context Protocol (MCP) server that plugs directly into Claude, Cursor, and other AI agents.
🧩 What's Inside
| App | Description |
|---|---|
apps/api | FastAPI REST API — news, sentiment, entities, sector signals |
apps/mcp | MCP Server — 10 tools for AI agents (Claude Desktop, Cursor) |
apps/dashboard | Next.js developer portal & API key management |
apps/streamlit | Streamlit analytics dashboard |
workers/ | Background NLP pipeline — sentiment scoring, stock price sync |
⚡ Quick Start — MCP (Claude Desktop)
Add to your claude_desktop_config.json:
{
"mcpServers": {
"sentimatix": {
"command": "python",
"args": ["path/to/apps/mcp/mcp_stdio.py"],
"env": {
"BACKEND_API_URL": "https://sentimatix-production.up.railway.app/api"
}
}
}
}
No API key required for the free tier.
🛠️ MCP Tools
| Tool | Description |
|---|---|
explain_price_change | Why did a stock move? News + price + technicals |
analyze_stock_enhanced | Deep single-stock research report |
compare_stocks | Side-by-side comparison of two NSE stocks |
get_news_sentiment | Articles with NLP sentiment scores |
get_sentiment_aggregate | Aggregated sentiment over 7d / 30d |
get_technical_analysis | RSI, MACD, Bollinger Bands |
calculate_correlation | Pearson correlation between two stocks |
get_rag_evidence | Semantic search over the news corpus |
Full docs: apps/mcp/README.md
📡 REST API
Base URL: https://sentimatix-production.up.railway.app
| Endpoint | Description |
|---|---|
GET /api/v1/news | Financial news with sentiment labels |
GET /api/v1/entities | Directory of all supported NSE stocks |
GET /api/v1/sentiment | Aggregated sentiment scores per stock |
GET /api/v1/sentiment/sectors | Sector-level sentiment heatmap |
Interactive docs: https://sentimatix-production.up.railway.app/docs
🔗 Links
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
BACKEND_API_URLdefault: https://sentimatix-production.up.railway.app/apiBase URL for the Sentimatix REST API. Defaults to the hosted production instance.
SENTIMATIX_API_KEYsecretOptional API key for authenticated tier access. Leave blank for free tier.
Categories
Registryactive
Packagesentimatix-mcp
TransportSTDIO, HTTP, SSE
AuthRequired
UpdatedMay 15, 2026
