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