Skip to content
MCP server

Tickerbot

MCP server giving AI clients SQL-style stock screening across US equities and crypto

Install

Tickerbot is an open-source MCP server for stock market data. It can run locally on your machine or as a hosted remote server.

Pricing
Open source
Platforms
API, CLI, Web
Runs
Locally or Remotely
Version
0.1.3
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add --transport http mcp-server https://api.tickerbot.io/mcp

Add to Settings → Connectors → Add custom connector

https://api.tickerbot.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "https://api.tickerbot.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://api.tickerbot.io/mcp"
    }
  }
}

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

{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://api.tickerbot.io/mcp"
    }
  }
}

Add to Grok Bot desktop app → Connect apps → Add a custom connector

https://api.tickerbot.io/mcp

Enter a Name (for example "Tickerbot"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

Full Grok Bot setup guide

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://api.tickerbot.io/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • TICKERBOT_API_KEYTickerbot API key (tb_live_… or tb_test_…). Get one at https://tickerbot.io/dashboard.Required

About Tickerbot

The README describes this package as a thin stdio bridge: it reads the tool list from Tickerbot's hosted MCP endpoint using your API key and forwards every tool call there, so new tools on the hosted side reach clients without a package update. The hosted server can also be added directly by URL in clients that support remote MCP servers, with OAuth sign-in.

Once connected, an agent can run market scans, replay past days, look up individual tickers, bars, history and ETF holdings, query market events and news, and manage custom signals, saved universes and webhook subscriptions. The docs say each tool maps to one REST endpoint with the same parameters.

It suits developers and analysts who already use Claude, ChatGPT, Cursor, VS Code Copilot or similar clients and want market data available inside those chats or coding agents. Access requires a Tickerbot API key, and the tool calls go to the vendor's hosted service.

Tools this server provides (32)

Taken from the project documentation; the running server may differ.

tickerbot_scan
Run a stock market scan.
tickerbot_subscribe_scan
Subscribe to a scan.
tickerbot_list_signals
List available signals.
tickerbot_get_signal
Get a signal.
tickerbot_create_custom_signal
Create a custom signal.
tickerbot_update_custom_signal
Update a custom signal.
tickerbot_delete_custom_signal
Delete a custom signal.
tickerbot_subscribe_signal
Subscribe to a signal.
tickerbot_list_tickers
List tickers.
tickerbot_get_ticker
Get a ticker.
tickerbot_get_history
Get ticker history.
tickerbot_subscribe_ticker
Subscribe to a ticker.
tickerbot_get_bars
Get price bars for a ticker.
tickerbot_get_ticker_coverage
Get ticker coverage.
tickerbot_get_etf_holdings
Get ETF holdings.
tickerbot_query_events
Query market events.
tickerbot_list_event_kinds
List event kinds.
tickerbot_subscribe_events
Subscribe to events.
tickerbot_query_news
Query news.
tickerbot_subscribe_news
Subscribe to news.
tickerbot_list_universes
List universes.
tickerbot_get_universe
Get a universe.
tickerbot_create_universe
Create a universe.
tickerbot_update_universe
Update a universe.
tickerbot_delete_universe
Delete a universe.
tickerbot_list_webhooks
List webhooks.
tickerbot_get_webhook
Get a webhook.
tickerbot_update_webhook
Update a webhook.
tickerbot_delete_webhook
Delete a webhook.
tickerbot_test_webhook
Send a test webhook.
tickerbot_list_webhook_deliveries
List webhook deliveries.
tickerbot_redeliver_webhook_delivery
Redeliver a webhook delivery.

What it does

Market scanning tools
Run stock screens and subscribe to scan results from inside an MCP client.
Custom signal management
Create, update and delete custom signals defined over the platform's indicator columns.
Ticker data and history
Fetch ticker state, historical series, bars, coverage and ETF holdings.
Events and news queries
Query market events by kind and search or subscribe to news feeds.
Webhook management
List, update, test and redeliver webhook subscriptions and their deliveries.
Multiple install paths
Connect via hosted URL with OAuth or run the npm stdio bridge with an API key.

Good for

  • Asking an AI assistant to find stocks matching technical conditions
  • Checking indicators, short interest or history for a specific ticker mid-conversation
  • Saving a reusable signal definition and reviewing how often it fired
  • Building an agent loop that pulls screened tickers into downstream analysis
  • Setting up webhook alerts for scan or event results

Pricing

Open source

MCP bridge is MIT-licensed; the hosted Tickerbot API requires an API key from the dashboard.

Prices change. Check tickerbot.io before you buy.

Tickerbot FAQ

Do I need an API key to use the npm package?

Yes. The README says TICKERBOT_API_KEY is required and is sent as a bearer token to the hosted server.

Can I connect without installing the package?

The README and docs say clients that accept a server URL can use https://api.tickerbot.io/mcp directly and sign in with OAuth.

What does the bridge do if the hosted server is unreachable?

According to the README, it serves a bundled tool list, runs calls against the REST API itself, and writes a warning to stderr.

Is Tickerbot free?

Yes. Tickerbot is open source, so you can use and self-host it for free.

How do I add Tickerbot to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://api.tickerbot.io/mcp

What are the best alternatives to Tickerbot?

The closest alternatives to Tickerbot are Top5StocksAPI, Market Data Analyzer, TGMCharts, Onv MCP and hanjialeGit.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers