Crypto Indicators

What is Crypto Indicators about?

Crypto Indicators provides a comprehensive library of technical analysis tools for crypto markets. It includes more than 50 indicators spanning trend, momentum, volatility, and volume categories, as well as ready‑made trading strategies that output simple signals (‑1 = SELL, 0 = HOLD, 1 = BUY).

How to use Crypto Indicators?

1. Install dependencies

   git clone https://github.com/kukapay/crypto-indicators-mcp.git
   cd crypto-indicators-mcp
   npm install
   

2. Run the MCP server (example for a Claude Desktop client)

   {
     "mcpServers": {
       "crypto-indicators-mcp": {
         "command": "node",
         "args": ["index.js"],
         "env": { "EXCHANGE_NAME": "binance" }
       }
     }
   }
   

3. Send natural‑language prompts to the server, e.g.,
   • Calculate the MACD for BTC/USDT on a 1‑hour timeframe with fast period 12, slow period 26, signal period 9, and fetch 100 data points.
   • Give me the RSI strategy signals for ETH/USDT on a 4‑hour timeframe with a period of 14 and 50 data points. The server returns JSON‑formatted indicator values or an array of signals.

Key features of Crypto Indicators

• 50+ Indicators: Trend (EMA, MACD, DEMA, etc.), Momentum (RSI, Stochastic, AO), Volatility (ATR, Bollinger Bands, Keltner), Volume (OBV, VWAP, CMF).
• Built‑in Strategies: Ready‑to‑use signal generators for each indicator category.
• Exchange Agnostic: Default Binance, but any ccxt‑supported exchange can be configured via EXCHANGE_NAME.
• Modular Design: Indicators and strategies are organized in separate folders for easy extension.
• MCP Compatibility: Designed to be called from Model Context Protocol clients, enabling seamless AI‑driven trading workflows.

Use cases of Crypto Indicators

• AI Trading Bots: Integrate with Claude Desktop or other MCP‑compatible agents to provide real‑time technical analysis.
• Quantitative Research: Pull historical indicator values for back‑testing strategies.
• Portfolio Management Dashboards: Visualize multiple indicators and strategy signals alongside price charts.
• Educational Tools: Demonstrate how different technical indicators behave on live crypto data.

FAQ from the Crypto Indicators

Q: Which exchanges are supported? A: Any exchange supported by the ccxt library; set the EXCHANGE_NAME environment variable accordingly.

Q: Do I need an API key? A: Public data endpoints (e.g., Binance public market data) work without a key, but authenticated endpoints require the appropriate API_KEY environment variable for the chosen exchange.

Q: Can I add custom indicators? A: Yes. The project’s modular folder structure lets you drop new calculation modules and expose them via MCP.

Q: How are signals encoded? A: Signals are simple integers: -1 for sell, 0 for hold, and 1 for buy.

Q: Is the server production‑ready? A: The repository is marked as active and MIT‑licensed; however, as with any trading tool, thorough testing and risk management are recommended before live deployment.

Crypto Indicators MCP Server

An MCP server providing a range of cryptocurrency technical analysis indicators and strategies, empowering AI trading agents to efficiently analyze market trends and develop robust quantitative strategies.

Features

• Technical Indicators: 50+ indicators across trend, momentum, volatility, and volume categories.
• Trading Strategies: Corresponding strategies outputting signals: -1 (SELL), 0 (HOLD), 1 (BUY).
• Flexible Data Source: Defaults to Binance, configurable to any ccxt-supported exchange.
• Modular Design: Indicators and strategies are categorized for easy maintenance.

Installation

Prerequisites

• Node.js (v18.x or higher)
• npm (v8.x or higher)

Steps

1. Clone the Repository:

   git clone https://github.com/kukapay/crypto-indicators-mcp.git
   cd crypto-indicators-mcp
   

2. Install Dependencies:

   npm install
   

3. Configure MCP Client: To use this server with an MCP client like Claude Desktop, add the following to your config file (or equivalent):

    {
      "mcpServers": {
        "crypto-indicators-mcp": {
          "command": "node",
          "args": ["path/to/crypto-indicators-mcp/index.js"],
          "env": {
            "EXCHANGE_NAME": "binance"
          }
        }
      }
    }   
   

Available Tools

Trend Indicators

• calculate_absolute_price_oscillator: Measures the difference between two EMAs to identify trend strength (APO).
• calculate_aroon: Identifies trend changes and strength using high/low price extremes (Aroon).
• calculate_balance_of_power: Gauges buying vs. selling pressure based on price movement (BOP).
• calculate_chande_forecast_oscillator: Predicts future price movements relative to past trends (CFO).
• calculate_commodity_channel_index: Detects overbought/oversold conditions and trend reversals (CCI).
• calculate_double_exponential_moving_average: Smooths price data with reduced lag for trend detection (DEMA).
• calculate_exponential_moving_average: Weights recent prices more heavily for trend analysis (EMA).
• calculate_mass_index: Identifies potential reversals by measuring range expansion (MI).
• calculate_moving_average_convergence_divergence: Tracks momentum and trend direction via EMA differences (MACD).
• calculate_moving_max: Computes the maximum price over a rolling period (MMAX).
• calculate_moving_min: Computes the minimum price over a rolling period (MMIN).
• calculate_moving_sum: Calculates the sum of prices over a rolling period (MSUM).
• calculate_parabolic_sar: Provides stop-and-reverse points for trend following (PSAR).
• calculate_qstick: Measures buying/selling pressure based on open-close differences (Qstick).
• calculate_kdj: Combines stochastic and momentum signals for trend analysis (KDJ).
• calculate_rolling_moving_average: Applies a rolling EMA for smoother trend tracking (RMA).
• calculate_simple_moving_average: Averages prices over a period to identify trends (SMA).
• calculate_since_change: Tracks the time since the last significant price change.
• calculate_triple_exponential_moving_average: Reduces lag further than DEMA for trend clarity (TEMA).
• calculate_triangular_moving_average: Weights middle prices more for smoother trends (TRIMA).
• calculate_triple_exponential_average: Measures momentum with triple smoothing (TRIX).
• calculate_typical_price: Averages high, low, and close prices for a balanced trend view.
• calculate_volume_weighted_moving_average: Incorporates volume into moving averages for trend strength (VWMA).
• calculate_vortex: Identifies trend direction and strength using true range (Vortex).

Momentum Indicators

• calculate_awesome_oscillator: Measures market momentum using midline crossovers (AO).
• calculate_chaikin_oscillator: Tracks accumulation/distribution momentum (CMO).
• calculate_ichimoku_cloud: Provides a comprehensive view of support, resistance, and momentum (Ichimoku).
• calculate_percentage_price_oscillator: Normalizes MACD as a percentage for momentum (PPO).
• calculate_percentage_volume_oscillator: Measures volume momentum via EMA differences (PVO).
• calculate_price_rate_of_change: Tracks price momentum as a percentage change (ROC).
• calculate_relative_strength_index: Identifies overbought/oversold conditions via momentum (RSI).
• calculate_stochastic_oscillator: Compares closing prices to ranges for momentum signals (STOCH).
• calculate_williams_r: Measures momentum relative to recent high-low ranges (Williams %R).

Volatility Indicators

• calculate_acceleration_bands: Frames price action with dynamic volatility bands (AB).
• calculate_average_true_range: Measures market volatility based on price ranges (ATR).
• calculate_bollinger_bands: Encloses price action with volatility-based bands (BB).
• calculate_bollinger_bands_width: Quantifies volatility via band width changes (BBW).
• calculate_chandelier_exit: Sets trailing stop-losses based on volatility (CE).
• calculate_donchian_channel: Tracks volatility with high/low price channels (DC).
• calculate_keltner_channel: Combines ATR and EMA for volatility bands (KC).
• calculate_moving_standard_deviation: Measures price deviation for volatility (MSTD).
• calculate_projection_oscillator: Assesses volatility relative to projected prices (PO).
• calculate_true_range: Calculates daily price range for volatility analysis (TR).
• calculate_ulcer_index: Quantifies downside volatility and drawdowns (UI).

Volume Indicators

• calculate_accumulation_distribution: Tracks volume flow to confirm price trends (AD).
• calculate_chaikin_money_flow: Measures buying/selling pressure with volume (CMF).
• calculate_ease_of_movement: Assesses how easily prices move with volume (EMV).
• calculate_force_index: Combines price and volume for momentum strength (FI).
• calculate_money_flow_index: Identifies overbought/oversold via price-volume (MFI).
• calculate_negative_volume_index: Tracks price changes on lower volume days (NVI).
• calculate_on_balance_volume: Accumulates volume to predict price movements (OBV).
• calculate_volume_price_trend: Combines volume and price for trend confirmation (VPT).
• calculate_volume_weighted_average_price: Averages prices weighted by volume (VWAP).

Trend Strategies

• calculate_absolute_price_oscillator_strategy: Generates buy/sell signals from APO crossovers (APO Strategy).
• calculate_aroon_strategy: Signals trend reversals using Aroon crossovers (Aroon Strategy).
• calculate_balance_of_power_strategy: Issues signals based on BOP thresholds (BOP Strategy).
• calculate_chande_forecast_oscillator_strategy: Predicts reversals with CFO signals (CFO Strategy).
• calculate_kdj_strategy: Combines KDJ lines for trend-based signals (KDJ Strategy).
• calculate_macd_strategy: Uses MACD crossovers for trading signals (MACD Strategy).
• calculate_parabolic_sar_strategy: Signals trend direction with PSAR shifts (PSAR Strategy).
• calculate_typical_price_strategy: Generates signals from typical price trends.
• calculate_volume_weighted_moving_average_strategy: Issues signals based on VWMA crossovers (VWMA Strategy).
• calculate_vortex_strategy: Signals trend direction with Vortex crossovers (Vortex Strategy).

Momentum Strategies

• calculate_momentum_strategy: Issues signals based on momentum direction.
• calculate_awesome_oscillator_strategy: Signals momentum shifts with AO crossovers (AO Strategy).
• calculate_ichimoku_cloud_strategy: Generates signals from Ichimoku cloud positions (Ichimoku Strategy).
• calculate_rsi2_strategy: Signals overbought/oversold with RSI thresholds (RSI Strategy).
• calculate_stochastic_oscillator_strategy: Uses stochastic crossovers for signals (STOCH Strategy).
• calculate_williams_r_strategy: Signals momentum reversals with Williams %R (Williams %R Strategy).

Volatility Strategies

• calculate_acceleration_bands_strategy: Signals breakouts with acceleration bands (AB Strategy).
• calculate_bollinger_bands_strategy: Issues signals from Bollinger Band breaches (BB Strategy).
• calculate_projection_oscillator_strategy: Signals volatility shifts with PO (PO Strategy).

Volume Strategies

• calculate_chaikin_money_flow_strategy: Signals volume pressure with CMF (CMF Strategy).
• calculate_ease_of_movement_strategy: Issues signals based on EMV trends (EMV Strategy).
• calculate_force_index_strategy: Signals momentum with force index shifts (FI Strategy).
• calculate_money_flow_index_strategy: Signals overbought/oversold with MFI (MFI Strategy).
• calculate_negative_volume_index_strategy: Signals trends with NVI changes (NVI Strategy).
• calculate_volume_weighted_average_price_strategy: Issues signals from VWAP crossovers (VWAP Strategy).

Usage Examples

Example 1: Calculate MACD Indicator

Input (Natural Language Prompt):

Calculate the MACD for BTC/USDT on a 1-hour timeframe with fast period 12, slow period 26, signal period 9, and fetch 100 data points.

Output:

{"macd": [...], "signal": [...], "histogram": [...]}

Example 2: Calculate RSI Strategy

Input (Natural Language Prompt):

Give me the RSI strategy signals for ETH/USDT on a 4-hour timeframe with a period of 14 and 50 data points.

Output:

[-1, 0, 1, 0, ...]

License

This project is licensed under the MIT License - see the LICENSE file for details.