# Tickerbot

> Tickerbot is an open-source MCP server for stock market data. MCP server giving AI clients SQL-style stock screening across US equities and crypto. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, Web, VS Code, macOS, Windows, Linux
- **Website:** https://tickerbot.io/mcp-server
- **Repository:** https://github.com/tickerbot/tickerbot-mcp
- **MCP Registry name:** io.github.tickerbot/mcp-server
- **Categories:** [stock market data](https://ai-powered.com/categories/stock-market-data)
- **Listing updated:** 2026-11-21

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.tickerbot.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://api.tickerbot.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
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.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Top5StocksAPI](https://ai-powered.com/mcp/top5stocksapi): Top5StocksAPI is an MCP server for finance and payments.
- [Market Data Analyzer](https://ai-powered.com/mcp/market-data-analyzer): Market Data Analyzer is a paid MCP server for finance and payments.
- [TGMCharts](https://ai-powered.com/mcp/tgmcharts): TGMCharts is a freemium MCP server for finance and payments.
- [Onv MCP](https://ai-powered.com/mcp/onv-mcp): Onv MCP is a freemium MCP server for crypto and web3.
- [hanjialeGit](https://ai-powered.com/mcp/hanjialegit): hanjialeGit is an open-source MCP server for financial data.
- [Stock Scanner MCP](https://ai-powered.com/mcp/stock-scanner-mcp): Stock Scanner MCP is an open-source MCP server for finance and payments.
- [Vanoe Intelligence MCP](https://ai-powered.com/mcp/vanoe-intelligence-mcp): Vanoe Intelligence MCP is a freemium MCP server for stock market data.
- [Financekit MCP](https://ai-powered.com/mcp/financekit-mcp): Financekit MCP is an open-source MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/tickerbot
