{
  "markdown": "# Sentimatix\n\n[![smithery badge](https://smithery.ai/badge/rishavdutta-kgp/sentimatix)](https://smithery.ai/servers/rishavdutta-kgp/sentimatix)\n\n**Real-time Indian stock market sentiment intelligence for AI agents and retail traders.**\n\nSentimatix 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.\n\n---\n\n## 🧩 What's Inside\n\n| App | Description |\n|-----|-------------|\n| [`apps/api`](apps/api) | FastAPI REST API — news, sentiment, entities, sector signals |\n| [`apps/mcp`](apps/mcp) | MCP Server — 10 tools for AI agents (Claude Desktop, Cursor) |\n| [`apps/dashboard`](apps/dashboard) | Next.js developer portal & API key management |\n| [`apps/streamlit`](apps/streamlit) | Streamlit analytics dashboard |\n| [`workers/`](workers) | Background NLP pipeline — sentiment scoring, stock price sync |\n\n---\n\n## ⚡ Quick Start — MCP (Claude Desktop)\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"sentimatix\": {\n      \"command\": \"python\",\n      \"args\": [\"path/to/apps/mcp/mcp_stdio.py\"],\n      \"env\": {\n        \"BACKEND_API_URL\": \"https://sentimatix-production.up.railway.app/api\"\n      }\n    }\n  }\n}\n```\n\nNo API key required for the free tier.\n\n---\n\n## 🛠️ MCP Tools\n\n| Tool | Description |\n|------|-------------|\n| `explain_price_change` | Why did a stock move? News + price + technicals |\n| `analyze_stock_enhanced` | Deep single-stock research report |\n| `compare_stocks` | Side-by-side comparison of two NSE stocks |\n| `get_news_sentiment` | Articles with NLP sentiment scores |\n| `get_sentiment_aggregate` | Aggregated sentiment over 7d / 30d |\n| `get_technical_analysis` | RSI, MACD, Bollinger Bands |\n| `calculate_correlation` | Pearson correlation between two stocks |\n| `get_rag_evidence` | Semantic search over the news corpus |\n\nFull docs: [`apps/mcp/README.md`](apps/mcp/README.md)\n\n---\n\n## 📡 REST API\n\nBase URL: `https://sentimatix-production.up.railway.app`\n\n| Endpoint | Description |\n|----------|-------------|\n| `GET /api/v1/news` | Financial news with sentiment labels |\n| `GET /api/v1/entities` | Directory of all supported NSE stocks |\n| `GET /api/v1/sentiment` | Aggregated sentiment scores per stock |\n| `GET /api/v1/sentiment/sectors` | Sector-level sentiment heatmap |\n\nInteractive docs: [https://sentimatix-production.up.railway.app/docs](https://sentimatix-production.up.railway.app/docs)\n\n---\n\n## 🔗 Links\n\n- [Smithery Registry](https://smithery.ai/servers/rishavdutta-kgp/sentimatix)\n- [API Reference](https://sentimatix-production.up.railway.app/docs)\n- [Developer Portal](https://sentimatix-production.up.railway.app)\n",
  "bytes": 2700,
  "sha": "dd2b51f92526d5d4ccce1082dcccf0238bff5a4e416ce297ca9331c1a10a143b",
  "repo_slug": "rishav0123/sentimatix",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_rishav0123_sentimatix_72d02f3c/readme"
}