# Crypto Screener MCP server

Let your AI assistant work with Crypto Screener: screen the market, read derivatives data and order-book walls, and manage your alerts and watchlists. It signs in as you, so there is no API key to copy.

Server URL (Streamable HTTP): `https://mcp.cryptoscreener.app/`

## Connect your client

Add the server URL to your client. On first use it opens a Crypto Screener sign-in page: log in with your usual account and approve access.

### Claude Code

1. Add the server from your terminal:

```bash
claude mcp add --transport http cryptoscreener https://mcp.cryptoscreener.app/
```

2. Inside Claude Code, run /mcp and sign in to cryptoscreener.

### Codex CLI

1. Add the server:

```bash
codex mcp add cryptoscreener --url https://mcp.cryptoscreener.app/
```

2. Sign in:

```bash
codex mcp login cryptoscreener
```

### Claude (claude.ai and Claude Desktop)

1. Open Settings, then Connectors.

2. Choose Add custom connector.

3. Paste the server URL and sign in when asked:

```text
https://mcp.cryptoscreener.app/
```

### ChatGPT

1. Open Settings, then Apps & Connectors, then Advanced, and enable Developer mode.

2. Choose Create connector, paste the server URL and pick OAuth:

```text
https://mcp.cryptoscreener.app/
```

### Cursor

[Add to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=cryptoscreener&config=eyJ1cmwiOiJodHRwczovL21jcC5jcnlwdG9zY3JlZW5lci5hcHAvIn0%3D)

1. Use the button to install the server in Cursor, then sign in when it asks.

### VS Code

[Add to VS Code](vscode:mcp/install?%7B%22name%22%3A%22cryptoscreener%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.cryptoscreener.app%2F%22%7D)

1. Use the button to install the server in VS Code, then sign in when it asks.

### Other clients

1. Any client that supports remote MCP servers over Streamable HTTP with OAuth can use this config:

```json
{
  "mcpServers": {
    "cryptoscreener": {
      "url": "https://mcp.cryptoscreener.app/"
    }
  }
}
```

## What your agent can do

The agent gets tools for the same data and actions you have in Crypto Screener.

- **Screener and market data**: Screen the market by filters, see top movers and volume leaders, find volatile tickers, read ticker stats and a market map snapshot.
- **Candles and chart context**: Price and open-interest candles for a ticker, including second candles.
- **Derivatives**: Funding, open interest, basis, cross-exchange prices, BTC beta and decoupling, pairs spread, session and hour seasonality.
- **Order-book densities**: Large limit-order levels for a ticker.
- **Microstructure** (Pro): VWAP, volume profile and trade intensity.
- **Scalp-setup scan** (Pro): A composite scan for scalping setups.
- **Alerts**: Read alert logs, see which alerts are noisy and run a quick backtest (long windows need Pro). Creating, editing, enabling, disabling and removing complex alerts needs Pro.
- **Watchlists and saved filters**: Work with your watchlists and saved filters. Pinning tickers needs Pro.
- **News and training videos**: Read news posts and find training videos.
- **Account**: Subscription and payment history, trial eligibility, referral and partner stats.
- **Knowledge base**: Search the user guide and the trading playbooks.
- **Position sizing**: Size a position by stop distance or by ATR.

## All tools

This list is generated from the server code. Read-only tools never change your data: every change goes through a preview that you confirm. Pro marks tools that need a Pro subscription.

### Market data & screening

- `count_screener_matches` — Tells how many pairs match a set of screener conditions right now, without listing them. (read-only)
- `get_cross_exchange_prices` — Compares the current price of one symbol across exchanges and shows the largest gap between them. (read-only)
- `get_funding_rate` — Shows the current funding rate of a futures pair. (read-only)
- `get_market_map_snapshot` — Gives the market map in one request: matching pairs with their key metrics and small recent price charts. (read-only)
- `get_open_interest` — Shows the current open interest of a pair and how it changed over a chosen period. (read-only)
- `get_ticker_stats` — Shows a snapshot of one trading pair: price, volume, recent moves, volatility and funding. (read-only)
- `list_basis_opportunities` — Finds gaps between spot and perpetual futures prices that may be worth a closer look. (read-only)
- `list_exchanges` — Lists the exchanges available in CryptoScreener. (read-only)
- `list_market_review_instruments` — Lists the instruments covered by the market review page, optionally for a single exchange. (read-only)
- `list_screener_sort_fields` — Lists the fields the screener results can be sorted by. (read-only)
- `list_top_movers` — Shows the biggest gainers or losers over a chosen period. (read-only)
- `list_top_tickers_by_volume` — Ranks pairs by traded volume over a chosen period. (read-only)
- `list_trading_modes` — Lists the trading modes, such as spot and futures, available on an exchange. (read-only)
- `list_volatile_tickers` — Finds the most volatile pairs over a chosen period. (read-only)
- `rank_funding_extremes` — Ranks futures pairs with the highest positive or the lowest negative funding rate. (read-only)
- `screen_market` — Screens the whole market by many conditions at once: volatility, volume, price moves, funding, open interest and more. (read-only)
- `search_tickers` — Finds trading pairs by name or part of a name. (read-only)

### Candles & charts

- `get_candles` — Loads historical candles of a pair, for price or open interest, for chart analysis. Access to part of the history and to some exchanges depends on your subscription. (read-only)
- `get_candles_info` — Shows how far back the second-level candle history of a pair goes and how much of it there is. (read-only, Pro)
- `get_last_candle` — Shows the most recent candle of a pair. (read-only)
- `get_ticker_chart_context` — Collects everything for a quick look at one pair: stats, recent candles, open interest, your chart settings and your enabled alerts on the same exchange and market. (read-only)
- `get_ticker_settings` — Shows your saved chart overlays for a pair. (read-only)
- `list_chart_settings` — Lists your saved chart settings, for all pairs or for a single one. (read-only)

### Analytics & trading calculators

- `analyze_post_impact` — Shows how prices reacted after a news post was published, for the symbols you pick. (read-only)
- `analyze_session_performance` — Compares how a pair behaves across trading sessions: average range and volume in the Asian, European, US and overnight sessions. (read-only)
- `find_btc_beta_laggers` — Finds pairs that usually follow Bitcoin but are lagging its latest move, as possible catch-up candidates. (read-only)
- `get_orderbook_density_snapshot` — Shows large resting orders in the order book of a pair: price, size, age and distance from the current price. (read-only)
- `get_trade_intensity` — Measures how busy trading is second by second and picks out bursts of activity. (read-only, Pro)
- `get_volume_profile` — Builds a volume profile: where volume traded by price level, the point of control and the value area. (read-only, Pro)
- `get_vwap` — Calculates the volume-weighted average price from second-level candles and how far the current price is from it. (read-only, Pro)
- `hour_of_day_volatility` — Shows the average range and volume for each hour of the day and highlights the most volatile hours. (read-only)
- `pairs_spread_zscore` — Measures how far the spread between two pairs is from its usual level, as a z-score. (read-only)
- `position_size_by_atr` — Calculates position size with a stop-loss derived from volatility (ATR). (read-only)
- `position_size_by_stop` — Calculates position size from account size, risk percent, entry price and a fixed stop-loss. (read-only)
- `rank_decoupled` — Finds the pairs that move least in step with Bitcoin. (read-only)
- `scan_scalp_setups` — Gives a one-call scalping briefing for a pair: VWAP, volume profile, trade speed, nearby large orders, funding and open interest, combined into a long and short score. (read-only, Pro)

### Alerts

- `backtest_peek` — Gives a quick look at how often a set of price conditions would have fired on recent history. Not a full backtest: no fees and no slippage. Long periods at fine detail need a subscription. (read-only)
- `compare_alert_conditions` — Compares the quality of several alerts side by side. (read-only)
- `count_user_alerts` — Counts your alerts, optionally only the enabled or the disabled ones. (read-only)
- `create_complex_alert` — Creates a new alert, only after you confirm the preview. (changes data, Pro)
- `disable_user_alert` — Switches an alert off, only after you confirm. (changes data, Pro)
- `enable_user_alert` — Switches an alert back on, only after you confirm. (changes data, Pro)
- `get_alert_settings` — Shows the account-wide settings of tick alerts and of algorithmic-activity alerts. (read-only, Pro)
- `get_user_alert` — Shows one of your alerts together with its conditions. (read-only)
- `get_user_telegram_chat` — Shows whether alerts can be delivered to your Telegram. (read-only)
- `list_user_alert_logs` — Shows the history of your alert triggers, newest first. (read-only)
- `list_user_alerts_page` — Lists your alerts page by page with their type, state and market. (read-only)
- `preview_create_complex_alert` — Shows how a new alert will look before it is created. Changes nothing. (preview, Pro)
- `preview_disable_user_alert` — Shows which alert will be switched off, before anything changes. Changes nothing. (preview, Pro)
- `preview_enable_user_alert` — Shows which alert will be switched back on, before anything changes. Changes nothing. (preview, Pro)
- `preview_remove_user_alert` — Shows which alert will be deleted, before anything is deleted. Changes nothing. (preview, Pro)
- `preview_update_complex_alert` — Shows how an alert will look after an edit, before the edit is applied. Changes nothing. (preview, Pro)
- `rank_user_alerts_by_noise` — Ranks your alerts from the noisiest to the quietest. (read-only)
- `remove_user_alert` — Deletes an alert, only after you confirm. (changes data, Pro)
- `summarize_alert_quality` — Rates one alert: how often its triggers were followed by a favourable move and how noisy it is. (read-only)
- `update_complex_alert` — Applies an edit to an alert, only after you confirm the preview. (changes data, Pro)

### Watchlists & filters

- `create_user_ticker_list` — Creates a new watchlist, only after you confirm the preview. (changes data)
- `list_user_densities_filters` — Lists your saved order-book density filters. (read-only)
- `list_user_ticker_filters` — Lists your saved screener filters. (read-only)
- `list_user_ticker_lists` — Lists your saved watchlists. (read-only)
- `pin_ticker` — Pins or unpins a pair on your market map, only after you confirm. (changes data, Pro)
- `preview_create_user_ticker_list` — Shows how a new watchlist will look before it is created. Changes nothing. (preview)
- `preview_pin_ticker` — Shows which pair will be pinned or unpinned on your market map, before anything changes. Changes nothing. (preview, Pro)
- `preview_remove_user_densities_filter` — Shows which density filter will be deleted, before anything is deleted. Changes nothing. (preview)
- `preview_remove_user_ticker_list` — Shows which watchlist will be deleted, before anything is deleted. Changes nothing. (preview)
- `preview_update_user_ticker_list` — Shows how a watchlist will look after a rename or a change of tickers, before it is applied. Changes nothing. (preview)
- `remove_user_densities_filter` — Deletes a density filter, only after you confirm. (changes data)
- `remove_user_ticker_list` — Deletes a watchlist, only after you confirm. (changes data)
- `update_user_ticker_list` — Renames a watchlist or changes its tickers, only after you confirm the preview. (changes data)

### Account, payments & partner program

- `get_partner_overview` — Shows your partner dashboard: balances and results for a period, including clicks, referrals and paying referrals. (read-only)
- `get_referral_stats` — Shows your referral program: invite link, progress, bonus months and rewards earned. (read-only)
- `get_trial_eligibility` — Tells whether you can still activate the trial of the paid plan and, if not, why. (read-only)
- `get_viewer` — Shows basic facts about your account, such as whether you have a subscription and of what kind, without personal data. (read-only)
- `list_partner_referrals` — Lists the users you referred as a partner, with their registrations, payments and your commission. (read-only)
- `list_partner_withdrawals` — Shows the history of your partner payout requests: amounts and statuses. (read-only)
- `list_trade_api_keys` — Lists your linked trading keys. The secrets themselves are never shown. (read-only)
- `list_trade_exchanges` — Lists the exchanges connected for tracking your own trades. (read-only)
- `list_transactions` — Shows your own payment and subscription history. (read-only)
- `list_user_brokers` — Lists the exchange accounts you have linked through referral links. (read-only)
- `list_user_trades` — Shows your own executed trades on a pair. Needs linked trading keys. (read-only)

### News, videos & help

- `count_unread_posts` — Counts the news posts you have not read yet. (read-only)
- `get_post` — Shows one news post in full. (read-only)
- `get_useful_video` — Shows one educational video with its description and categories. (read-only)
- `list_posts` — Lists posts from the CryptoScreener news feed. (read-only)
- `list_useful_videos` — Lists CryptoScreener educational videos, with optional search and category. (read-only)
- `list_wishlist_items` — Shows the public list of feature requests with vote counts and your own votes. (read-only)
- `report_unsatisfied_request` — Lets the assistant record a request that no tool could handle, so the team can see what is missing. Does not change your data. (read-only)
- `search_knowledge` — Searches the CryptoScreener knowledge base to answer how-to questions about the product. (read-only)

## Example prompts

Paste any of these into your connected assistant. Creating or changing alerts needs Pro.

- Show the 10 most volatile Binance futures over the last 5 minutes
- Create an alert when any Bybit perp rises 3% in 5 minutes. Show me the preview first
- Where are the biggest order-book walls on BTCUSDT right now?
- Which coins have the most extreme funding right now?
- Which of my alerts are the noisiest and how do I tune them?
- Size a position: $1,000 deposit, 1% risk, stop 2% below entry

## Security and limits

- You sign in with your own Crypto Screener account over OAuth 2.1. The agent acts only as you and sees only your data; your user id is never a tool argument.
- Every change (alerts, watchlists, filters, pins) goes through a preview and confirm step, so the agent shows you what it is about to do first.
- There is no SQL, shell, file or arbitrary HTTP access.
- API secrets of linked exchange keys are never returned.
- Some tools are available on Pro only.
- Requests are rate-limited per account; Pro has a higher limit.

## For AI agents

This page is also available as plain markdown. If you are an AI agent helping a user connect, these are the technical details.

- Server URL (Streamable HTTP): https://mcp.cryptoscreener.app/
- Authentication: OAuth 2.1, PKCE S256, dynamic client registration
- Protected resource metadata: https://mcp.cryptoscreener.app/.well-known/oauth-protected-resource
- Authorization server metadata: https://auth.cryptoscreener.app/.well-known/oauth-authorization-server
- Unauthenticated request: HTTP 401 with a WWW-Authenticate: Bearer resource_metadata header pointing to the protected resource metadata