# Universal Blockchain MCP [Health: Active] **Category:** ๐Ÿ’ฐ Finance & Fintech **Repository:** https://github.com/nirholas/universal-crypto-mcp **GitHub Stars:** 40 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/universal-blockchain-mcp ## Description Universal blockchain MCP - swaps bridges staking lending Ethereum Arbitrum ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "universal-blockchain-mcp": { "command": "npx", "args": ["-y","@nirholas/universal-crypto-mcp"] } } ``` ## Documentation & README # ๐Ÿค–๐Ÿ’ฐ Universal Crypto MCP 

โ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—     
โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ•—  โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘     
โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—  โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘      
โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•”โ•โ•โ•  โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ•šโ•โ•โ•โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘     
โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘ โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘ โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ• โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘  โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘  โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—
 โ•šโ•โ•โ•โ•โ•โ• โ•šโ•โ•  โ•šโ•โ•โ•โ•โ•šโ•โ•  โ•šโ•โ•โ•โ•  โ•šโ•โ•โ•โ•โ•โ•โ•โ•šโ•โ•  โ•šโ•โ•โ•šโ•โ•โ•โ•โ•โ•โ•โ•šโ•โ•  โ•šโ•โ•โ•šโ•โ•โ•โ•โ•โ•โ•
           โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—            
          โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ•šโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—โ•šโ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ•โ–ˆโ–ˆโ•—           
          โ–ˆโ–ˆโ•‘     โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ• โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ• โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•   โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘           
          โ–ˆโ–ˆโ•‘     โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—  โ•šโ–ˆโ–ˆโ•”โ•  โ–ˆโ–ˆโ•”โ•โ•โ•โ•    โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘           
          โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘  โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘   โ–ˆโ–ˆโ•‘        โ–ˆโ–ˆโ•‘   โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•           
           โ•šโ•โ•โ•โ•โ•โ•โ•šโ•โ•  โ•šโ•โ•   โ•šโ•โ•   โ•šโ•โ•        โ•šโ•โ•    โ•šโ•โ•โ•โ•โ•โ•            
                          โ–ˆโ–ˆโ–ˆโ•—   โ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—                     
                          โ–ˆโ–ˆโ–ˆโ–ˆโ•— โ–ˆโ–ˆโ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•”โ•โ•โ•โ•โ•โ–ˆโ–ˆโ•”โ•โ•โ–ˆโ–ˆโ•—                    
                          โ–ˆโ–ˆโ•”โ–ˆโ–ˆโ–ˆโ–ˆโ•”โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘     โ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•”โ•                    
                          โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ•”โ•โ–ˆโ–ˆโ•‘โ–ˆโ–ˆโ•‘     โ–ˆโ–ˆโ•”โ•โ•โ•โ•                     
                          โ–ˆโ–ˆโ•‘ โ•šโ•โ• โ–ˆโ–ˆโ•‘โ•šโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ–ˆโ•—โ–ˆโ–ˆโ•‘                         
                          โ•šโ•โ•     โ•šโ•โ• โ•šโ•โ•โ•โ•โ•โ•โ•šโ•โ•

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

npm version npm downloads x402 enabled chains

MCP Compatible TypeScript Node.js 18+ License: Apache 2.0

GitHub Stars Issues

Universal Crypto MCP Demo

## โœจ 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 โ†’](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/MARKETPLACE.md)** | **[View Tutorial โ†’](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/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 โ†’](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/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](https://github.com/mcpdotdirect/evm-mcp-server) | mcpdotdirect | defi | 60+ networks, 22+ tools | | [crypto-indicators-mcp](https://github.com/kukapay/crypto-indicators-mcp) โญ **NEW** | Kukapay | market-data | Technical indicators (RSI, MACD, Bollinger) | | [crypto-sentiment-mcp](https://github.com/kukapay/crypto-sentiment-mcp) โญ **NEW** | Kukapay | market-data | Multi-source sentiment analysis | | [crypto-feargreed-mcp](https://github.com/kukapay/crypto-feargreed-mcp) โญ **NEW** | Kukapay | market-data | Fear & Greed Index | | [cryptopanic-mcp-server](https://github.com/kukapay/cryptopanic-mcp-server) | Kukapay | market-data | Crypto news aggregation | | [coinmarketcap-mcp](https://github.com/shinzo-labs/coinmarketcap-mcp) โญ **NEW** | Shinzo Labs | market-data | Complete CMC API | | [whale-tracker-mcp](https://github.com/kukapay/whale-tracker-mcp) | Kukapay | analytics | Large wallet tracking | | [mcp-web3-stats](https://github.com/crazyrabbitLTC/mcp-web3-stats) | crazyrabbitLTC | analytics | Dune Analytics integration | | [dexpaprika-mcp](https://github.com/coinpaprika/dexpaprika-mcp) | CoinPaprika | prices | DEX price data | | [algorand-mcp](https://github.com/GoPlausible/algorand-mcp) โญ **NEW** | GoPlausible | blockchain | 40+ Algorand tools | | [bybit-mcp-server](https://github.com/ethancod1ng/bybit-mcp-server) โญ **NEW** | ethancod1ng | exchange | Bybit API integration | | [bsc-mcp](https://github.com/TermiX-official/bsc-mcp) โญ **NEW** | TermiX | defi | BSC operations & security | | [onchain-mcp](https://github.com/bankless/onchain-mcp) | Bankless | defi | On-chain tools | | [mcp-free-usdc-transfer](https://github.com/magnetai/mcp-free-usdc-transfer) | MagnetAI | payments | Free USDC transfers | **All integrated projects maintain their original MIT licenses with full attribution.** See [CONTRIBUTORS.md](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/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!)

x402 Give Claude Money

> **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 ```bash # 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](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/x402/README.md) - Overview and quick start - [Quickstart Guide](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/x402/docs/QUICKSTART.md) - 5-minute setup - [MCP Tools Reference](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/x402/docs/MCP_TOOLS.md) - All 14 tools explained - [Architecture](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/x402/docs/ARCHITECTURE.md) - Technical deep dive - [Examples](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/x402/docs/EXAMPLES.md) - Real-world use cases - [Security Guide](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/x402/docs/SECURITY.md) - Best practices --- ## Quick Start ### Claude Desktop Add to your `claude_desktop_config.json`: ```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: ```json { "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](https://chatgpt.com/#settings/Connectors/Advanced) in ChatGPT settings 2. Start the HTTP server: ```bash npx @nirholas/universal-crypto-mcp@latest --http ``` 3. In ChatGPT Settings โ†’ Apps, click **Create app** 4. Enter your server URL: `http://localhost:3001/mcp` 5. Select the app in conversations via **Developer mode** menu For detailed setup instructions, see [ChatGPT Setup Guide](https://mcp.giving/mcp-server/chatgpt-setup/). ## 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? 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE (SHIB) ``` ``` Check if this token is a honeypot: 0x... on BSC ``` ``` Scan my wallet for risky approvals: 0xYourAddress ``` ``` Is this dApp URL safe to connect to? https://suspicious-site.xyz ``` ### ๐Ÿ’ฐ Staking & Lending ``` What's the current staking APY for ETH on Lido? ``` ``` Show me Aave lending rates for USDC on Arbitrum ``` ``` What's my health factor on Aave if I borrow 1000 USDC against 2 ETH? ``` ### ๐ŸŒ‰ Cross-Chain Bridges ``` Bridge 100 USDC from Ethereum to Arbitrum ``` ``` What's the cheapest way to bridge ETH from mainnet to Base? ``` ``` Get a bridge quote for 0.5 ETH from Polygon to Optimism ``` ### โ›ฝ Gas & Network ``` What's the current gas price on Ethereum? ``` ``` Get EIP-1559 gas fees for all supported chains ``` ``` Is it cheap to transact on Arbitrum right now? ``` ### ๐Ÿ›๏ธ Governance ``` Show me active proposals on Uniswap ``` ``` What's my voting power on Compound? ``` ``` Get the results of the latest Aave governance vote ``` ### ๐Ÿ’ฌ Social Sentiment (LunarCrush) ``` What's the social sentiment for Bitcoin right now? ``` ``` Show me the top crypto influencers on social media ``` ``` What tokens are trending on Twitter/X today? ``` ``` Get the Galaxy Score for Ethereum ``` ### ๐Ÿ†” ENS Domains ``` Resolve vitalik.eth to an address ``` ``` Who owns the ENS domain "ethereum.eth"? ``` ``` Register the domain mycoolname.eth for 1 year ``` ### ๐Ÿ“ฐ Crypto News ``` Get the latest crypto news ``` ``` Search news about Bitcoin ETF ``` ``` What's the breaking news in DeFi? ``` ### ๐Ÿ“ Portfolio & Wallet ``` Show my token balances on Ethereum: 0xYourAddress ``` ``` Get all NFTs owned by vitalik.eth ``` ``` What approvals have I granted from my wallet? ``` ``` Track my portfolio across all EVM chains ``` ### ๐Ÿš€ Advanced Operations ``` Deploy a new ERC-20 token called "MyToken" (MTK) with 1 million supply on Base ``` ``` Submit this transaction privately via Flashbots to avoid MEV ``` ``` Encode a call to the transfer function for 100 USDC ``` ``` Simulate this transaction before executing: 0x... ``` ### ๐Ÿ“‰ Technical Indicators ``` Calculate RSI for Bitcoin over the last 14 days ``` ``` Get MACD signal for ETH/USDT on the 4-hour timeframe ``` ``` Show Bollinger Bands for SOL with 20-period SMA ``` ``` What's the current trend signal for BTC using multiple indicators? ``` ``` Run a momentum strategy analysis on DOGE ``` ### ๐Ÿ”ฎ Prediction Markets ``` What are the top crypto prediction markets on Polymarket? ``` ``` Search for Bitcoin price predictions ``` ``` What's the current odds for ETH reaching $5000? ``` ### ๐Ÿ“Š Events & Logs ``` Get all Transfer events for USDC in the last 100 blocks on Ethereum ``` ``` Show me Approval events for my wallet address ``` ``` Decode this transaction log: 0x... ``` ### โœ๏ธ Signatures & Messages ``` Sign this message with my wallet: "Hello World" ``` ``` Verify this signature is from vitalik.eth ``` ``` Create an EIP-712 typed data signature for a permit ``` ### ๐Ÿ“ฆ Batch Operations (Multicall) ``` Get token balances for 10 different tokens in one call ``` ``` Read multiple contract values at once from Aave ``` ``` Batch check allowances for all my approved tokens ```
--- ## ๐Ÿงช Testing We use [Vitest](https://vitest.dev/) as our testing framework with comprehensive test coverage. ### Running Tests ```bash # Run all unit tests npm test # Run tests in watch mode (re-runs on file changes) npm run test:watch # Run tests with coverage report npm run test:coverage # Run E2E tests (requires network access) npm run test:e2e # Run E2E tests in watch mode npm run test:e2e:watch # Open interactive test UI npm run test:ui ``` ### MCP Inspector Test your MCP tools interactively using the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector): ```bash npm run test:inspector ``` This opens a browser-based UI where you can: - Browse all available tools and prompts - Test tool execution with custom parameters - View tool responses and debug issues - Validate your MCP server implementation ### Test Structure ``` tests/ โ”œโ”€โ”€ setup.ts # Global test setup โ”œโ”€โ”€ e2e/ # End-to-end tests โ”‚ โ”œโ”€โ”€ evm-tools.e2e.test.ts โ”‚ โ””โ”€โ”€ market-data.e2e.test.ts โ”œโ”€โ”€ integration/ # Integration tests โ”‚ โ”œโ”€โ”€ evm-tools.test.ts โ”‚ โ””โ”€โ”€ multichain.test.ts โ””โ”€โ”€ mocks/ # Test mocks and fixtures src/ โ”œโ”€โ”€ evm/ โ”‚ โ”œโ”€โ”€ chains.test.ts # Unit tests alongside source โ”‚ โ””โ”€โ”€ modules/ โ”‚ โ””โ”€โ”€ */tools.test.ts โ””โ”€โ”€ utils/ โ”œโ”€โ”€ errors.test.ts โ”œโ”€โ”€ helper.test.ts โ””โ”€โ”€ validation.test.ts ``` --- ## Local Development ```bash # Clone git clone https://github.com/nirholas/universal-crypto-mcp cd universal-crypto-mcp # Install npm install # Run dev server (stdio - Claude) npm run dev # Run dev server (HTTP - ChatGPT) npm run dev:http # Run dev server (SSE - legacy) npm run dev:sse ``` --- ## ๐Ÿงช Testing

Code Coverage Tests

### Running Tests ```bash # Run all tests npm test # Run unit tests only npm run test:unit # Run integration tests npm run test:integration # Run E2E tests (requires network access) npm run test:e2e # Run tests with coverage report npm run test:coverage # Run tests in watch mode (development) npm run test:watch ``` ### Test Structure | Type | Location | Description | |------|----------|-------------| | **Unit** | `src/**/*.test.ts` | Test individual functions/modules | | **Integration** | `tests/integration/` | Test multiple components together | | **E2E** | `tests/e2e/` | Test full MCP server flow | ### E2E Tests End-to-end tests verify the complete tool execution flow: - **EVM Tools** - Block, balance, token operations across chains - **DeFi Tools** - Protocol TVL, yields, stablecoins via DefiLlama - **Market Data** - CoinGecko, Fear & Greed index - **Multichain** - Same operations across different networks - **Error Recovery** - Error handling, invalid inputs, edge cases ### Custom Test Utilities The project includes custom Vitest matchers for MCP responses: ```typescript // In your test file import "../utils/assertions" expect(result).toBeSuccessfulToolResponse() expect(result).toHaveJsonProperty("balance") expect(result).toContainValidAddress() expect(result).toContainToolError(/invalid/i) ``` ### Test Fixtures Reusable test data in `tests/utils/fixtures.ts`: ```typescript import { ETH_MAINNET_ADDRESSES, MOCK_TOKEN_DATA, generateRandomAddress } from "../utils/fixtures" ``` For detailed testing documentation, see [tests/README.md](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/tests/README.md). --- ## โš™๏ธ Environment Variables Configure optional API keys for enhanced features. Create a `.env` file: ```bash # Required for write operations (swaps, transfers, etc.) PRIVATE_KEY=your_private_key_here # Market Data (optional - has free tier) COINGECKO_API_KEY=your_key # https://coingecko.com/api COINSTATS_API_KEY=your_key # https://coinstats.app # Social Sentiment (optional) LUNARCRUSH_API_KEY=your_key # https://lunarcrush.com/developers # News (optional) CRYPTOPANIC_API_KEY=your_key # https://cryptopanic.com/developers # Cross-chain Swaps (optional) RUBIC_API_KEY=your_key # https://rubic.exchange # Custom RPC endpoints (optional - uses public RPCs by default) ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_KEY ARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc BASE_RPC_URL=https://mainnet.base.org ``` ### What Works Without API Keys | Feature | Without API Key | With API Key | |---------|-----------------|--------------| | Token prices | โœ… CoinGecko free tier | โœ… Higher rate limits | | DeFi analytics | โœ… DefiLlama (free) | - | | Security checks | โœ… GoPlus (free) | - | | DEX analytics | โœ… GeckoTerminal (free) | - | | Social sentiment | โŒ | โœ… LunarCrush | | Crypto news | โŒ | โœ… CryptoPanic | | Cross-chain swaps | โœ… Basic | โœ… Best routes | --- ## Documentation https://mcp.giving --- ## ๏ฟฝ Documentation & Examples ### ๐Ÿ“– Documentation Comprehensive guides and API references: - **[Getting Started](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/getting-started/)** - [Installation Guide](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/getting-started/installation.md) - [Configuration](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/getting-started/configuration.md) - [Your First MCP Tool](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/getting-started/first-tool.md) - [Deployment Guide](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/getting-started/deployment.md) - **[Package Documentation](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/packages/)** - [Core Package](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/packages/core.md) - [Trading](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/packages/trading.md) - [Market Data](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/packages/market-data.md) - [Wallets](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/packages/wallets.md) - [DeFi](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/packages/defi.md) - [Payments (x402)](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/packages/payments.md) - **[x402 Deploy Documentation](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/x402-deploy/)** - [Overview](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/x402-deploy/overview.md) - [Quick Start](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/x402-deploy/quick-start.md) - [Configuration](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/x402-deploy/configuration.md) - [Providers](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/x402-deploy/providers.md) - [Discovery](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/x402-deploy/discovery.md) - **[Contributing](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/contributing/)** - [Development Guide](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/contributing/development.md) - [Testing](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/contributing/testing.md) - [Releases](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/docs/content/contributing/releases.md) ### ๐Ÿ’ป Examples Working code examples you can run and modify: - **[Basic MCP Server](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/examples/basic-mcp-server/)** - Minimal MCP server with market data tools - **[Paid API Example](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/examples/paid-api/)** - Add x402 payments to Express API - **[Trading Bot](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/examples/trading-bot/)** - Automated trading bot with RSI + MA strategy - **[Full Deployment](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/examples/full-deployment/)** - Production-ready server with all features Each example includes: - Complete source code - README with setup instructions - Package configuration - Environment setup guide --- ## ๏ฟฝ๐Ÿ—บ๏ธ Roadmap A comprehensive roadmap of all crypto/blockchain/DeFi/Web3 features to be implemented. ### Legend - โœ… Implemented - ๐Ÿšง In Progress - ๐Ÿ“‹ Planned
๐Ÿ”— Core Blockchain Operations (click to expand) ### ๐Ÿ”— Core Blockchain Operations #### Network & Chain | Feature | Status | |---------|--------| | Get chain ID, block number, gas price | โœ… | | Get network status/health | โœ… | | Switch networks/chains | โœ… | | Get supported networks list | โœ… | | Get RPC endpoints | โœ… | | Estimate block time | โœ… | | Get chain metadata (name, symbol, explorers) | โœ… | | Get finality status | โœ… | | Get mempool/pending transactions | โœ… | | Get network peers/nodes | โœ… | | Get gas oracle | โœ… | #### Blocks | Feature | Status | |---------|--------| | Get block by number/hash | โœ… | | Get latest block | โœ… | | Get block transactions | โœ… | | Get block receipts | โœ… | | Get uncle blocks | โœ… | | Subscribe to new blocks | ๐Ÿ“‹ | | Get block rewards | โœ… | | Get block gas used/limit | โœ… | | Get block range | โœ… | | Get blocks by miner | โœ… | #### Transactions | Feature | Status | |---------|--------| | Send transaction | โœ… | | Get transaction by hash | โœ… | | Get transaction receipt | โœ… | | Get transaction status | โœ… | | Estimate gas | โœ… | | Speed up transaction (replace with higher gas) | โœ… | | Cancel transaction | โœ… | | Decode transaction input | โœ… | | Simulate transaction | โœ… | | Get transaction trace | ๐Ÿ“‹ | | Get internal transactions | ๐Ÿ“‹ | | Batch transactions | โœ… | | Get pending transactions | โœ… | | Get transaction history by address | โœ… | #### Accounts/Wallets | Feature | Status | |---------|--------| | Get balance (native/token) | โœ… | | Get nonce | โœ… | | Get transaction count | โœ… | | Create wallet | โœ… | | Import wallet (private key/mnemonic) | โœ… | | Export private key | ๐Ÿ“‹ | | Sign message | โœ… | | Verify signature | โœ… | | Get address from private key | โœ… | | Generate mnemonic | โœ… | | Derive addresses (HD wallet) | โœ… | | Multi-sig wallet operations | ๐Ÿ“‹ | | Get wallet permissions | ๐Ÿ“‹ | | Revoke approvals | โœ… | | Account abstraction (ERC-4337) | ๐Ÿ“‹ | | Social recovery | ๐Ÿ“‹ | | Hardware wallet integration | ๐Ÿ“‹ | | Get wallet portfolio | โœ… | | Get token approvals | โœ… |
๐Ÿ’ฐ Token Operations (click to expand) ### ๐Ÿ’ฐ Token Operations #### Native Tokens | Feature | Status | |---------|--------| | Get native balance | โœ… | | Transfer native tokens | โœ… | | Wrap/unwrap native tokens (WETH, WBNB) | โœ… | #### ERC-20 (Fungible Tokens) | Feature | Status | |---------|--------| | Get token info (name, symbol, decimals, total supply) | โœ… | | Get token balance | โœ… | | Transfer tokens | โœ… | | Approve spending | โœ… | | Get allowance | โœ… | | Transfer from (delegated) | โœ… | | Burn tokens | โœ… | | Mint tokens | โœ… | | Get token holders | โœ… | | Get token transfers | โœ… | | Permit (gasless approvals - EIP-2612) | โœ… | | Batch transfers | โœ… | | Token snapshots | ๐Ÿ“‹ | | Get token supply info | โœ… | | Check/revoke token approval | โœ… | #### ERC-721 (NFTs) | Feature | Status | |---------|--------| | Get NFT metadata | โœ… | | Get NFT owner | โœ… | | Transfer NFT | โœ… | | Approve NFT | โœ… | | Set approval for all | โœ… | | Get NFTs by owner | โœ… | | Get NFT collection info | โœ… | | Mint NFT | ๐Ÿ“‹ | | Burn NFT | ๐Ÿ“‹ | | Get NFT transfer history | ๐Ÿ“‹ | | Get NFT traits/attributes | โœ… | | Get NFT rarity | ๐Ÿ“‹ | | Verify NFT authenticity | ๐Ÿ“‹ | | Batch transfer NFTs | โœ… | | Check NFT approval | โœ… | | Revoke NFT approval | โœ… | | Approve for marketplace | โœ… | | Fetch NFT metadata from URI | โœ… | #### ERC-1155 (Multi-Token) | Feature | Status | |---------|--------| | Get token balance (fungible + NFT) | โœ… | | Batch transfers | ๐Ÿ“‹ | | Batch balance queries | ๐Ÿ“‹ | | Safe transfer | โœ… | | Get URI | โœ… | #### Other Token Standards | Feature | Status | |---------|--------| | ERC-777 (advanced fungible) | ๐Ÿ“‹ | | ERC-3525 (semi-fungible) | ๐Ÿ“‹ | | ERC-4626 (tokenized vaults) | ๐Ÿ“‹ | | ERC-6551 (token-bound accounts) | ๐Ÿ“‹ | | ERC-404 (hybrid tokens) | ๐Ÿ“‹ | | Soulbound tokens (SBTs) | ๐Ÿ“‹ |
๐Ÿฆ DeFi - DEX, Lending, Staking, Derivatives (click to expand) ### ๐Ÿฆ DeFi - Decentralized Exchanges (DEX) #### Swaps | Feature | Status | |---------|--------| | Get quote/price | โœ… | | Swap exact tokens for tokens | โœ… | | Swap tokens for exact tokens | โœ… | | Multi-hop swaps | โœ… | | Split route swaps | ๐Ÿ“‹ | | Cross-DEX aggregation | โœ… | | Limit orders | ๐Ÿ“‹ | | TWAP orders (time-weighted) | ๐Ÿ“‹ | | Stop-loss orders | ๐Ÿ“‹ | | Get slippage estimate | โœ… | | Get price impact | โœ… | | MEV protection (private transactions) | ๐Ÿ“‹ | #### DEX Analytics | Feature | Status | |---------|--------| | Get trending pools | โœ… | | Get new pools | โœ… | | Get top pools by volume | โœ… | | Get pool OHLCV data | โœ… | | Get pool trades | โœ… | | Get token pools | โœ… | | Get DEX list | โœ… | | Search pools cross-chain | โœ… | | Get token price by contract | โœ… | | Get pool transactions | โœ… | | Multi-token price lookup | โœ… | #### Liquidity Provision | Feature | Status | |---------|--------| | Add liquidity | โœ… | | Remove liquidity | โœ… | | Get LP token balance | โœ… | | Get pool reserves | โœ… | | Get pool APY/APR | ๐Ÿ“‹ | | Get impermanent loss estimate | ๐Ÿ“‹ | | Concentrated liquidity (Uniswap V3) | ๐Ÿ“‹ | | Set price range | ๐Ÿ“‹ | | Collect fees | ๐Ÿ“‹ | | Rebalance position | ๐Ÿ“‹ | | Add liquidity with native token | โœ… | | Calculate arbitrage opportunities | โœ… | #### AMM Types Support | Feature | Status | |---------|--------| | Constant product (x*y=k) | โœ… | | Stable swap (Curve) | ๐Ÿ“‹ | | Concentrated liquidity | ๐Ÿ“‹ | | Order book hybrid | ๐Ÿ“‹ | | Virtual AMM (perpetuals) | ๐Ÿ“‹ | --- ### ๐Ÿฆ DeFi - Lending & Borrowing #### Lending | Feature | Status | |---------|--------| | Supply/deposit assets | โœ… | | Withdraw assets | โœ… | | Get supply APY | โœ… | | Get supplied balance | โœ… | | Get utilization rate | ๐Ÿ“‹ | | Enable/disable as collateral | ๐Ÿ“‹ | #### Borrowing | Feature | Status | |---------|--------| | Borrow assets | โœ… | | Repay debt | โœ… | | Get borrow APY | โœ… | | Get borrowed balance | โœ… | | Get health factor | โœ… | | Get liquidation threshold | โœ… | | Get max borrowable amount | ๐Ÿ“‹ | | Flash loans | โœ… | | Get borrow limit | ๐Ÿ“‹ | | Get flash loan info | โœ… | #### Liquidations | Feature | Status | |---------|--------| | Liquidate unhealthy positions | ๐Ÿ“‹ | | Get liquidatable positions | โœ… | | Get liquidation bonus | ๐Ÿ“‹ | | Partial liquidations | ๐Ÿ“‹ | #### Isolated Markets | Feature | Status | |---------|--------| | Supply to isolated pool | ๐Ÿ“‹ | | Borrow from isolated pool | ๐Ÿ“‹ | | Get isolation mode debt ceiling | ๐Ÿ“‹ | --- ### ๐Ÿฅฉ DeFi - Staking #### Native Staking | Feature | Status | |---------|--------| | Stake native tokens | โœ… | | Unstake/withdraw | โœ… | | Claim rewards | โœ… | | Get staking APY | โœ… | | Get validator list | ๐Ÿ“‹ | | Delegate to validator | ๐Ÿ“‹ | | Redelegate | ๐Ÿ“‹ | | Get unbonding period | ๐Ÿ“‹ | #### Liquid Staking | Feature | Status | |---------|--------| | Stake for liquid staking tokens (stETH, rETH) | โœ… | | Unwrap liquid staking tokens | โœ… | | Get exchange rate | โœ… | | Get staking rewards rate | โœ… | #### LP Staking/Farming | Feature | Status | |---------|--------| | Stake LP tokens | โœ… | | Unstake LP tokens | โœ… | | Claim farming rewards | โœ… | | Get farming APY | โœ… | | Compound rewards | ๐Ÿ“‹ | | Get pending rewards | โœ… | | Boost rewards (veTokens) | ๐Ÿ“‹ | #### Restaking | Feature | Status | |---------|--------| | Restake assets (EigenLayer) | ๐Ÿ“‹ | | Get restaking points | ๐Ÿ“‹ | | Choose operators | ๐Ÿ“‹ | | Withdraw from restaking | ๐Ÿ“‹ | --- ### ๐Ÿ“Š DeFi - Derivatives #### Perpetual Futures | Feature | Status | |---------|--------| | Open long/short position | ๐Ÿ“‹ | | Close position | ๐Ÿ“‹ | | Add/remove margin | ๐Ÿ“‹ | | Set leverage | ๐Ÿ“‹ | | Get funding rate | ๐Ÿ“‹ | | Get open interest | ๐Ÿ“‹ | | Get liquidation price | ๐Ÿ“‹ | | Set stop-loss/take-profit | ๐Ÿ“‹ | | Get PnL | ๐Ÿ“‹ | | Partial close | ๐Ÿ“‹ | #### Options | Feature | Status | |---------|--------| | Buy call/put options | ๐Ÿ“‹ | | Sell/write options | ๐Ÿ“‹ | | Exercise options | ๐Ÿ“‹ | | Get option greeks | ๐Ÿ“‹ | | Get implied volatility | ๐Ÿ“‹ | | Get option chain | ๐Ÿ“‹ | | Spread strategies | ๐Ÿ“‹ | #### Synthetics | Feature | Status | |---------|--------| | Mint synthetic assets | ๐Ÿ“‹ | | Burn synthetic assets | ๐Ÿ“‹ | | Get collateral ratio | ๐Ÿ“‹ | | Get synthetic price feed | ๐Ÿ“‹ | | Liquidate synthetic positions | ๐Ÿ“‹ |
๐ŸŒ‰ Cross-Chain, Governance, Security, NFTs (click to expand) ### ๐ŸŒ‰ Cross-Chain & Bridges #### Bridging | Feature | Status | |---------|--------| | Bridge tokens cross-chain | โœ… | | Get bridge quote | โœ… | | Get bridge status | โœ… | | Get supported chains | โœ… | | Get supported tokens | โœ… | | Claim bridged tokens | ๐Ÿ“‹ | | Get bridge fees | โœ… | | Get estimated time | โœ… | #### Cross-Chain Messaging | Feature | Status | |---------|--------| | Send cross-chain message | ๐Ÿ“‹ | | Receive cross-chain message | ๐Ÿ“‹ | | LayerZero operations | ๐Ÿ“‹ | | Axelar operations | ๐Ÿ“‹ | | Wormhole operations | ๐Ÿ“‹ | | CCIP (Chainlink) | ๐Ÿ“‹ | | Hyperlane operations | ๐Ÿ“‹ | #### Atomic Swaps | Feature | Status | |---------|--------| | Initiate atomic swap | ๐Ÿ“‹ | | Complete atomic swap | ๐Ÿ“‹ | | Refund atomic swap | ๐Ÿ“‹ | --- ### ๐Ÿ—ณ๏ธ Governance #### Voting | Feature | Status | |---------|--------| | Create proposal | โœ… | | Vote on proposal | โœ… | | Delegate votes | โœ… | | Get voting power | โœ… | | Get proposal state | โœ… | | Queue proposal | โœ… | | Execute proposal | โœ… | | Cancel proposal | โœ… | | Get vote receipt | โœ… | #### Token Locking | Feature | Status | |---------|--------| | Lock tokens for voting (veTokens) | ๐Ÿ“‹ | | Extend lock period | ๐Ÿ“‹ | | Increase locked amount | ๐Ÿ“‹ | | Withdraw unlocked tokens | ๐Ÿ“‹ | | Get lock info | ๐Ÿ“‹ | #### Snapshot (Off-chain) | Feature | Status | |---------|--------| | Create space | ๐Ÿ“‹ | | Create off-chain proposal | ๐Ÿ“‹ | | Vote off-chain | ๐Ÿ“‹ | | Get snapshot results | ๐Ÿ“‹ | --- ### ๐Ÿ” Security & Analysis #### Contract Analysis | Feature | Status | |---------|--------| | Verify contract source | โœ… | | Get contract ABI | โœ… | | Check if contract is proxy | โœ… | | Get implementation address | โœ… | | Detect honeypots | โœ… | | Check for rug pull risks | โœ… | | GoPlus token security check | โœ… | | GoPlus rug pull detection | โœ… | | Audit score | ๐Ÿ“‹ | | Get contract creator | โœ… | | Get contract age | โœ… | | Detect malicious functions | โœ… | #### Token Security | Feature | Status | |---------|--------| | Check token safety | โœ… | | Get holder distribution | โœ… | | Check if mintable | โœ… | | Check if pausable | โœ… | | Check for hidden fees | โœ… | | Check liquidity locked | โœ… | | Get top holders | โœ… | | Check ownership renounced | โœ… | | GoPlus NFT security | โœ… | | GoPlus approval security | โœ… | #### Wallet Security | Feature | Status | |---------|--------| | Get approval list | โœ… | | Revoke approvals | โœ… | | Check for drainers | โœ… | | Simulate transaction safety | โœ… | | Get wallet risk score | ๐Ÿ“‹ | | GoPlus address security | โœ… | | GoPlus dApp phishing check | โœ… | | GoPlus signature decode | โœ… | --- ### ๐Ÿ“ˆ Price & Market Data #### Price Feeds | Feature | Status | |---------|--------| | Get current price | โœ… | | Get historical prices | โœ… | | Get OHLCV data | โœ… | | Get price from DEX | โœ… | | Get price from oracle (Chainlink, Pyth) | โœ… | | Get TWAP price | โœ… | | Get price across exchanges | โœ… | | Get volume | โœ… | | Get market cap | โœ… | | Get trending coins | โœ… | | Get token by contract address | โœ… | | Get exchange rates | โœ… | | Get coin categories | โœ… | | Get derivatives data | โœ… | | Get company BTC/ETH holdings | โœ… | #### Analytics | Feature | Status | |---------|--------| | Get TVL (Total Value Locked) | โœ… | | Get protocol metrics | โœ… | | Get yield farming APYs | โœ… | | Get gas tracker | โœ… | | Get whale transactions | ๐Ÿ“‹ | | Get token flow analysis | ๐Ÿ“‹ | | Get DEX volume | โœ… | | Get lending metrics | ๐Ÿ“‹ | | Get DeFi fees & revenue | โœ… | | Get stablecoin data | โœ… | | Get bridge volumes | โœ… | | Get liquidation data | โœ… | | Get DeFi hacks history | โœ… | | Get perpetuals data | โœ… | --- ### ๐Ÿ†” Identity & Domains #### ENS (Ethereum Name Service) | Feature | Status | |---------|--------| | Register domain | โœ… | | Resolve name to address | โœ… | | Reverse resolve address to name | โœ… | | Set primary name | ๐Ÿ“‹ | | Set records (text, address, content hash) | โœ… | | Transfer domain | โœ… | | Renew domain | โœ… | | Get expiry date | ๐Ÿ“‹ | | Set subdomains | โœ… | #### Other Name Services | Feature | Status | |---------|--------| | Unstoppable Domains | ๐Ÿ“‹ | | Space ID (.bnb) | ๐Ÿ“‹ | | Bonfida (.sol) | ๐Ÿ“‹ | | ANS (.avax) | ๐Ÿ“‹ | #### DIDs & Verifiable Credentials | Feature | Status | |---------|--------| | Create DID | ๐Ÿ“‹ | | Resolve DID | ๐Ÿ“‹ | | Issue verifiable credential | ๐Ÿ“‹ | | Verify credential | ๐Ÿ“‹ | | Revoke credential | ๐Ÿ“‹ | --- ### ๐Ÿ–ผ๏ธ NFT & Metaverse #### NFT Marketplace | Feature | Status | |---------|--------| | List NFT for sale | ๐Ÿ“‹ | | Buy NFT | ๐Ÿ“‹ | | Make offer | ๐Ÿ“‹ | | Accept offer | ๐Ÿ“‹ | | Cancel listing | ๐Ÿ“‹ | | Auction NFT | ๐Ÿ“‹ | | Bid on auction | ๐Ÿ“‹ | | Get floor price | ๐Ÿ“‹ | | Get collection stats | ๐Ÿ“‹ | #### NFT Creation | Feature | Status | |---------|--------| | Deploy NFT collection | ๐Ÿ“‹ | | Mint NFTs | ๐Ÿ“‹ | | Set royalties | ๐Ÿ“‹ | | Set metadata | ๐Ÿ“‹ | | Reveal NFTs | ๐Ÿ“‹ | | Whitelist management | ๐Ÿ“‹ | | Airdrop NFTs | ๐Ÿ“‹ | #### NFT Finance | Feature | Status | |---------|--------| | NFT collateralized loans | ๐Ÿ“‹ | | NFT fractionalization | ๐Ÿ“‹ | | NFT renting | ๐Ÿ“‹ | | NFT staking | ๐Ÿ“‹ | #### Metaverse | Feature | Status | |---------|--------| | Buy virtual land | ๐Ÿ“‹ | | Sell virtual land | ๐Ÿ“‹ | | Build on land | ๐Ÿ“‹ | | Transfer assets between metaverses | ๐Ÿ“‹ | --- ### ๐Ÿ”” Events & Subscriptions #### Event Listening | Feature | Status | |---------|--------| | Subscribe to contract events | ๐Ÿ“‹ | | Subscribe to pending transactions | ๐Ÿ“‹ | | Subscribe to new blocks | ๐Ÿ“‹ | | Subscribe to logs | ๐Ÿ“‹ | | Filter events by topic | โœ… | | Get historical events | โœ… | | Decode event logs | โœ… | #### Webhooks & Notifications | Feature | Status | |---------|--------| | Set up webhook for events | ๐Ÿ“‹ | | Get transaction notifications | ๐Ÿ“‹ | | Get price alerts | ๐Ÿ“‹ | | Get whale alerts | ๐Ÿ“‹ | | Get governance notifications | ๐Ÿ“‹ | --- ### ๐Ÿ“œ Smart Contract Interaction #### Read Operations | Feature | Status | |---------|--------| | Call view/pure functions | โœ… | | Get storage at slot | โœ… | | Get contract bytecode | โœ… | | Multicall (batch reads) | โœ… | | Static call simulation | โœ… | #### Write Operations | Feature | Status | |---------|--------| | Send transaction to contract | โœ… | | Encode function call | โœ… | | Decode function result | โœ… | | Estimate gas for call | โœ… | | Batch transactions | โœ… | #### Contract Deployment | Feature | Status | |---------|--------| | Deploy contract | โœ… | | Deploy with CREATE2 | โœ… | | Deploy proxy contract | โœ… | | Upgrade proxy | โœ… | | Verify on explorer | โœ… | --- ### ๐Ÿค– Advanced Features #### MEV & Flashbots | Feature | Status | |---------|--------| | Submit private transaction | โœ… | | Submit bundle | โœ… | | Get MEV opportunities | โœ… | | Backrun protection | โœ… | | Frontrun protection | โœ… | | Sandwich protection | โœ… | #### Account Abstraction (ERC-4337) | Feature | Status | |---------|--------| | Create smart account | ๐Ÿ“‹ | | Execute user operation | ๐Ÿ“‹ | | Batch operations | ๐Ÿ“‹ | | Sponsor gas (Paymaster) | ๐Ÿ“‹ | | Session keys | ๐Ÿ“‹ | | Social recovery | ๐Ÿ“‹ | #### Intents & Solvers | Feature | Status | |---------|--------| | Submit intent | ๐Ÿ“‹ | | Get solver quotes | ๐Ÿ“‹ | | Execute via solver | ๐Ÿ“‹ | #### Oracles | Feature | Status | |---------|--------| | Get Chainlink price | โœ… | | Get Pyth price | ๐Ÿ“‹ | | Get Band Protocol price | ๐Ÿ“‹ | | Get API3 price | ๐Ÿ“‹ | | Request randomness (VRF) | ๐Ÿ“‹ | | Request external data | ๐Ÿ“‹ | --- ### ๐Ÿ› ๏ธ Utility Functions #### Gas | Feature | Status | |---------|--------| | Get gas price | โœ… | | Get priority fee | โœ… | | Get base fee | โœ… | | Get gas history | โœ… | | Estimate gas for transaction | โœ… | | Get EIP-1559 fees | โœ… | #### Encoding/Decoding | Feature | Status | |---------|--------| | ABI encode | โœ… | | ABI decode | โœ… | | Keccak256 hash | โœ… | | Pack/unpack data | โœ… | | Sign typed data (EIP-712) | โœ… | #### Address Utils | Feature | Status | |---------|--------| | Validate address | โœ… | | Checksum address | โœ… | | Get address from ENS | โœ… | | Check if contract | โœ… | | Get contract type | ๐Ÿ“‹ | --- ### ๐Ÿ“ฐ Data & Information #### News & Social | Feature | Status | |---------|--------| | Get crypto news | โœ… | | Search crypto news | โœ… | | Get DeFi news | โœ… | | Get Bitcoin news | โœ… | | Get breaking news | โœ… | | Get social sentiment | โœ… | | Get influencer rankings | โœ… | | Get trending topics | โœ… | | Get coin social metrics | โœ… | | Get social feed | โœ… | | Get market sentiment index | โœ… | | Get Galaxy Score | โœ… | | Get AltRank | โœ… | | Get Twitter mentions | ๐Ÿ“‹ | | Get Discord activity | ๐Ÿ“‹ | | Get GitHub activity | ๐Ÿ“‹ | #### On-Chain Data | Feature | Status | |---------|--------| | Get token holders | ๐Ÿ“‹ | | Get whale wallets | ๐Ÿ“‹ | | Get smart money movements | ๐Ÿ“‹ | | Get protocol users | ๐Ÿ“‹ | | Get daily active addresses | ๐Ÿ“‹ | | Get network hash rate | ๐Ÿ“‹ |
๐Ÿ›๏ธ Institutional & Compliance (click to expand) ### ๐Ÿ›๏ธ Institutional & Compliance #### KYC/AML | Feature | Status | |---------|--------| | Wallet screening | ๐Ÿ“‹ | | Transaction monitoring | ๐Ÿ“‹ | | Risk scoring | ๐Ÿ“‹ | | Sanctions checking | ๐Ÿ“‹ | #### Custody | Feature | Status | |---------|--------| | Multi-sig operations | ๐Ÿ“‹ | | Cold storage | ๐Ÿ“‹ | | Hot wallet management | ๐Ÿ“‹ | | Policy enforcement | ๐Ÿ“‹ | #### Reporting | Feature | Status | |---------|--------| | Tax reporting | ๐Ÿ“‹ | | Portfolio tracking | โœ… | | P&L reporting | ๐Ÿ“‹ | | Transaction history export | ๐Ÿ“‹ |
--- ## Data Sources This MCP server integrates with the following APIs: | Provider | Data Type | API Key Required | |----------|-----------|------------------| | [CoinGecko](https://coingecko.com) | Market data, prices, OHLCV | Optional (free tier) | | [CoinStats](https://coinstats.app) | Portfolio, prices, wallets | Yes | | [DefiLlama](https://defillama.com) | TVL, yields, fees, protocols | No | | [LunarCrush](https://lunarcrush.com) | Social sentiment, influencers | Yes | | [GoPlus](https://gopluslabs.io) | Security analysis, honeypot detection | No | | [GeckoTerminal](https://geckoterminal.com) | DEX pools, trades, OHLCV | No | | [DexPaprika](https://dexpaprika.com) | DEX analytics, pools | No | | [CryptoPanic](https://cryptopanic.com) | Crypto news | Yes | | [Alternative.me](https://alternative.me) | Fear & Greed Index | No | --- ## Related MCP Servers Additional specialized MCP servers, maintained in their own repositories: | Server | Description | Tools | |--------|-------------|-------| | [Binance-MCP](https://github.com/nirholas/Binance-MCP) | Binance.com global exchange API | 156+ tools | | [Binance-US-MCP](https://github.com/nirholas/Binance-US-MCP) | Binance.US exchange API | 71+ tools | ### Binance.com Server Full Binance global API coverage including: - Spot trading, wallet, staking, mining - Convert, Simple Earn, Algo Trading (TWAP/VP) - NFT, Pay, Copy Trading, Dual Investment - VIP Loans, C2C/P2P, Fiat ```json { "mcpServers": { "binance": { "command": "npx", "args": ["ts-node", "binance-mcp-server/src/index.ts"], "env": { "BINANCE_API_KEY": "your_key", "BINANCE_API_SECRET": "your_secret" } } } } ``` ### Binance.US Server US-regulated exchange with: - Market data, spot trading, wallet - Staking, OTC, sub-accounts - Custodial solutions (institutional) ```json { "mcpServers": { "binance-us": { "command": "node", "args": ["binance-us-mcp-server/build/index.js"], "env": { "BINANCE_US_API_KEY": "your_key", "BINANCE_US_API_SECRET": "your_secret" } } } } ``` --- ## Credits Built by **[nich](https://x.com/nichxbt)** ([github.com/nirholas](https://github.com/nirholas))

Follow on X

--- ## ๐Ÿข Who's Using This? Universal Crypto MCP is used by developers and teams building: - ๐Ÿค– **AI Trading Bots** - Automated portfolio management - ๐Ÿ“Š **Analytics Dashboards** - DeFi monitoring tools - ๐Ÿ”’ **Security Auditors** - Token vetting workflows - ๐Ÿฆ **DeFi Applications** - Cross-chain operations - ๐Ÿ“ฑ **Mobile Apps** - Crypto portfolio trackers - ๐ŸŽ“ **Educational Tools** - Blockchain learning platforms > **Using Universal Crypto MCP?** [Let us know!](https://github.com/nirholas/universal-crypto-mcp/issues/new?title=Add%20my%20project%20to%20Who's%20Using%20This) We'd love to feature your project. --- ## ๐Ÿค Contributing We welcome contributions of all kinds! Please read our [Contributing Guide](https://github.com/nirholas/universal-crypto-mcp/blob/HEAD/CONTRIBUTING.md) for details. ### Quick Start for Contributors ```bash # Fork and clone the repo git clone https://github.com/YOUR_USERNAME/universal-crypto-mcp.git cd universal-crypto-mcp # Install dependencies npm install # Create a feature branch git checkout -b feat/your-feature # Make your changes, then run checks npm run lint # Check code style npm test # Run tests npm run test:coverage # Check coverage # Commit with conventional commits git commit -m "feat(module): add new feature" # Push and create a PR git push origin feat/your-feature ``` ### Code Style We use **Prettier** for formatting and **ESLint** for linting: ```bash npm run format # Format code npm run lint # Check types and lint npm run lint:fix # Auto-fix issues ``` ### Ways to Contribute - ๐Ÿ› [Report bugs](https://github.com/nirholas/universal-crypto-mcp/issues/new?template=bug_report.yml) - ๐Ÿ’ก [Request features](https://github.com/nirholas/universal-crypto-mcp/issues/new?template=feature_request.yml) - ๐Ÿ“– [Improve docs](https://github.com/nirholas/universal-crypto-mcp/edit/main/README.md) - ๐Ÿ”ง Submit pull requests - โญ [Star the repo](https://github.com/nirholas/universal-crypto-mcp/stargazers) --- ## ๐Ÿ“œ License Apache-2.0 ยฉ [nich](https://github.com/nirholas) ---

Stop copy-pasting blockchain queries. Let AI do it.
Made with ๐Ÿ’œ for the crypto community

Star on GitHub

--- ## ๐ŸŒ Live HTTP Deployment **Universal Crypto MCP** is deployed and accessible over HTTP via [MCP Streamable HTTP](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http) transport โ€” no local installation required. **Endpoint:** ``` https://modelcontextprotocol.name/mcp/universal-crypto-mcp ``` ### Connect from any MCP Client Add to your MCP client configuration (Claude Desktop, Cursor, SperaxOS, etc.): ```json { "mcpServers": { "universal-crypto-mcp": { "type": "http", "url": "https://modelcontextprotocol.name/mcp/universal-crypto-mcp" } } } ``` ### Available Tools (11) | Tool | Description | |------|-------------| | `get_price` | Get crypto prices | | `get_market_overview` | Market overview | | `get_trending` | Trending coins | | `search_coins` | Search coins | | `get_coin_detail` | Coin details | | `get_global_stats` | Global stats | | `get_defi_protocols` | DeFi protocols | | `get_protocol_detail` | Protocol detail | | `get_chain_tvl` | Chain TVL | | `get_gas_prices` | Ethereum gas prices | | `get_token_info` | Token by contract | ### Example Requests **Get crypto prices:** ```bash curl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_price","arguments":{"ids":"bitcoin","vs_currencies":"usd"}}}' ``` **Market overview:** ```bash curl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_market_overview","arguments":{"limit":10}}}' ``` **Trending coins:** ```bash curl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_trending","arguments":{}}}' ``` ### List All Tools ```bash curl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' ``` ### Also Available On - **[SperaxOS](https://speraxos.vercel.app)** โ€” Browse and install from the [MCP marketplace](https://speraxos.vercel.app/community/mcp) - **All 27 MCP servers** โ€” See the full catalog at [modelcontextprotocol.name](https://modelcontextprotocol.name) > Powered by [modelcontextprotocol.name](https://modelcontextprotocol.name) โ€” the open MCP HTTP gateway