What can you do with Sentimatix?

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

🔗 Links

Install

Add Sentimatix to your client. Pick the one you use.

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

Add to `.vscode/mcp.json` in your workspace.

claude mcp add sentimatix-mcp -- uvx sentimatix-mcp

codex mcp add sentimatix-mcp -- uvx sentimatix-mcp

amp mcp add sentimatix-mcp -- uvx sentimatix-mcp

{
  "mcpServers": {
    "sentimatix-mcp": {
      "command": "uvx",
      "args": [
        "sentimatix-mcp"
      ]
    }
  }
}

Add to `claude_desktop_config.json`, then restart Claude Desktop.

{
  "mcpServers": {
    "sentimatix-mcp": {
      "command": "uvx",
      "args": [
        "sentimatix-mcp"
      ]
    }
  }
}

Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.

{
  "mcpServers": {
    "sentimatix-mcp": {
      "command": "uvx",
      "args": [
        "sentimatix-mcp"
      ]
    }
  }
}

Add to `~/.codeium/windsurf/mcp_config.json`.

{
  "mcpServers": {
    "sentimatix-mcp": {
      "command": "uvx",
      "args": [
        "sentimatix-mcp"
      ]
    }
  }
}

Add to `cline_mcp_settings.json` via the MCP Servers panel.

{
  "mcpServers": {
    "sentimatix-mcp": {
      "command": "uvx",
      "args": [
        "sentimatix-mcp"
      ]
    }
  }
}

Add to `~/.gemini/settings.json`.

{
  "mcpServers": {
    "sentimatix-mcp": {
      "type": "local",
      "command": "uvx",
      "args": [
        "sentimatix-mcp"
      ],
      "tools": [
        "*"
      ]
    }
  }
}

Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.

{
  "context_servers": {
    "sentimatix-mcp": {
      "command": {
        "path": "uvx",
        "args": [
          "sentimatix-mcp"
        ]
      }
    }
  }
}

Add to your Zed `settings.json`.

uvx sentimatix-mcp

Run `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.

Score

39 / 100

Incomplete

Documentation22/25
Maintenance16/25
Trust6/20
Capability0/15
Install experience15/15

Documents what it does and how to connect
Has a resolvable package or endpoint
Exposes at least one tool, prompt or resource
README has substantive content
Includes a code example
Documents its configuration
Mentions credentials or security posture
Last commit 67 days ago
Has a release history
Repository is not archived
No licence detected
Namespace verified in the official MCP registry
Claimed by its owner
Published under an organisation
0 tool(s) documented
Provides prompt templates
Provides resources
18 documented install method(s)
Published to a package registry
Offers a hosted endpoint — no local install

Read the full rubric →

Version history

Versions	Published
1.0.2Latest	May 15, 2026