English Français العربية

io.github.Top5StocksAPI/mcp-server

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

Daily AI-ranked stock, crypto, and macro research data from the Top 5 Stocks API.

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

التثبيت

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

NPM package top5stocks-mcp-server
Claude Code 
claude mcp add io-github-top5stocksapi-mcp-server -e 'TOP5STOCKS_API_KEY=<your top5stocks_api_key>' -- npx -y top5stocks-mcp-server@1.0.6
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-top5stocksapi-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "top5stocks-mcp-server@1.0.6"
            ],
            "env": {
                "TOP5STOCKS_API_KEY": "<your top5stocks_api_key>"
            }
        }
    }
}

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

  • TOP5STOCKS_API_KEY سري API key for starter/pro/ultra-tier tools. Free tools work without a key. Get a key at https://top5stocks.netlify.app/members.html

التوثيق

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

Top 5 Stocks MCP Server

Exposes the Top 5 Stocks API as MCP tools for Claude, Claude Code, Cursor, and other MCP-compatible agents.

Setup

npm install

Add to your MCP client config (e.g. Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "top5stocks": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"],
      "env": {
        "TOP5STOCKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

TOP5STOCKS_API_KEY is only required for starter/pro/ultra-tier tools. Free tools (get_daily_watchlist_free, get_crypto_watchlist_free, cumulative-performance endpoints, get_api_metadata) work with no key.

Get a key at https://top5stocks.netlify.app/members.html

Or once published, run directly via npx (no local clone needed):

{
  "mcpServers": {
    "top5stocks": {
      "command": "npx",
      "args": ["-y", "top5stocks-mcp-server"],
      "env": {
        "TOP5STOCKS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tools

Each tool maps 1:1 to an API endpoint (see index.js ENDPOINTS for the full list and plan requirements). All responses are raw JSON text from the live API.

Educational market research only — not financial advice.

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

ما هو io.github.Top5StocksAPI/mcp-server؟

Daily AI-ranked stock, crypto, and macro research data from the Top 5 Stocks API.

كيف أثبّت io.github.Top5StocksAPI/mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add io-github-top5stocksapi-mcp-server -e 'TOP5STOCKS_API_KEY=<your top5stocks_api_key>' -- npx -y top5stocks-mcp-server@1.0.6. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.Top5StocksAPI/mcp-server إلى مفتاح API؟

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

هل io.github.Top5StocksAPI/mcp-server مفتوح المصدر؟

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

من يصون io.github.Top5StocksAPI/mcp-server؟

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

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