<div align="center"> <img src="https://github.com/user-attachments/assets/5d1aae51-4183-4cd5-a79c-163fc1e8c918"> </div>

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

2. Build the project:

./build-release.sh

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

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