Sentimatix README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Sentimatix listing page.
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:
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