
Tickerbot
MCP server giving AI clients SQL-style stock screening across US equities and crypto
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/mcpAdd to Settings → Connectors → Add custom connector
https://api.tickerbot.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://api.tickerbot.io/mcp"
}
}
}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/mcpEnter a Name (for example "Tickerbot"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
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.