CryptoAnalysisMCP v1.1 🚀

NEW: Now supports 7+ MILLION tokens through DexPaprika integration! 🎉

A Model Context Protocol (MCP) server for comprehensive cryptocurrency technical analysis. Built with Swift, it provides real-time price data, technical indicators, chart pattern detection, and trading signals for over 7 million cryptocurrencies - from Bitcoin to the newest meme coin on any DEX!

⚠️ IMPORTANT FOR DAY TRADERS: This tool requires a $99/mo Pro subscription for intraday analysis. The free tier only supports daily candles, making it suitable for swing traders and long-term investors only.

🆕 What's New in v1.1

🌟 DexPaprika Integration - 7+ MILLION Tokens!

• NO API KEY REQUIRED for basic price data on ANY token
• Access to every token on every DEX across 23+ blockchains
• Automatic fallback: CoinPaprika → DexPaprika
• Analyze that meme coin that launched 5 minutes ago!
• Perfect for:
  • 🐸 Meme coin traders
  • 🦄 DeFi degens
  • 🚀 Early token hunters
  • 📊 Anyone tracking obscure tokens

🐦 Follow @m_pineapple__ for updates!

🔧 New Liquidity & DEX Tools

• get_token_liquidity: Track liquidity across all DEXes for any token
• search_tokens_by_network: Find tokens on specific blockchains
• compare_dex_prices: Compare token prices across different DEXes
• get_network_pools: View top liquidity pools on any network
• get_dex_info: Get information about DEXes on a network
• get_available_networks: List all 23+ supported blockchains
• search_tokens_advanced: Advanced search with liquidity/volume filters

Features

💡 Not sure what to ask? Check our Crypto Analysis Prompts Guide for inspiration!

• 🆕 Universal Token Support: 7+ MILLION tokens through DexPaprika integration
• 🆕 Liquidity Pool Analytics: Monitor liquidity, volume, and pool data across DEXes
• Dynamic Symbol Resolution: Automatically supports all cryptocurrencies
• Real-time Price Data: Current prices, volume, market cap, and percentage changes
• Technical Indicators: RSI, MACD, Moving Averages, Bollinger Bands, and more
• Chart Pattern Detection: Head & shoulders, triangles, double tops/bottoms
• Support & Resistance Levels: Automatic identification of key price levels
• Trading Signals: Buy/sell/hold recommendations based on technical analysis
• Multi-timeframe Analysis: 4-hour, daily, weekly, and monthly timeframes
• Risk-adjusted Strategies: Conservative, moderate, and aggressive trading approaches

🚀 Coming Soon

We're actively working on exciting new features to make CryptoAnalysisMCP even more powerful:

🆕 Next Release (v1.2.0)

Want to suggest a feature? Open an issue on GitHub!

❓ Frequently Asked Questions

Do I need a paid API key to use this MCP?

Short answer: Depends on your trading style.

⚠️ IMPORTANT: Day traders and scalpers NEED a Pro subscription ($99/mo). The free tier only provides daily candles, which is useless for intraday trading.

What works WITHOUT any API key:

• ✅ Real-time price data (with slight delays)
• ✅ Swing trading analysis (3-7 day trades)
• ✅ Position trading (weeks to months)
• ✅ Long-term investment analysis
• ✅ All technical indicators on DAILY timeframe
• ✅ 1 year of daily historical data
• 🆕 Basic price data for 7+ MILLION tokens via DexPaprika
• 🆕 Liquidity pool data across all major DEXes
• 🆕 DEX price comparison and aggregation

What REQUIRES a Pro API key ($99/mo):

• ❌ Day trading (you need hourly/4h data)
• ❌ Scalping (you need minute data)
• ❌ Intraday patterns and signals
• ❌ Real-time/low-latency updates
• ❌ Historical data beyond 1 year
• ❌ Any timeframe shorter than daily

How to get your FREE API key:

1. Go to CoinPaprika API
2. Click "Start Free"
3. Register for an account
4. Get your API key
5. Add to Claude Desktop config:

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/path/to/crypto-analysis-mcp",
      "env": {
        "COINPAPRIKA_API_KEY": "your-free-api-key-here"
      }
    }
  }
}

The free tier includes:

• ✅ 25,000 API calls per month
• ✅ 1 year of daily historical data
• ✅ 2,500+ cryptocurrencies

For advanced features, upgrade to CoinPaprika Pro:

• ❌ 4-hour and hourly timeframes (Pro required)
• ❌ Extended historical data beyond 1 year
• ❌ Higher rate limits
• ❌ Priority support

Can I use CoinMarketCap or CoinGecko API instead?

Currently: Not directly - this MCP is specifically built for CoinPaprika's API structure.

Coming in v1.2.0: CoinMarketCap API support! 🎉

Key differences:

• CoinMarketCap: Different endpoint structure (support coming in v1.2.0!)
• CoinGecko: Different data format (planned for future release)
• CoinPaprika: Best coverage (71,000+ assets vs 10,000-20,000 for competitors)

We chose CoinPaprika first because:

• 3x more market coverage than competitors
• More generous free tier
• Better historical data access
• Superior API reliability (99.9% uptime)

Once v1.2.0 is released, you'll be able to switch between CoinPaprika and CoinMarketCap APIs with a simple configuration change!

What cryptocurrencies are supported?

🆕 v1.1: Now supports 7+ MILLION tokens!

With our new DexPaprika integration:

• ✅ All 2,500+ CoinPaprika tokens (major coins with full analysis)
• ✅ 7+ MILLION DEX tokens via DexPaprika (automatic fallback)
• ✅ Every token on every DEX across 23+ blockchains
• ✅ Brand new tokens - analyze tokens minutes after launch
• ✅ Obscure meme coins - if it trades on a DEX, we have it
• ✅ NO API KEY NEEDED for basic price data

Examples:

• Major coins: BTC, ETH, SOL (full technical analysis via CoinPaprika)
• Popular memes: DOGE, SHIB, PEPE, WOJAK (price data from any source)
• New launches: That token that launched 5 minutes ago on Uniswap
• Any ERC-20, BEP-20, SPL token, or token on any supported chain

Just use the ticker symbol - the MCP automatically finds it!

Why am I getting 402 Payment Required errors?

You're trying to use features that require a Pro subscription:

Common causes:

• Using any timeframe other than 'daily' (4h, 1h, 15m, etc.)
• Requesting data older than 1 year
• Exceeding rate limits (rare)

Solutions:

1. For swing trading/investing: Just use 'daily' timeframe - it's free!
2. For day trading: You MUST upgrade to CoinPaprika Pro ($99/mo)

There is NO free option for day trading. If you need intraday data, you need to pay.

How accurate are the trading signals?

⚠️ Important: Trading signals are for informational purposes only!

• Based on well-established technical indicators
• No prediction is 100% accurate
• Always do your own research
• Never invest more than you can afford to lose
• Consider multiple factors beyond technical analysis

Can I use this for automated trading?

While technically possible, we strongly advise caution:

• This MCP provides analysis, not execution
• Requires additional safety mechanisms
• Needs proper risk management
• Should be thoroughly backtested
• Consider paper trading first

How often does the data update?

Depends on your API tier:

• Free tier: ~1-5 minute delays
• Pro tier: 30-second updates for prices
• Cached locally: 1-5 minutes to reduce API calls

Is my API key secure?

Yes! Your API key:

• Is never hardcoded
• Only read from environment variables
• Never logged or transmitted
• Only used for CoinPaprika API calls
• Follows security best practices

Can I contribute to this project?

Absolutely! We welcome contributions:

• Bug fixes
• New indicators
• Performance improvements
• Documentation updates
• Feature suggestions

See our Contributing section for guidelines.

Where can I get help?

1. Check this FAQ first
2. Read the documentation
3. Search existing issues
4. Open a new issue with details
5. Join our community discussions

Why Swift instead of Python/JavaScript?

Swift offers:

• Native macOS performance
• Type safety and modern concurrency
• Excellent memory management
• Seamless Claude Desktop integration
• Growing ecosystem for server-side development

Plus, we love Swift! 🍍

Prerequisites

• macOS 10.15 or later
• Swift 5.5 or later
• Xcode 13+ (for development)
• Claude Desktop

Installation

Prerequisites

1. Get a FREE CoinPaprika API Key (optional but recommended for technical analysis):
   • Visit CoinPaprika API
   • Click "Start Free" and register
   • Copy your API key for step 3
   • 🆕 Note: Basic price data now works without API key via DexPaprika!

Quick Install

1. Clone the repository:

git clone https://github.com/M-Pineapple/CryptoAnalysisMCP.git
cd CryptoAnalysisMCP

1. Build the project:

./build-release.sh

1. Configure Claude Desktop by adding to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/path/to/CryptoAnalysisMCP/crypto-analysis-mcp",
      "env": {
        "COINPAPRIKA_API_KEY": "your-free-api-key-here"
      }
    }
  }
}

1. Restart Claude Desktop

Global Installation (Optional)

sudo cp ./.build/release/CryptoAnalysisMCP /usr/local/bin/crypto-analysis-mcp

Then use this in Claude Desktop config:

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/usr/local/bin/crypto-analysis-mcp"
    }
  }
}

Usage

📝 Example Prompts

New to crypto analysis? Check out our comprehensive Crypto Analysis Prompts Guide with 100+ example prompts for:

• 🏃 Day Trading
• 📊 Swing Trading
• 💼 Long-term Investing
• 📈 Technical Indicators
• 🎯 Risk Management
• And much more!

Available Commands

Once configured, you can use these commands in Claude:

Get Current Price

crypto-analysis:get_crypto_price
  symbol: "BTC"

Technical Indicators

crypto-analysis:get_technical_indicators
  symbol: "ETH"
  timeframe: "daily"

Chart Pattern Detection

crypto-analysis:detect_chart_patterns
  symbol: "SOL"
  timeframe: "4h"

Trading Signals

crypto-analysis:get_trading_signals
  symbol: "ADA"
  risk_level: "moderate"
  timeframe: "daily"

Full Analysis

crypto-analysis:get_full_analysis
  symbol: "DOT"
  timeframe: "weekly"
  risk_level: "aggressive"

Support & Resistance

crypto-analysis:get_support_resistance
  symbol: "MATIC"
  timeframe: "daily"

Multi-timeframe Analysis

crypto-analysis:multi_timeframe_analysis
  symbol: "AVAX"

🆕 NEW v1.1 Commands

Get Token Liquidity

crypto-analysis:get_token_liquidity
  symbol: "PEPE"
  network: "ethereum" (optional)

Search Tokens by Network

crypto-analysis:search_tokens_by_network
  network: "solana"
  query: "meme" (optional)
  limit: 20

Compare DEX Prices

crypto-analysis:compare_dex_prices
  symbol: "SHIB"
  network: "ethereum"

Get Network Pools

crypto-analysis:get_network_pools
  network: "ethereum"
  sort_by: "volume_usd"
  limit: 10

Get Available Networks

crypto-analysis:get_available_networks

💡 Quick Examples

Here are some natural language prompts you can use:

1. Quick Analysis

"Give me a quick technical analysis of [SYMBOL]"
"Is [SYMBOL] bullish or bearish right now?"
"What's the trend for [SYMBOL]?"

2. Day Trading Focus

"Analyze [SYMBOL] for day trading opportunities"
"Show me scalping levels for [SYMBOL] today"
"What are the intraday support and resistance for [SYMBOL]?"

3. Swing Trading Analysis

"Provide swing trading setup for [SYMBOL] with 3-7 day outlook"
"Analyze [SYMBOL] patterns on daily timeframe for swing trades"
"Give me entry, stop loss, and targets for swing trading [SYMBOL]"

4. Full Institutional Analysis

"Do a complete Wall Street analyst report on [SYMBOL]"
"Analyze [SYMBOL] like a hedge fund would"
"Give me all technical indicators, patterns, and signals for [SYMBOL]"

5. Risk-Based Strategies

"Show me conservative trading strategy for [SYMBOL]"
"What's the aggressive play on [SYMBOL]?"
"Give me risk-adjusted entries for [SYMBOL]"

6. Specific Indicator Requests

"What's the RSI and MACD saying about [SYMBOL]?"
"Check Bollinger Bands squeeze on [SYMBOL]"
"Are there any chart patterns forming on [SYMBOL]?"

7. 🆕 Meme Coin & DEX Token Analysis

"What's the price of WOJAK?"
"Analyze that new PEPE fork on Ethereum"
"Show me price data for [obscure token]"
"Track this Uniswap token: [contract address]"

8. 🆕 Liquidity & DEX Analytics

"What's the liquidity for SHIB across all DEXes?"
"Show me the top pools on Solana"
"Compare PEPE prices on different DEXes"
"Find high liquidity meme coins on BSC"
"Which DEX has the best price for ETH?"
"Show me all tokens on Arbitrum with >$1M liquidity"

💡 Replace [SYMBOL] with any cryptocurrency ticker (BTC, ETH, SOL, etc.)

👉 See 100+ more examples in our Crypto Analysis Prompts Guide

Supported Cryptocurrencies

🆕 v1.1 Update: The MCP now supports 7+ MILLION tokens through our dual-provider system:

1. CoinPaprika (Primary): 2,500+ major cryptocurrencies with full technical analysis
2. DexPaprika (Fallback): 7+ million DEX tokens across 23+ blockchains - NO API KEY REQUIRED!

The MCP automatically:

• Checks CoinPaprika first for established tokens (better data, more features)
• Falls back to DexPaprika for any token not found
• Caches results for optimal performance
• Works with just the ticker symbol

Supported Networks via DexPaprika:

• Ethereum, BSC, Polygon, Arbitrum, Optimism, Base
• Solana, Avalanche, Fantom, Aptos, Sui
• And 12+ more chains!

Just use any ticker symbol - if it exists on any DEX, we'll find it!

Configuration

API Key (Optional but Recommended)

⚠️ Important:

• 🆕 Basic price data now works WITHOUT API key via DexPaprika!
• Technical analysis features still require a FREE CoinPaprika API key

Get your FREE API key:

1. Visit CoinPaprika API
2. Click "Start Free"
3. Create an account
4. Copy your API key

Add to Claude Desktop:

Option 1 - Environment Variable (Recommended):

{
  "mcpServers": {
    "crypto-analysis": {
      "command": "/path/to/crypto-analysis-mcp",
      "env": {
        "COINPAPRIKA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Option 2 - System Environment:

export COINPAPRIKA_API_KEY="your-api-key-here"

Trading Style Compatibility

Bottom Line: If you're a day trader, you MUST get the Pro subscription. There's no workaround.

Free vs Paid Tiers

Timeframes

Free Tier (No API Key):

• daily - Daily candles only ✅

Pro Tier ($99/mo) - All timeframes:

• 5m - 5-minute candles
• 15m - 15-minute candles
• 30m - 30-minute candles
• 1h - 1-hour candles
• 4h - 4-hour candles
• daily - Daily candles
• weekly - Weekly candles

💡 Note: Attempting to use any timeframe other than 'daily' without a Pro key will result in an error.

Risk Levels

• conservative - Lower risk, focus on strong signals
• moderate - Balanced approach (default)
• aggressive - Higher risk, more sensitive signals

Development

Building from Source

# Clone the repository
git clone https://github.com/M-Pineapple/CryptoAnalysisMCP.git
cd CryptoAnalysisMCP

# Build debug version
swift build

# Build release version
swift build -c release

# Run tests
swift test

Project Structure

CryptoAnalysisMCP/
├── Sources/
│   └── CryptoAnalysisMCP/
│       ├── Main.swift                    # Entry point
│       ├── SimpleMCP.swift               # MCP protocol implementation
│       ├── CryptoDataProvider.swift      # CoinPaprika API integration
│       ├── DexPaprikaDataProvider.swift  # 🆕 DexPaprika integration
│       ├── TechnicalAnalyzer.swift       # Indicators & calculations
│       ├── ChartPatternRecognizer.swift  # Pattern detection
│       ├── SupportResistanceAnalyzer.swift # Support/resistance levels
│       ├── AnalysisFormatters.swift      # Output formatting
│       └── Models.swift                  # Data models
├── Tests/                                # Unit tests
├── Package.swift                         # Swift package manifest
└── README.md                             # This file

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

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

Acknowledgments

• Built with Swift and the Model Context Protocol
• Powered by CoinPaprika API for cryptocurrency data
• 🆕 Enhanced with DexPaprika for 7+ million DEX tokens
• Technical analysis algorithms based on industry standards
• Special thanks to the CoinPaprika team for their support!

Troubleshooting

MCP not appearing in Claude

1. Ensure the path in claude_desktop_config.json is absolute
2. Check that the binary has execute permissions: chmod +x crypto-analysis-mcp
3. Restart Claude Desktop after configuration changes

API Rate Limits

The free tier of CoinPaprika has rate limits. If you encounter 402 errors, consider:

• Using daily timeframe (most compatible with free tier)
• Adding an API key for higher limits
• Implementing request throttling

Build Issues

If you encounter build errors:

1. Ensure Swift 5.5+ is installed: swift --version
2. Clean the build: swift package clean
3. Update dependencies: swift package update

💖 Support This Project

If CryptoAnalysisMCP has helped enhance your crypto analysis workflow or saved you time with technical indicators, consider supporting its development:

Your support helps me:

• Maintain and improve CryptoAnalysisMCP with new features
• Keep the project open-source and free for everyone
• Dedicate more time to addressing user requests and bug fixes
• Explore new indicators and analysis techniques

Thank you for considering supporting my work! 🙏

Support

For issues, questions, or suggestions, please open an issue on GitHub.

Connect

Follow me for updates and crypto analysis insights:

• 🐦 Twitter/X: @m_pineapple__
• 🐙 GitHub: @M-Pineapple

---

Made with ❤️ by 🍍