English Français العربية

Sentimatix

السجل الرسمي البحث والويب

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http sentimatix 'https://sentimatix-mcp.up.railway.app/mcp'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "sentimatix": {
            "type": "http",
            "url": "https://sentimatix-mcp.up.railway.app/mcp"
        }
    }
}
Remote (sse)
Claude Code 
claude mcp add --transport sse sentimatix 'https://sentimatix-mcp.up.railway.app/sse'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "sentimatix": {
            "type": "sse",
            "url": "https://sentimatix-mcp.up.railway.app/sse"
        }
    }
}
PYPI package sentimatix-mcp
Claude Code 
claude 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
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "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>"
            }
        }
    }
}

متغيرات البيئة

  • BACKEND_API_URL Base URL for the Sentimatix REST API. Defaults to the hosted production instance.
  • SENTIMATIX_API_KEY سري Optional API key for authenticated tier access. Leave blank for free tier.

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Sentimatix
  2. 🧩 What's Inside
  3. ⚡ Quick Start — MCP (Claude Desktop)
  4. 🛠️ MCP Tools
  5. 📡 REST API
  6. 🔗 Links

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

AppDescription
apps/apiFastAPI REST API — news, sentiment, entities, sector signals
apps/mcpMCP Server — 10 tools for AI agents (Claude Desktop, Cursor)
apps/dashboardNext.js developer portal & API key management
apps/streamlitStreamlit 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

ToolDescription
explain_price_changeWhy did a stock move? News + price + technicals
analyze_stock_enhancedDeep single-stock research report
compare_stocksSide-by-side comparison of two NSE stocks
get_news_sentimentArticles with NLP sentiment scores
get_sentiment_aggregateAggregated sentiment over 7d / 30d
get_technical_analysisRSI, MACD, Bollinger Bands
calculate_correlationPearson correlation between two stocks
get_rag_evidenceSemantic search over the news corpus

Full docs: apps/mcp/README.md

📡 REST API

Base URL: https://sentimatix-production.up.railway.app

EndpointDescription
GET /api/v1/newsFinancial news with sentiment labels
GET /api/v1/entitiesDirectory of all supported NSE stocks
GET /api/v1/sentimentAggregated sentiment scores per stock
GET /api/v1/sentiment/sectorsSector-level sentiment heatmap

Interactive docs: https://sentimatix-production.up.railway.app/docs

الأسئلة الشائعة

ما هو Sentimatix؟

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

كيف أثبّت Sentimatix؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http sentimatix 'https://sentimatix-mcp.up.railway.app/mcp'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Sentimatix إلى مفتاح API؟

نعم. يتطلب SENTIMATIX_API_KEY، وتضبطها في إعداداته.

هل Sentimatix مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون Sentimatix؟

ينشره Rishav0123. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.