CryptoSignal

CryptoSignal MCP is an AI-powered server that provides direction predictions and market signals for cryptocurrencies using ensemble machine learning models and extensive technical indicators. It enables you to run a local MCP server, connect via an MCP client, and perform fast ML-based predictions and technical analyses on popular trading pairs and timeframes.

How to use

You will connect to CryptoSignal MCP from your MCP client to access four core capabilities: predict_crypto_direction, analyze_crypto_indicators, get_crypto_news_search, and monitor_polymarket_trader. Use these endpoints to get directional predictions with confidence, fast technical insights, optimized news search queries, and trader activity analyses for transparency and behavior patterns.

To run practical scenarios, call the available tools as you work on your trading ideas. For example, obtain a Bitcoin 1-hour ML prediction with a 1000-sample training window, perform Ethereum 1-hour technical analysis with 100 data points, generate a news search query for Bitcoin, and monitor a polymarket trader by wallet address.

How to install

Prerequisites: Install Python 3.11 or newer on your system.

Clone the CryptoSignal MCP project, install dependencies, and start the server using the commands below.

Run these commands in your terminal or shell to set up and start the server:

# Clone the project
git clone https://github.com/khalilbalaree/CryptoSignal-MCP.git
cd CryptoSignal-MCP

# Install dependencies
pip install -r requirements.txt

# Run the server
python crypto_predictor_server.py

MCP integration

Configure your MCP client with the local Python service that CryptoSignal MCP runs. The server is intended to run as a local stdio MCP server.

{
  "mcpServers": {
    "cryptosignal-mcp": {
      "command": "python",
      "args": ["/path/to/CryptoSignal-MCP/crypto_predictor_server.py"],
      "env": {}
    }
  }
}

API tools and usage notes

The server exposes the following tools you can use from your MCP client:

• predict_crypto_direction: Advanced ML prediction using ensemble models to predict price direction.
• analyze_crypto_indicators: Fast technical analysis without ML training for immediate market insights.
• get_crypto_news_search: Generate optimized search queries for WebSearch-style analysis.
• monitor_polymarket_trader: Analyze successful crypto traders' positions and patterns on Polymarket.

You can invoke these tools through your MCP client by passing the appropriate parameters such as symbol, interval, and other optional settings described in each tool’s usage. For example, call predict_crypto_direction(symbol="BTCUSDT", interval="1h", training_periods=1000) to get a direction prediction with a confidence score.

Examples

Basic predictions and analyses you can perform:

• Get ML prediction for Bitcoin (1-hour timeframe)
• Quick technical analysis for Ethereum (4-hour timeframe)
• Generate a news search query for Bitcoin
• Monitor a Polymarket trader by wallet address

Technical indicators

CryptoSignal MCP leverages 30+ technical indicators across categories such as price momentum, moving averages, oscillators, volume, volatility, and market structure to feed the models and provide robust predictions and insights.

Model architecture (visual)

Historical data feeds into feature engineering, then 30+ technical indicators feed ensemble models (Random Forest, Gradient Boosting, Extra Trees). A voting classifier combines outputs to produce a final prediction with confidence.

Notes and risk

This tool is for educational and research purposes. Cryptocurrency trading carries significant risk. Use proper risk management and never invest more than you can afford to lose.

License

MIT License. See the project for details.

Available tools

predict_crypto_direction

Advanced ML prediction using ensemble models to predict price direction.

analyze_crypto_indicators

Fast technical analysis without ML training - immediate market insights.

get_crypto_news_search

Generate optimized search queries for analysis and WebSearch-like workflows.

monitor_polymarket_trader

Analyze successful crypto traders' positions and patterns on Polymarket.