English Français العربية

io.github.tickerbot/mcp-server

السجل الرسمي البيانات وقواعدها

The stock market, in SQL — scan, replay, or subscribe across ~12k US tickers and top 100 cryptos.

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

التثبيت

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

Remote (streamable-http)
Claude Code 
claude mcp add --transport http io-github-tickerbot-mcp-server 'https://api.tickerbot.io/mcp' --header 'Authorization: <Bearer <TICKERBOT_API_KEY>>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-tickerbot-mcp-server": {
            "type": "http",
            "url": "https://api.tickerbot.io/mcp",
            "headers": {
                "Authorization": "<Bearer <TICKERBOT_API_KEY>>"
            }
        }
    }
}
NPM package @tickerbot/mcp-server
Claude Code 
claude mcp add io-github-tickerbot-mcp-server -e 'TICKERBOT_API_KEY=<your tickerbot_api_key>' -- npx -y @tickerbot/mcp-server@0.1.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "io-github-tickerbot-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@tickerbot/mcp-server@0.1.3"
            ],
            "env": {
                "TICKERBOT_API_KEY": "<your tickerbot_api_key>"
            }
        }
    }
}

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

  • TICKERBOT_API_KEY إلزامي سري Tickerbot API key (tb_live_… or tb_test_…). Get one at https://tickerbot.io/dashboard.

التوثيق

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

المحتويات
  1. @tickerbot/mcp-server
  2. Install
  3. Tools
  4. Examples
  5. Configuration
  6. Remote install
  7. License

@tickerbot/mcp-server

Model Context Protocol server for Tickerbot — the stock market, in SQL. Install in Claude, Cursor, VS Code Copilot, and other MCP-compatible clients to scan ~14,500 US-listed equities plus a curated set of rates, FX and crypto series, replay any day, or subscribe a query — across 421+ signal columns.

Install

You need a Tickerbot API key. Get one from your dashboard.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "tickerbot": {
      "command": "npx",
      "args": ["-y", "@tickerbot/mcp-server"],
      "env": {
        "TICKERBOT_API_KEY": "tb_live_..."
      }
    }
  }
}

Restart Claude Desktop.

Claude Code
claude mcp add tickerbot --env TICKERBOT_API_KEY=tb_live_... -- npx -y @tickerbot/mcp-server
Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "tickerbot": {
      "command": "npx",
      "args": ["-y", "@tickerbot/mcp-server"],
      "env": { "TICKERBOT_API_KEY": "tb_live_..." }
    }
  }
}
VS Code (Copilot)

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

{
  "servers": {
    "tickerbot": {
      "command": "npx",
      "args": ["-y", "@tickerbot/mcp-server"],
      "env": { "TICKERBOT_API_KEY": "tb_live_..." }
    }
  }
}

Tools

19 tools covering tickers, signals, scans, universes, news, and webhook subscriptions.

ToolEndpoint
tickerbot_list_tickersGET /v2/tickers
tickerbot_get_tickerGET /v2/tickers/{ticker}
tickerbot_get_ticker_historyGET /v2/tickers/{ticker}/history
tickerbot_get_ticker_eventsGET /v2/tickers/{ticker}/events
tickerbot_list_signals_catalogGET /v2/signals
tickerbot_get_signals_matchGET /v2/signals/{signal}
tickerbot_get_signal_historyGET /v2/signals/{signal}/{ticker}/history/{interval}
tickerbot_list_signal_eventsGET /v2/signals/{signal}/{ticker}/events
tickerbot_scanGET /v2/scan (live or asof)
tickerbot_list_universesGET /v2/universes
tickerbot_get_universeGET /v2/universes/{id}
tickerbot_create_universePOST /v2/universes
tickerbot_create_custom_signalPOST /v2/signals
tickerbot_search_newsGET /v2/news/scan
tickerbot_subscribe_scanPOST /v2/scan/subscribe
tickerbot_subscribe_signalPOST /v2/signals/{signal}/subscribe
tickerbot_subscribe_tickerPOST /v2/tickers/{ticker}/subscribe
tickerbot_list_webhooksGET /v2/webhooks
tickerbot_delete_webhookDELETE /v2/webhooks/{id}

Strategies are not exposed via MCP — see the REST API docs for those.

Examples

Open Claude and try:

"Find oversold semiconductor stocks bouncing on volume."

"What's NVDA's RSI and short interest right now?"

"How often has the gap-up + small-cap + high-RVOL setup hit over the last 30 days?"

"Save a signal called oversold_with_volume defined as rsi_14 < 30 AND volume_ratio_20d > 2."

Configuration

Env varDefaultPurpose
TICKERBOT_API_KEY(required)Your API key. Sent as Authorization: Bearer <key> on every call.
TICKERBOT_API_URLhttps://api.tickerbot.ioOverride the API base URL (for staging or self-hosted).

Remote install

For consumer chat apps (Claude.ai web/mobile, ChatGPT) that don't run subprocesses, use the hosted remote MCP endpoint at https://mcp.tickerbot.io instead. See tickerbot.io/mcp-server for setup.

License

MIT

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

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

The stock market, in SQL — scan, replay, or subscribe across ~12k US tickers and top 100 cryptos.

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

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http io-github-tickerbot-mcp-server 'https://api.tickerbot.io/mcp' --header 'Authorization: <Bearer <TICKERBOT_API_KEY>>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

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

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

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

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

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

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

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