Sentimatix
Real-time NSE/BSE stock sentiment, news NLP, technical analysis & RAG search via MCP.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http sentimatix 'https://sentimatix-mcp.up.railway.app/mcp'
{
"mcpServers": {
"sentimatix": {
"type": "http",
"url": "https://sentimatix-mcp.up.railway.app/mcp"
}
}
}
claude mcp add --transport sse sentimatix 'https://sentimatix-mcp.up.railway.app/sse'
{
"mcpServers": {
"sentimatix": {
"type": "sse",
"url": "https://sentimatix-mcp.up.railway.app/sse"
}
}
}
sentimatix-mcpclaude mcp add sentimatix -e 'BACKEND_API_URL=https://sentimatix-production.up.railway.app/api' -e 'SENTIMATIX_API_KEY=<your sentimatix_api_key>' -- uvx sentimatix-mcp==1.0.2
{
"mcpServers": {
"sentimatix": {
"command": "uvx",
"args": [
"sentimatix-mcp==1.0.2"
],
"env": {
"BACKEND_API_URL": "https://sentimatix-production.up.railway.app/api",
"SENTIMATIX_API_KEY": "<your sentimatix_api_key>"
}
}
}
}
Environment variables
BACKEND_API_URLBase URL for the Sentimatix REST API. Defaults to the hosted production instance.SENTIMATIX_API_KEYsecret Optional API key for authenticated tier access. Leave blank for free tier.
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
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
Frequently asked questions
What is Sentimatix?
Real-time NSE/BSE stock sentiment, news NLP, technical analysis & RAG search via MCP.
How do I install Sentimatix?
It runs as a remote server. In Claude Code: claude mcp add --transport http sentimatix 'https://sentimatix-mcp.up.railway.app/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Sentimatix need an API key?
Yes. It expects SENTIMATIX_API_KEY, which you set in its configuration.
Is Sentimatix open source?
Its code is public on GitHub, but the repository does not declare a standard license.
Who maintains Sentimatix?
It is published by Rishav0123. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.