Cryptoanalysismcp

🚀 CryptoAnalysisMCP v1.1

CryptoAnalysisMCP v1.1 is a Model Context Protocol (MCP) server designed for comprehensive cryptocurrency technical analysis. Built with Swift, it offers real - time price data, technical indicators, chart pattern detection, and trading signals for over 7 million cryptocurrencies, covering from Bitcoin to the latest meme coin on any DEX.

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

⚠️ 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.

🚀 Quick Start

1. Prerequisites:
   • macOS 10.15 or later
   • Swift 5.5 or later
   • Xcode 13+ (for development)
   • Claude Desktop
2. Installation:
   • 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:
     • Clone the repository:

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

    - Build the project:

./build-release.sh

    - 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"
            }
        }
    }
}

    - Restart Claude Desktop

✨ Features

💡 Not sure what to ask? Check our 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

📦 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

💻 Usage Examples

Basic Usage

You can use the following commands in Claude after configuration:

Get Current Price

crypto-analysis:get_crypto_price
  symbol: "BTC"

Technical Indicators

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

Advanced Usage

Full Analysis

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

🆕 NEW v1.1 Commands - Get Token Liquidity

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

📚 Documentation

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! 🍍

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

🔧 Technical Details

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

📄 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

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

💖 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