Sentimatix

io.github.Rishav0123Published by GitHub account Rishav0123v1.0.2Updated Oct 24, 2026

Real-time NSE/BSE stock sentiment, news NLP, technical analysis & RAG search via MCP.

VerifiedStreamable HTTPWeb executableFinanceKnowledge & MemoryData & Analytics

Overview

AI-generated overview

Sentimatix gives an AI assistant live Indian stock market intelligence: NSE/BSE prices, news sentiment, technical indicators and RAG evidence search.

What you can do
  • Retrieve price data: stock summaries with change, high, low and volume, plus daily OHLCV history
  • Read news sentiment: articles with NLP scores and aggregated sentiment stats over a period
  • Run technical analysis: RSI, MACD, Bollinger Bands and support/resistance levels
  • Compare and correlate: side-by-side comparison of two NSE stocks and Pearson correlation between them
  • Explain moves and research: an orchestrator that explains why a stock moved, deep single-stock reports, and semantic search over the news corpus
When to use it
Useful when you want an assistant to answer questions about Indian listed stocks, such as why a stock moved, how two tickers compare, or what recent news sentiment and technical indicators say. It suits research and analysis workflows rather than order execution.
Requirements
Runs as a hosted remote endpoint or locally via uvx from the sentimatix-mcp PyPI package. A free API key from the provider's portal is needed; set it in SENTIMATIX_API_KEY, and optionally point BACKEND_API_URL at the REST API (defaults to the hosted instance). The README also lists SUPABASE_URL, SUPABASE_KEY and OPENAI_API_KEY for RAG and AI synthesis features.
Before you install
The API key is a credential and must be kept private. The README mentions additional secrets (SUPABASE_KEY, OPENAI_API_KEY) for some features. Queries and tickers are sent to the provider's hosted backend and its news/vector sources, so treat research questions as shared with a third party. Data is informational market intelligence, not investment advice.

Installation

In SourceWeft

  1. Open Sentimatix in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Rishav0123%2Fsentimatix/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "sentimatix": {
      "type": "http",
      "url": "https://sentimatix-mcp.up.railway.app/mcp"
    }
  }
}

README

Sentimatix MCP Server

[smithery badge]

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)

ToolDescriptionExample
explain_price_changeOrchestrator — explains why a stock moved using price, news + sentiment(RELIANCE, 7 days)
analyze_stock_enhancedDeep single-stock research report(HDFCBANK, detailed)
compare_stocksSide-by-side comparison of two NSE stocks(TCS vs INFY)
get_stock_summaryPrice metrics: change%, high, low, volume(TATAMOTORS, 7 days)
get_historical_pricesDaily OHLCV time-series data(SBIN, 2024-01-01, 2024-03-01)
get_news_sentimentNews articles with NLP sentiment scores(ZOMATO, last 7 days)
get_sentiment_aggregateAggregated sentiment stats for a period(ADANIENT, 30 days)
get_technical_analysisRSI, MACD, Bollinger Bands, support/resistance(ITC, 90 days)
calculate_correlationPearson correlation between two NSE stocks(RELIANCE, TCS)
get_rag_evidenceSemantic search over the news corpus(INFY, "earnings beat")

🚀 Quick Start (Claude Desktop)

  1. Get a free API key at: https://sentimatix-production.up.railway.app/portal
  2. Add this to your claude_desktop_config.json:
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:

  1. ✅ get_stock_summary("RELIANCE", 7) → -3.1% decline
  2. ✅ get_news_sentiment("RELIANCE", ...) → 12 news items, avg sentiment: -0.4
  3. ✅ get_rag_evidence("RELIANCE", "price drop reasons") → 5 relevant articles
  4. ✅ get_technical_analysis("RELIANCE") → RSI: 38 (Oversold), MACD: Bearish
  5. 🤖 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

bash
BACKEND_API_URL=https://sentimatix-production.up.railway.app/apiSUPABASE_URL=https://your-project.supabase.co       # For RAG featuresSUPABASE_KEY=your_anon_key                           # For RAG featuresOPENAI_API_KEY=your_openai_key                       # For AI synthesis

📚 Full Documentation

Source: apps/mcp/README.md at commit ebbe855

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.