Universal Crypto Mcp

🤖💰 Universal Crypto MCP

██╗ ██╗███╗ ██╗██╗██╗ ██╗███████╗██████╗ ███████╗ █████╗ ██╗ ██║ ██║████╗ ██║██║██║ ██║██╔════╝██╔══██╗██╔════╝██╔══██╗██║ ██║ ██║██╔██╗ ██║██║██║ ██║█████╗ ██████╔╝███████╗███████║██║ ██║ ██║██║╚██╗██║██║╚██╗ ██╔╝██╔══╝ ██╔══██╗╚════██║██╔══██║██║ ╚██████╔╝██║ ╚████║██║ ╚████╔╝ ███████╗██║ ██║███████║██║ ██║███████╗ ╚═════╝ ╚═╝ ╚═══╝╚═╝ ╚═══╝ ╚══════╝╚═╝ ╚═╝╚══════╝╚═╝ ╚═╝╚══════╝ ██████╗██████╗ ██╗ ██╗██████╗ ████████╗ ██████╗ ██╔════╝██╔══██╗╚██╗ ██╔╝██╔══██╗╚══██╔══╝██╔═══██╗ ██║ ██████╔╝ ╚████╔╝ ██████╔╝ ██║ ██║ ██║ ██║ ██╔══██╗ ╚██╔╝ ██╔═══╝ ██║ ██║ ██║ ╚██████╗██║ ██║ ██║ ██║ ██║ ╚██████╔╝ ╚═════╝╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ███╗ ███╗ ██████╗██████╗ ████╗ ████║██╔════╝██╔══██╗ ██╔████╔██║██║ ██████╔╝ ██║╚██╔╝██║██║ ██╔═══╝ ██║ ╚═╝ ██║╚██████╗██║ ╚═╝ ╚═╝ ╚═════╝╚═╝

npx @nirholas/universal-crypto-mcp

✨ What's New: AI Service Marketplace

> Monetize your AI services & discover the best APIs! 💸

The AI Service Marketplace is a complete ecosystem for AI service discovery, monetization, and reputation management:

• 🏪 Register your AI service - Instant monetization with pay-per-use or subscriptions
• 🔍 AI agents discover services - Automatic discovery by category, price, and rating
• ⭐ On-chain reputation - Build trust with verified ratings and reviews
• 💳 Flexible pricing - Pay-per-use, subscriptions, free tiers
• 📊 Analytics dashboard - Track usage, revenue, and performance
• 🔒 Secure payments - Escrow, dispute resolution, automatic refunds

[Learn more →](MARKETPLACE.md) | [View Tutorial →](docs/content/tutorials/marketplace-service.md)

x402 Payment Protocol

AI agents can now pay for things on the internet! 💸

User: "Get premium weather data for Tokyo"

Claude: 🔍 Checking x402 balance... $45.23 USDs
        💳 Paying $0.01 for premium API access...
        ✅ Payment confirmed! Here's your detailed forecast:
        
        🌤️ Tokyo Weather (7-day premium forecast)...

AI agents can now:

• 💸 Pay for premium APIs automatically
• 🏪 Sell their own services to other agents
• 🔄 Trade with other AI agents peer-to-peer
• ⛓️ Work across EVM + Solana chains

> ⭐ If you find this useful, please star the repo! It helps others discover this project.

---

A Universal Model Context Protocol server for all EVM-compatible networks + Solana.

Enable AI agents (Claude, ChatGPT, Cursor) to interact with any EVM blockchain through natural language.

🆚 Why Universal Crypto MCP?

| Feature | Universal Crypto MCP | Other MCP Servers | |---------|---------------------|-------------------| | Tools | 380+ tools | 10-50 tools | | Chains | 20+ chains (EVM + multi-chain) | 1-3 chains | | DEX Support | Multi-aggregator (1inch, 0x, ParaSwap) | Single DEX or none | | Security | GoPlus, honeypot, rug pull detection | Basic or none | | DeFi | Aave, Compound, Lido, Uniswap | Limited | | Market Data | CoinGecko, DefiLlama, LunarCrush | Basic prices | | Bridges | LayerZero, Stargate, Wormhole | None | | MEV Protection | Flashbots integration | None | | Transport | stdio, HTTP, SSE | Usually only stdio | | ChatGPT Support | ✅ Native HTTP mode | ❌ Most don't |

---

📦 Package Structure

The most comprehensive crypto MCP monorepo with 10+ integrated packages from the best MIT-licensed projects:

packages/
├── core/               # Shared types, utilities, configuration
├── trading/            # CEX exchange integrations
│   ├── binance/        # Binance spot & futures
│   ├── binance-us/     # Binance US
│   └── bybit/          # Bybit exchange (ethancod1ng) ⭐ NEW
├── market-data/        # Prices, news, analytics  
│   ├── prices/         # CoinGecko, DexPaprika, CoinMarketCap
│   ├── news/           # CryptoPanic, aggregated news
│   ├── analytics/      # Whale tracking, Fear/Greed, Dune
│   ├── predictions/    # AI price predictions
│   ├── crypto-indicators/  # Technical analysis (Kukapay) ⭐ NEW
│   ├── crypto-sentiment/   # Sentiment analysis (Kukapay) ⭐ NEW
│   ├── crypto-feargreed/   # Fear & Greed Index (Kukapay) ⭐ NEW
│   ├── cryptopanic/        # News aggregation (Kukapay)
│   └── coinmarketcap/      # CMC API (Shinzo Labs) ⭐ NEW
├── defi/               # On-chain DeFi tools (60+ networks!)
│   ├── protocols/      # EVM MCP Server (360⭐), Sperax, DEX
│   │   ├── algorand/   # Algorand tools (GoPlausible) ⭐ NEW
│   │   └── bsc-ops/    # BSC operations (TermiX) ⭐ NEW
│   ├── chain-tools/    # BNB Chain, Onchain MCP
│   └── agents/         # Autonomous DeFi agents
├── wallets/            # Wallet management
│   ├── evm/            # Ethereum & EVM wallets
│   └── solana/         # Solana wallets
├── payments/           # Payment infrastructure
│   └── x402/           # x402 protocol, USDC transfers
├── automation/         # Bots & automation
│   ├── social/         # XActions Twitter automation
│   ├── sweep/          # Dust sweeping
│   └── volume/         # Volume tools
└── generators/         # Meta-tools for building MCP servers
    ├── abi-to-mcp/     # Convert ABIs to MCP tools
    ├── repo-to-mcp/    # GitHub repos → MCP servers
    ├── doc-extractor/  # Extract docs for LLMs
    ├── registry/       # Lyra tool registry
    └── discovery/      # Tool discovery & search

📖 [View Package Documentation →](docs/content/packages/)

Integrated Community MCP Servers

This repo consolidates the best MIT-licensed crypto MCP projects with proper attribution:

| Project | Author | Category | Description | |---------|--------|----------|-------------| | evm-mcp-server | mcpdotdirect | defi | 60+ networks, 22+ tools | | crypto-indicators-mcp ⭐ NEW | Kukapay | market-data | Technical indicators (RSI, MACD, Bollinger) | | crypto-sentiment-mcp ⭐ NEW | Kukapay | market-data | Multi-source sentiment analysis | | crypto-feargreed-mcp ⭐ NEW | Kukapay | market-data | Fear & Greed Index | | cryptopanic-mcp-server | Kukapay | market-data | Crypto news aggregation | | coinmarketcap-mcp ⭐ NEW | Shinzo Labs | market-data | Complete CMC API | | whale-tracker-mcp | Kukapay | analytics | Large wallet tracking | | mcp-web3-stats | crazyrabbitLTC | analytics | Dune Analytics integration | | dexpaprika-mcp | CoinPaprika | prices | DEX price data | | algorand-mcp ⭐ NEW | GoPlausible | blockchain | 40+ Algorand tools | | bybit-mcp-server ⭐ NEW | ethancod1ng | exchange | Bybit API integration | | bsc-mcp ⭐ NEW | TermiX | defi | BSC operations & security | | onchain-mcp | Bankless | defi | On-chain tools | | mcp-free-usdc-transfer | MagnetAI | payments | Free USDC transfers |

All integrated projects maintain their original MIT licenses with full attribution. See [CONTRIBUTORS.md](CONTRIBUTORS.md) for detailed attribution and our modifications.

---

Supported Networks

EVM Chains

• Ethereum, BNB Smart Chain (BSC), Polygon, Arbitrum, Base, Optimism
• Avalanche, Fantom, zkSync Era, Linea, Scroll, Blast, Mode, Mantle
• opBNB + All testnets

Multi-Chain (NEW)

• Cosmos/IBC - ATOM, OSMO, JUNO, INJ, and more
• Near Protocol - NEAR native + contracts
• Sui - SUI with Move support
• Aptos - APT with Move support
• Bitcoin, Litecoin, Solana, TON, XRP, THORChain

Features

• 🔄 Swap/DEX - Token swaps via 1inch, 0x, ParaSwap
• 🌉 Bridge - Cross-chain transfers via LayerZero, Stargate, Wormhole
• ⛽ Gas - Gas prices across chains, EIP-1559 suggestions
• 📦 Multicall - Batch read/write operations
• 📊 Events/Logs - Query historical events, decode logs
• 🔒 Security - Rug pull detection, honeypot check, GoPlus token/address security, dApp phishing detection
• 💰 Staking - Liquid staking (Lido), LP farming
• ✍️ Signatures - Sign messages, verify signatures, EIP-712
• 🏦 Lending - Aave/Compound positions, borrow rates
• 📈 Price Feeds - Historical prices, TWAP, oracle aggregation
• 📁 Portfolio - Track holdings across chains
• 🏛️ Governance - Snapshot votes, on-chain proposals
• 🚀 Deployment - Deploy contracts, CREATE2, upgradeable proxies, verification
• 🛡️ MEV Protection - Flashbots Protect, private transactions, bundle simulation
• 🆔 ENS/Domains - Register, transfer, renew, set records, subdomains
• 📊 Market Data - CoinGecko & CoinStats prices, OHLCV, trending, categories, exchanges
• 🌐 DeFi Analytics - DefiLlama TVL, yields, fees, bridges, stablecoins, protocol data
• 💬 Social Sentiment - LunarCrush social metrics, influencers, trending topics
• 📈 DEX Analytics - DexPaprika & GeckoTerminal pools, trades, OHLCV, trending tokens
• 🔮 Predictions - Polymarket prediction markets, crypto forecasts
• 📉 Technical Indicators - 50+ indicators (RSI, MACD, Bollinger Bands, etc.)
• 🔔 Alerts - Price alerts, whale movement alerts, gas alerts (NEW)
• 📡 WebSockets - Real-time price streams, trade feeds, mempool monitoring (NEW)
• 🐋 Wallet Analytics - Whale tracking, wallet scoring, behavior analysis (NEW)
• 🌐 Multi-Chain - Cosmos, Near, Sui, Aptos native support (NEW)
• 💰 x402 Payments - AI agents can pay for premium APIs automatically (NEW)

---

💰 x402 Payment Protocol (NEW!)

> Give Claude Money! AI agents can now make and receive cryptocurrency payments.

What is x402?

x402 implements HTTP 402 Payment Required, enabling AI agents to:

• 💸 Pay for APIs - Automatically pay for premium API access
• 🤖 Autonomous Payments - No human approval needed
• 🏦 Hold funds - Agents have their own crypto wallets
• 📈 Earn yield - Payments use USDs stablecoin (~5% APY auto-yield)

Quick Setup

# Add to your environment
export X402_PRIVATE_KEY=0x...  # Your EVM private key
export X402_CHAIN=arbitrum      # Default chain (or base, ethereum, polygon)

x402 Tools (14 Total)

| Tool | Description | |------|-------------| | x402_pay_request | Make HTTP request with automatic 402 payment | | x402_balance | Check wallet balance (USDC/USDs + native) | | x402_send | Send direct payment to an address | | x402_batch_send | Send multiple payments in one transaction | | x402_gasless_send | Send payment without paying gas | | x402_estimate | Check cost before paying | | x402_address | Get your wallet address | | x402_networks | List supported networks | | x402_yield | Check USDs auto-yield earnings | | x402_apy | Get current APY rate | | x402_yield_estimate | Project future yield | | x402_approve | Approve token spending | | x402_tx_status | Check transaction status | | x402_config | View current configuration |

Supported Networks

| Network | CAIP-2 | Status | |---------|--------|--------| | Base | eip155:8453 | ✅ Recommended | | Arbitrum | eip155:42161 | ✅ Supported | | Ethereum | eip155:1 | ✅ Supported | | Polygon | eip155:137 | ✅ Supported | | Solana | solana:mainnet | ✅ Supported |

Example

User: "Get premium weather data for Tokyo"
Agent: [calls x402_pay_request to weather API]
       [automatically pays $0.01 in USDs]
       "Here's the detailed forecast..."

x402 Architecture

┌─────────┐      ┌───────────┐      ┌───────────┐
│ Claude  │─────▶│ MCP Server│─────▶│ Paid API  │
│  (AI)   │      │  (x402)   │      │   (402)   │
└─────────┘      └───────────┘      └───────────┘
     │                │                   │
     │  "Get data"    │  HTTP + Payment   │
     │                │                   │
     └────────────────┴───────────────────┘

📖 Full Documentation:

• [x402 README](x402/README.md) - Overview and quick start
• [Quickstart Guide](x402/docs/QUICKSTART.md) - 5-minute setup
• [MCP Tools Reference](x402/docs/MCP_TOOLS.md) - All 14 tools explained
• [Architecture](x402/docs/ARCHITECTURE.md) - Technical deep dive
• [Examples](x402/docs/EXAMPLES.md) - Real-world use cases
• [Security Guide](x402/docs/SECURITY.md) - Best practices

---

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here (optional)"
      }
    }
  }
}

Cursor

Add to your MCP settings:

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "command": "npx",
      "args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
      "env": {
        "PRIVATE_KEY": "your_private_key_here (optional)"
      }
    }
  }
}

ChatGPT Developer Mode

1. Enable Developer Mode in ChatGPT settings
2. Start the HTTP server:

``bash npx @nirholas/universal-crypto-mcp@latest --http ``

1. In ChatGPT Settings → Apps, click Create app
2. Enter your server URL: http://localhost:3001/mcp
3. Select the app in conversations via Developer mode menu

For detailed setup instructions, see ChatGPT Setup Guide.

Server Modes

| Mode | Command | Use Case | |------|---------|----------| | stdio | npx @nirholas/universal-crypto-mcp | Claude Desktop, Cursor | | HTTP | npx @nirholas/universal-crypto-mcp --http | ChatGPT Developer Mode | | SSE | npx @nirholas/universal-crypto-mcp --sse | Legacy HTTP clients |

---

💬 Example Prompts (Copy & Paste!) Real prompts you can use with Claude, ChatGPT, or Cursor. Just copy and paste!

🔄 Token Swaps

Swap 0.1 ETH for USDC on Arbitrum

Get me a quote to swap 100 USDC to WBTC on Base

What's the best rate to swap 500 DAI to ETH across all DEXs on Ethereum?

📊 Market Data & Prices

What's the current price of Bitcoin and Ethereum in USD?

Show me the top 10 trending coins on CoinGecko right now

Get the 7-day OHLCV data for Solana

What's the market cap and 24h volume of BNB?

Show me the price of token 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum

🌐 DeFi Analytics (DefiLlama)

What's the total TVL of Aave across all chains?

Show me the top 10 protocols by TVL

What are the best yield opportunities for stablecoins right now?

How much volume did bridges process in the last 24 hours?

Show me the TVL history of Uniswap over the last 30 days

📈 DEX Analytics

Show me the top trending pools on Uniswap V3

Get the most traded tokens on Base in the last 24 hours

Find all liquidity pools for PEPE on Ethereum

What's the price and liquidity of the ETH/USDC pool on Aerodrome?

🔒 Security Checks

Is this token safe? 0x

…

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [nirholas](https://github.com/nirholas)
- **Source:** [nirholas/universal-crypto-mcp](https://github.com/nirholas/universal-crypto-mcp)
- **License:** Apache-2.0
- **Homepage:** https://mcp.giving

Install and usage instructions live in the source repository linked above.