Sentimatix MCP Server

Real-time Indian stock market intelligence via the Model Context Protocol (MCP). Plug Sentimatix directly into Claude Desktop, Cursor, or any MCP-compatible AI agent to get live NSE/BSE sentiment, news, and technical analysis.

🏗️ Architecture

User Query → Claude/AI Agent → MCP Server → Tools
                                   ↓
                              ┌─────────────────────┐
                              │ News Sentiment API  │ ← Sentimatix /api/v1/news
                              │ Stock Price API     │ ← Sentimatix /api/v1/stocks
                              │ Sector Sentiment    │ ← Sentimatix /api/v1/sentiment
                              │ RAG Evidence        │ ← Supabase Vector DB
                              └─────────────────────┘
                                   ↓
                              Synthesized Market Intelligence

🛠️ Available Tools (10 total)

Tool	Description	Example
`explain_price_change`	Orchestrator — explains why a stock moved using price, news + sentiment	`(RELIANCE, 7 days)`
`analyze_stock_enhanced`	Deep single-stock research report	`(HDFCBANK, detailed)`
`compare_stocks`	Side-by-side comparison of two NSE stocks	`(TCS vs INFY)`
`get_stock_summary`	Price metrics: change%, high, low, volume	`(TATAMOTORS, 7 days)`
`get_historical_prices`	Daily OHLCV time-series data	`(SBIN, 2024-01-01, 2024-03-01)`
`get_news_sentiment`	News articles with NLP sentiment scores	`(ZOMATO, last 7 days)`
`get_sentiment_aggregate`	Aggregated sentiment stats for a period	`(ADANIENT, 30 days)`
`get_technical_analysis`	RSI, MACD, Bollinger Bands, support/resistance	`(ITC, 90 days)`
`calculate_correlation`	Pearson correlation between two NSE stocks	`(RELIANCE, TCS)`
`get_rag_evidence`	Semantic search over the news corpus	`(INFY, "earnings beat")`

🚀 Quick Start (Claude Desktop)

Get a free API key at: https://sentimatix-production.up.railway.app/portal
Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "sentimatix": {
      "command": "uvx",
      "args": ["sentimatix-mcp"],
      "env": {
        "BACKEND_API_URL": "https://sentimatix-production.up.railway.app/api",
        "SENTIMATIX_API_KEY": "your_key_here"
      }
    }
  }
}

📊 Example Query Flow

User: "Why did Reliance drop in the last 7 days?"

MCP Workflow:

✅ get_stock_summary("RELIANCE", 7) → -3.1% decline
✅ get_news_sentiment("RELIANCE", ...) → 12 news items, avg sentiment: -0.4
✅ get_rag_evidence("RELIANCE", "price drop reasons") → 5 relevant articles
✅ get_technical_analysis("RELIANCE") → RSI: 38 (Oversold), MACD: Bearish
🤖 LLM Synthesis:

RELIANCE declined 3.1% (₹2,850 → ₹2,762) over the last 7 days.

Top Reasons (with evidence):
1. Weak Q4 refining margins — reported by Economic Times (sentiment: -0.5)
2. Sector-wide FII selling in Oil & Gas — MoneyControl (sentiment: -0.3)
3. RSI at 38 confirms oversold territory; key support at ₹2,740

Confidence: HIGH

🔧 Environment Variables

BACKEND_API_URL=https://sentimatix-production.up.railway.app/api
SUPABASE_URL=https://your-project.supabase.co       # For RAG features
SUPABASE_KEY=your_anon_key                           # For RAG features
OPENAI_API_KEY=your_openai_key                       # For AI synthesis

📚 Full Documentation

Connection Guide — Claude Desktop, Cursor setup
Quick Start — Step-by-step installation
REST API Docs — Full OpenAPI reference