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:

Go to CoinPaprika API
Click "Start Free"
Register for an account
Get your API key
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:

For swing trading/investing: Just use 'daily' timeframe - it's free!
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?

Check this FAQ first
Read the documentation
Search existing issues
Open a new issue with details
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

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

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:

CoinPaprika (Primary): 2,500+ major cryptocurrencies with full technical analysis
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:

Visit CoinPaprika API
Click "Start Free"
Create an account
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.

Fork the repository
Create your feature branch (git checkout -b feature/AmazingFeature)
Commit your changes (git commit -m 'Add some AmazingFeature')
Push to the branch (git push origin feature/AmazingFeature)
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

Ensure the path in claude_desktop_config.json is absolute
Check that the binary has execute permissions: chmod +x crypto-analysis-mcp
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:

Ensure Swift 5.5+ is installed: swift --version
Clean the build: swift package clean
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 🍍

Name		Name	Last commit message	Last commit date
Latest commit History 20 Commits
Sources/CryptoAnalysisMCP		Sources/CryptoAnalysisMCP
Tests/CryptoAnalysisMCPTests		Tests/CryptoAnalysisMCPTests
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
EXAMPLES.md		EXAMPLES.md
LICENSE		LICENSE
PROMPTS.md		PROMPTS.md
Package.resolved		Package.resolved
Package.swift		Package.swift
QUICK_REFERENCE.md		QUICK_REFERENCE.md
README.md		README.md
build-release.sh		build-release.sh
build.sh		build.sh
check_config.sh		check_config.sh
claude_config_example.json		claude_config_example.json
claude_config_with_api_key_example.json		claude_config_with_api_key_example.json
run-crypto-mcp.sh		run-crypto-mcp.sh

License

M-Pineapple/CryptoAnalysisMCP

Folders and files

Latest commit

History

Repository files navigation

CryptoAnalysisMCP v1.1 🚀

🆕 What's New in v1.1

🌟 DexPaprika Integration - 7+ MILLION Tokens!

🔧 New Liquidity & DEX Tools

Features

🚀 Coming Soon

🆕 Next Release (v1.2.0)

❓ Frequently Asked Questions

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

Can I use CoinMarketCap or CoinGecko API instead?

What cryptocurrencies are supported?

Why am I getting 402 Payment Required errors?

How accurate are the trading signals?

Can I use this for automated trading?

How often does the data update?

Is my API key secure?

Can I contribute to this project?

Where can I get help?

Why Swift instead of Python/JavaScript?

Prerequisites

Installation

Prerequisites

Quick Install

Global Installation (Optional)

Usage

📝 Example Prompts

Available Commands

Get Current Price

Technical Indicators

Chart Pattern Detection

Trading Signals

Full Analysis

Support & Resistance

Multi-timeframe Analysis

🆕 NEW v1.1 Commands

Get Token Liquidity

Search Tokens by Network

Compare DEX Prices

Get Network Pools

Get Available Networks

💡 Quick Examples

Supported Cryptocurrencies

Configuration

API Key (Optional but Recommended)

Get your FREE API key:

Add to Claude Desktop:

Trading Style Compatibility

Free vs Paid Tiers

Timeframes

Risk Levels

Development

Building from Source

Project Structure

Contributing

License

Acknowledgments

Troubleshooting

MCP not appearing in Claude

API Rate Limits

Build Issues

💖 Support This Project

Support

Connect

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 2

Packages 0

Languages

Packages