{ "markdown": "# 🤖💰 Universal Crypto MCP \n \n

\n

\n██╗   ██╗███╗   ██╗██╗██╗   ██╗███████╗██████╗ ███████╗ █████╗ ██╗     \n██║   ██║████╗  ██║██║██║   ██║██╔════╝██╔══██╗██╔════╝██╔══██╗██║     \n██║   ██║██╔██╗ ██║██║██║   ██║█████╗  ██████╔╝███████╗███████║██║      \n██║   ██║██║╚██╗██║██║╚██╗ ██╔╝██╔══╝  ██╔══██╗╚════██║██╔══██║██║     \n╚██████╔╝██║ ╚████║██║ ╚████╔╝ ███████╗██║  ██║███████║██║  ██║███████╗\n ╚═════╝ ╚═╝  ╚═══╝╚═╝  ╚═══╝  ╚══════╝╚═╝  ╚═╝╚══════╝╚═╝  ╚═╝╚══════╝\n           ██████╗██████╗ ██╗   ██╗██████╗ ████████╗ ██████╗            \n          ██╔════╝██╔══██╗╚██╗ ██╔╝██╔══██╗╚══██╔══╝██╔═══██╗           \n          ██║     ██████╔╝ ╚████╔╝ ██████╔╝   ██║   ██║   ██║           \n          ██║     ██╔══██╗  ╚██╔╝  ██╔═══╝    ██║   ██║   ██║           \n          ╚██████╗██║  ██║   ██║   ██║        ██║   ╚██████╔╝           \n           ╚═════╝╚═╝  ╚═╝   ╚═╝   ╚═╝        ╚═╝    ╚═════╝            \n                          ███╗   ███╗ ██████╗██████╗                     \n                          ████╗ ████║██╔════╝██╔══██╗                    \n                          ██╔████╔██║██║     ██████╔╝                    \n                          ██║╚██╔╝██║██║     ██╔═══╝                     \n                          ██║ ╚═╝ ██║╚██████╗██║                         \n                          ╚═╝     ╚═╝ ╚═════╝╚═╝                         \n

\n

\n\n```bash\nnpx @nirholas/universal-crypto-mcp\n```\n\n

\n $\"npm$ \n $\"npm$ \n $\"x402$ \n $\"chains\"$ \n

\n\n

\n $\"MCP$ \n $\"TypeScript\"$ \n $\"Node.js$ \n $\"License:$ \n

\n\n

\n $\"GitHub$ \n $\"Issues\"$ \n

\n\n

\n $\"Universal$ \n

\n\n## ✨ What's New: AI Service Marketplace\n\n> **Monetize your AI services & discover the best APIs!** 💸\n\nThe **AI Service Marketplace** is a complete ecosystem for AI service discovery, monetization, and reputation management:\n\n- 🏪 **Register your AI service** - Instant monetization with pay-per-use or subscriptions\n- 🔍 **AI agents discover services** - Automatic discovery by category, price, and rating\n- ⭐ **On-chain reputation** - Build trust with verified ratings and reviews\n- 💳 **Flexible pricing** - Pay-per-use, subscriptions, free tiers\n- 📊 **Analytics dashboard** - Track usage, revenue, and performance\n- 🔒 **Secure payments** - Escrow, dispute resolution, automatic refunds\n\n**[Learn more →](MARKETPLACE.md)** | **[View Tutorial →](docs/content/tutorials/marketplace-service.md)**\n\n### x402 Payment Protocol\n\n**AI agents can now pay for things on the internet!** 💸\n\n```\nUser: \"Get premium weather data for Tokyo\"\n\nClaude: 🔍 Checking x402 balance... $45.23 USDs\n 💳 Paying $0.01 for premium API access...\n ✅ Payment confirmed! Here's your detailed forecast:\n \n 🌤️ Tokyo Weather (7-day premium forecast)...\n```\n\n**AI agents can now:**\n- 💸 **Pay for premium APIs** automatically\n- 🏪 **Sell their own services** to other agents\n- 🔄 **Trade with other AI agents** peer-to-peer\n- ⛓️ **Work across EVM + Solana** chains\n\n> ⭐ **If you find this useful, please star the repo!** It helps others discover this project.\n\n---\n\nA Universal Model Context Protocol server for all EVM-compatible networks + Solana.\n\nEnable AI agents (Claude, ChatGPT, Cursor) to interact with any EVM blockchain through natural language.\n\n## 🆚 Why Universal Crypto MCP?\n\n| Feature | Universal Crypto MCP | Other MCP Servers |\n|---------|---------------------|-------------------|\n| **Tools** | 380+ tools | 10-50 tools |\n| **Chains** | 20+ chains (EVM + multi-chain) | 1-3 chains |\n| **DEX Support** | Multi-aggregator (1inch, 0x, ParaSwap) | Single DEX or none |\n| **Security** | GoPlus, honeypot, rug pull detection | Basic or none |\n| **DeFi** | Aave, Compound, Lido, Uniswap | Limited |\n| **Market Data** | CoinGecko, DefiLlama, LunarCrush | Basic prices |\n| **Bridges** | LayerZero, Stargate, Wormhole | None |\n| **MEV Protection** | Flashbots integration | None |\n| **Transport** | stdio, HTTP, SSE | Usually only stdio |\n| **ChatGPT Support** | ✅ Native HTTP mode | ❌ Most don't |\n\n---\n\n## 📦 Package Structure\n\nThe most comprehensive crypto MCP monorepo with **10+ integrated packages** from the best MIT-licensed projects:\n\n```\npackages/\n├── core/ # Shared types, utilities, configuration\n├── trading/ # CEX exchange integrations\n│ ├── binance/ # Binance spot & futures\n│ ├── binance-us/ # Binance US\n│ └── bybit/ # Bybit exchange (ethancod1ng) ⭐ NEW\n├── market-data/ # Prices, news, analytics \n│ ├── prices/ # CoinGecko, DexPaprika, CoinMarketCap\n│ ├── news/ # CryptoPanic, aggregated news\n│ ├── analytics/ # Whale tracking, Fear/Greed, Dune\n│ ├── predictions/ # AI price predictions\n│ ├── crypto-indicators/ # Technical analysis (Kukapay) ⭐ NEW\n│ ├── crypto-sentiment/ # Sentiment analysis (Kukapay) ⭐ NEW\n│ ├── crypto-feargreed/ # Fear & Greed Index (Kukapay) ⭐ NEW\n│ ├── cryptopanic/ # News aggregation (Kukapay)\n│ └── coinmarketcap/ # CMC API (Shinzo Labs) ⭐ NEW\n├── defi/ # On-chain DeFi tools (60+ networks!)\n│ ├── protocols/ # EVM MCP Server (360⭐), Sperax, DEX\n│ │ ├── algorand/ # Algorand tools (GoPlausible) ⭐ NEW\n│ │ └── bsc-ops/ # BSC operations (TermiX) ⭐ NEW\n│ ├── chain-tools/ # BNB Chain, Onchain MCP\n│ └── agents/ # Autonomous DeFi agents\n├── wallets/ # Wallet management\n│ ├── evm/ # Ethereum & EVM wallets\n│ └── solana/ # Solana wallets\n├── payments/ # Payment infrastructure\n│ └── x402/ # x402 protocol, USDC transfers\n├── automation/ # Bots & automation\n│ ├── social/ # XActions Twitter automation\n│ ├── sweep/ # Dust sweeping\n│ └── volume/ # Volume tools\n└── generators/ # Meta-tools for building MCP servers\n ├── abi-to-mcp/ # Convert ABIs to MCP tools\n ├── repo-to-mcp/ # GitHub repos → MCP servers\n ├── doc-extractor/ # Extract docs for LLMs\n ├── registry/ # Lyra tool registry\n └── discovery/ # Tool discovery & search\n```\n\n📖 **[View Package Documentation →](docs/content/packages/)**\n\n### Integrated Community MCP Servers\n\nThis repo consolidates the best MIT-licensed crypto MCP projects with proper attribution:\n\n| Project | Author | Category | Description |\n|---------|--------|----------|-------------|\n| [evm-mcp-server](https://github.com/mcpdotdirect/evm-mcp-server) | mcpdotdirect | defi | 60+ networks, 22+ tools |\n| [crypto-indicators-mcp](https://github.com/kukapay/crypto-indicators-mcp) ⭐ **NEW** | Kukapay | market-data | Technical indicators (RSI, MACD, Bollinger) |\n| [crypto-sentiment-mcp](https://github.com/kukapay/crypto-sentiment-mcp) ⭐ **NEW** | Kukapay | market-data | Multi-source sentiment analysis |\n| [crypto-feargreed-mcp](https://github.com/kukapay/crypto-feargreed-mcp) ⭐ **NEW** | Kukapay | market-data | Fear & Greed Index |\n| [cryptopanic-mcp-server](https://github.com/kukapay/cryptopanic-mcp-server) | Kukapay | market-data | Crypto news aggregation |\n| [coinmarketcap-mcp](https://github.com/shinzo-labs/coinmarketcap-mcp) ⭐ **NEW** | Shinzo Labs | market-data | Complete CMC API |\n| [whale-tracker-mcp](https://github.com/kukapay/whale-tracker-mcp) | Kukapay | analytics | Large wallet tracking |\n| [mcp-web3-stats](https://github.com/crazyrabbitLTC/mcp-web3-stats) | crazyrabbitLTC | analytics | Dune Analytics integration |\n| [dexpaprika-mcp](https://github.com/coinpaprika/dexpaprika-mcp) | CoinPaprika | prices | DEX price data |\n| [algorand-mcp](https://github.com/GoPlausible/algorand-mcp) ⭐ **NEW** | GoPlausible | blockchain | 40+ Algorand tools |\n| [bybit-mcp-server](https://github.com/ethancod1ng/bybit-mcp-server) ⭐ **NEW** | ethancod1ng | exchange | Bybit API integration |\n| [bsc-mcp](https://github.com/TermiX-official/bsc-mcp) ⭐ **NEW** | TermiX | defi | BSC operations & security |\n| [onchain-mcp](https://github.com/bankless/onchain-mcp) | Bankless | defi | On-chain tools |\n| [mcp-free-usdc-transfer](https://github.com/magnetai/mcp-free-usdc-transfer) | MagnetAI | payments | Free USDC transfers |\n\n**All integrated projects maintain their original MIT licenses with full attribution.** \nSee [CONTRIBUTORS.md](CONTRIBUTORS.md) for detailed attribution and our modifications.\n\n---\n\n## Supported Networks\n\n### EVM Chains\n- Ethereum, BNB Smart Chain (BSC), Polygon, Arbitrum, Base, Optimism\n- Avalanche, Fantom, zkSync Era, Linea, Scroll, Blast, Mode, Mantle\n- opBNB + All testnets\n\n### Multi-Chain (NEW)\n- **Cosmos/IBC** - ATOM, OSMO, JUNO, INJ, and more\n- **Near Protocol** - NEAR native + contracts\n- **Sui** - SUI with Move support\n- **Aptos** - APT with Move support\n- Bitcoin, Litecoin, Solana, TON, XRP, THORChain\n\n## Features\n\n- 🔄 **Swap/DEX** - Token swaps via 1inch, 0x, ParaSwap\n- 🌉 **Bridge** - Cross-chain transfers via LayerZero, Stargate, Wormhole\n- ⛽ **Gas** - Gas prices across chains, EIP-1559 suggestions\n- 📦 **Multicall** - Batch read/write operations\n- 📊 **Events/Logs** - Query historical events, decode logs\n- 🔒 **Security** - Rug pull detection, honeypot check, GoPlus token/address security, dApp phishing detection\n- 💰 **Staking** - Liquid staking (Lido), LP farming\n- ✍️ **Signatures** - Sign messages, verify signatures, EIP-712\n- 🏦 **Lending** - Aave/Compound positions, borrow rates\n- 📈 **Price Feeds** - Historical prices, TWAP, oracle aggregation\n- 📁 **Portfolio** - Track holdings across chains\n- 🏛️ **Governance** - Snapshot votes, on-chain proposals\n- 🚀 **Deployment** - Deploy contracts, CREATE2, upgradeable proxies, verification\n- 🛡️ **MEV Protection** - Flashbots Protect, private transactions, bundle simulation\n- 🆔 **ENS/Domains** - Register, transfer, renew, set records, subdomains\n- 📊 **Market Data** - CoinGecko & CoinStats prices, OHLCV, trending, categories, exchanges\n- 🌐 **DeFi Analytics** - DefiLlama TVL, yields, fees, bridges, stablecoins, protocol data\n- 💬 **Social Sentiment** - LunarCrush social metrics, influencers, trending topics\n- 📈 **DEX Analytics** - DexPaprika & GeckoTerminal pools, trades, OHLCV, trending tokens\n- 🔮 **Predictions** - Polymarket prediction markets, crypto forecasts\n- 📉 **Technical Indicators** - 50+ indicators (RSI, MACD, Bollinger Bands, etc.)\n- 🔔 **Alerts** - Price alerts, whale movement alerts, gas alerts (NEW)\n- 📡 **WebSockets** - Real-time price streams, trade feeds, mempool monitoring (NEW)\n- 🐋 **Wallet Analytics** - Whale tracking, wallet scoring, behavior analysis (NEW)\n- 🌐 **Multi-Chain** - Cosmos, Near, Sui, Aptos native support (NEW)\n- 💰 **x402 Payments** - AI agents can pay for premium APIs automatically (NEW)\n\n---\n\n## 💰 x402 Payment Protocol (NEW!)\n\n

\n $\"x402\"$ \n $\"Give$ \n

\n\n> **Give Claude Money!** AI agents can now make and receive cryptocurrency payments.\n\n### What is x402?\n\nx402 implements HTTP 402 Payment Required, enabling AI agents to:\n- 💸 **Pay for APIs** - Automatically pay for premium API access\n- 🤖 **Autonomous Payments** - No human approval needed\n- 🏦 **Hold funds** - Agents have their own crypto wallets\n- 📈 **Earn yield** - Payments use USDs stablecoin (~5% APY auto-yield)\n\n### Quick Setup\n\n```bash\n# Add to your environment\nexport X402_PRIVATE_KEY=0x... # Your EVM private key\nexport X402_CHAIN=arbitrum # Default chain (or base, ethereum, polygon)\n```\n\n### x402 Tools (14 Total)\n\n| Tool | Description |\n|------|-------------|\n| `x402_pay_request` | Make HTTP request with automatic 402 payment |\n| `x402_balance` | Check wallet balance (USDC/USDs + native) |\n| `x402_send` | Send direct payment to an address |\n| `x402_batch_send` | Send multiple payments in one transaction |\n| `x402_gasless_send` | Send payment without paying gas |\n| `x402_estimate` | Check cost before paying |\n| `x402_address` | Get your wallet address |\n| `x402_networks` | List supported networks |\n| `x402_yield` | Check USDs auto-yield earnings |\n| `x402_apy` | Get current APY rate |\n| `x402_yield_estimate` | Project future yield |\n| `x402_approve` | Approve token spending |\n| `x402_tx_status` | Check transaction status |\n| `x402_config` | View current configuration |\n\n### Supported Networks\n\n| Network | CAIP-2 | Status |\n|---------|--------|--------|\n| Base | `eip155:8453` | ✅ Recommended |\n| Arbitrum | `eip155:42161` | ✅ Supported |\n| Ethereum | `eip155:1` | ✅ Supported |\n| Polygon | `eip155:137` | ✅ Supported |\n| Solana | `solana:mainnet` | ✅ Supported |\n\n### Example\n\n```\nUser: \"Get premium weather data for Tokyo\"\nAgent: [calls x402_pay_request to weather API]\n [automatically pays $0.01 in USDs]\n \"Here's the detailed forecast...\"\n```\n\n### x402 Architecture\n\n```\n┌─────────┐ ┌───────────┐ ┌───────────┐\n│ Claude │─────▶│ MCP Server│─────▶│ Paid API │\n│ (AI) │ │ (x402) │ │ (402) │\n└─────────┘ └───────────┘ └───────────┘\n │ │ │\n │ \"Get data\" │ HTTP + Payment │\n │ │ │\n └────────────────┴───────────────────┘\n```\n\n📖 **Full Documentation:**\n- [x402 README](x402/README.md) - Overview and quick start\n- [Quickstart Guide](x402/docs/QUICKSTART.md) - 5-minute setup\n- [MCP Tools Reference](x402/docs/MCP_TOOLS.md) - All 14 tools explained\n- [Architecture](x402/docs/ARCHITECTURE.md) - Technical deep dive\n- [Examples](x402/docs/EXAMPLES.md) - Real-world use cases\n- [Security Guide](x402/docs/SECURITY.md) - Best practices\n\n---\n\n## Quick Start\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"universal-crypto-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@nirholas/universal-crypto-mcp@latest\"],\n \"env\": {\n \"PRIVATE_KEY\": \"your_private_key_here (optional)\"\n }\n }\n }\n}\n```\n\n### Cursor\n\nAdd to your MCP settings:\n\n```json\n{\n \"mcpServers\": {\n \"universal-crypto-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"@nirholas/universal-crypto-mcp@latest\"],\n \"env\": {\n \"PRIVATE_KEY\": \"your_private_key_here (optional)\"\n }\n }\n }\n}\n```\n\n### ChatGPT Developer Mode\n\n1. Enable [Developer Mode](https://chatgpt.com/#settings/Connectors/Advanced) in ChatGPT settings\n2. Start the HTTP server:\n ```bash\n npx @nirholas/universal-crypto-mcp@latest --http\n ```\n3. In ChatGPT Settings → Apps, click **Create app**\n4. Enter your server URL: `http://localhost:3001/mcp`\n5. Select the app in conversations via **Developer mode** menu\n\nFor detailed setup instructions, see [ChatGPT Setup Guide](https://mcp.giving/mcp-server/chatgpt-setup/).\n\n## Server Modes\n\n| Mode | Command | Use Case |\n|------|---------|----------|\n| stdio | `npx @nirholas/universal-crypto-mcp` | Claude Desktop, Cursor |\n| HTTP | `npx @nirholas/universal-crypto-mcp --http` | ChatGPT Developer Mode |\n| SSE | `npx @nirholas/universal-crypto-mcp --sse` | Legacy HTTP clients |\n\n---\n

\n

💬 Example Prompts (Copy & Paste!)

\nReal prompts you can use with Claude, ChatGPT, or Cursor. Just copy and paste!\n\n### 🔄 Token Swaps\n\n```\nSwap 0.1 ETH for USDC on Arbitrum\n```\n```\nGet me a quote to swap 100 USDC to WBTC on Base\n```\n```\nWhat's the best rate to swap 500 DAI to ETH across all DEXs on Ethereum?\n```\n\n### 📊 Market Data & Prices\n\n```\nWhat's the current price of Bitcoin and Ethereum in USD?\n```\n```\nShow me the top 10 trending coins on CoinGecko right now\n```\n```\nGet the 7-day OHLCV data for Solana\n```\n```\nWhat's the market cap and 24h volume of BNB?\n```\n```\nShow me the price of token 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum\n```\n\n### 🌐 DeFi Analytics (DefiLlama)\n\n```\nWhat's the total TVL of Aave across all chains?\n```\n```\nShow me the top 10 protocols by TVL\n```\n```\nWhat are the best yield opportunities for stablecoins right now?\n```\n```\nHow much volume did bridges process in the last 24 hours?\n```\n```\nShow me the TVL history of Uniswap over the last 30 days\n```\n\n### 📈 DEX Analytics\n\n```\nShow me the top trending pools on Uniswap V3\n```\n```\nGet the most traded tokens on Base in the last 24 hours\n```\n```\nFind all liquidity pools for PEPE on Ethereum\n```\n```\nWhat's the price and liquidity of the ETH/USDC pool on Aerodrome?\n```\n\n### 🔒 Security Checks\n\n```\nIs this token safe? 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE (SHIB)\n```\n```\nCheck if this token is a honeypot: 0x... on BSC\n```\n```\nScan my wallet for risky approvals: 0xYourAddress\n```\n```\nIs this dApp URL safe to connect to? https://suspicious-site.xyz\n```\n\n### 💰 Staking & Lending\n\n```\nWhat's the current staking APY for ETH on Lido?\n```\n```\nShow me Aave lending rates for USDC on Arbitrum\n```\n```\nWhat's my health factor on Aave if I borrow 1000 USDC against 2 ETH?\n```\n\n### 🌉 Cross-Chain Bridges\n\n```\nBridge 100 USDC from Ethereum to Arbitrum\n```\n```\nWhat's the cheapest way to bridge ETH from mainnet to Base?\n```\n```\nGet a bridge quote for 0.5 ETH from Polygon to Optimism\n```\n\n### ⛽ Gas & Network\n\n```\nWhat's the current gas price on Ethereum?\n```\n```\nGet EIP-1559 gas fees for all supported chains\n```\n```\nIs it cheap to transact on Arbitrum right now?\n```\n\n### 🏛️ Governance\n\n```\nShow me active proposals on Uniswap\n```\n```\nWhat's my voting power on Compound?\n```\n```\nGet the results of the latest Aave governance vote\n```\n\n### 💬 Social Sentiment (LunarCrush)\n\n```\nWhat's the social sentiment for Bitcoin right now?\n```\n```\nShow me the top crypto influencers on social media\n```\n```\nWhat tokens are trending on Twitter/X today?\n```\n```\nGet the Galaxy Score for Ethereum\n```\n\n### 🆔 ENS Domains\n\n```\nResolve vitalik.eth to an address\n```\n```\nWho owns the ENS domain \"ethereum.eth\"?\n```\n```\nRegister the domain mycoolname.eth for 1 year\n```\n\n### 📰 Crypto News\n\n```\nGet the latest crypto news\n```\n```\nSearch news about Bitcoin ETF\n```\n```\nWhat's the breaking news in DeFi?\n```\n\n### 📁 Portfolio & Wallet\n\n```\nShow my token balances on Ethereum: 0xYourAddress\n```\n```\nGet all NFTs owned by vitalik.eth\n```\n```\nWhat approvals have I granted from my wallet?\n```\n```\nTrack my portfolio across all EVM chains\n```\n\n### 🚀 Advanced Operations\n\n```\nDeploy a new ERC-20 token called \"MyToken\" (MTK) with 1 million supply on Base\n```\n```\nSubmit this transaction privately via Flashbots to avoid MEV\n```\n```\nEncode a call to the transfer function for 100 USDC\n```\n```\nSimulate this transaction before executing: 0x...\n```\n\n### 📉 Technical Indicators\n\n```\nCalculate RSI for Bitcoin over the last 14 days\n```\n```\nGet MACD signal for ETH/USDT on the 4-hour timeframe\n```\n```\nShow Bollinger Bands for SOL with 20-period SMA\n```\n```\nWhat's the current trend signal for BTC using multiple indicators?\n```\n```\nRun a momentum strategy analysis on DOGE\n```\n\n### 🔮 Prediction Markets\n\n```\nWhat are the top crypto prediction markets on Polymarket?\n```\n```\nSearch for Bitcoin price predictions\n```\n```\nWhat's the current odds for ETH reaching $5000?\n```\n\n### 📊 Events & Logs\n\n```\nGet all Transfer events for USDC in the last 100 blocks on Ethereum\n```\n```\nShow me Approval events for my wallet address\n```\n```\nDecode this transaction log: 0x...\n```\n\n### ✍️ Signatures & Messages\n\n```\nSign this message with my wallet: \"Hello World\"\n```\n```\nVerify this signature is from vitalik.eth\n```\n```\nCreate an EIP-712 typed data signature for a permit\n```\n\n### 📦 Batch Operations (Multicall)\n\n```\nGet token balances for 10 different tokens in one call\n```\n```\nRead multiple contract values at once from Aave\n```\n```\nBatch check allowances for all my approved tokens\n```\n

\n\n---\n\n## 🧪 Testing\n\nWe use [Vitest](https://vitest.dev/) as our testing framework with comprehensive test coverage.\n\n### Running Tests\n\n```bash\n# Run all unit tests\nnpm test\n\n# Run tests in watch mode (re-runs on file changes)\nnpm run test:watch\n\n# Run tests with coverage report\nnpm run test:coverage\n\n# Run E2E tests (requires network access)\nnpm run test:e2e\n\n# Run E2E tests in watch mode\nnpm run test:e2e:watch\n\n# Open interactive test UI\nnpm run test:ui\n```\n\n### MCP Inspector\n\nTest your MCP tools interactively using the official [MCP Inspector](https://github.com/modelcontextprotocol/inspector):\n\n```bash\nnpm run test:inspector\n```\n\nThis opens a browser-based UI where you can:\n- Browse all available tools and prompts\n- Test tool execution with custom parameters\n- View tool responses and debug issues\n- Validate your MCP server implementation\n\n### Test Structure\n\n```\ntests/\n├── setup.ts # Global test setup\n├── e2e/ # End-to-end tests\n│ ├── evm-tools.e2e.test.ts\n│ └── market-data.e2e.test.ts\n├── integration/ # Integration tests\n│ ├── evm-tools.test.ts\n│ └── multichain.test.ts\n└── mocks/ # Test mocks and fixtures\n\nsrc/\n├── evm/\n│ ├── chains.test.ts # Unit tests alongside source\n│ └── modules/\n│ └── */tools.test.ts\n└── utils/\n ├── errors.test.ts\n ├── helper.test.ts\n └── validation.test.ts\n```\n\n---\n\n## Local Development\n\n```bash\n# Clone\ngit clone https://github.com/nirholas/universal-crypto-mcp\ncd universal-crypto-mcp\n\n# Install\nnpm install\n\n# Run dev server (stdio - Claude)\nnpm run dev\n\n# Run dev server (HTTP - ChatGPT)\nnpm run dev:http\n\n# Run dev server (SSE - legacy)\nnpm run dev:sse\n```\n\n---\n\n## 🧪 Testing\n\n

\n $\"Code$ \n $\"Tests\"$ \n

\n\n### Running Tests\n\n```bash\n# Run all tests\nnpm test\n\n# Run unit tests only\nnpm run test:unit\n\n# Run integration tests\nnpm run test:integration\n\n# Run E2E tests (requires network access)\nnpm run test:e2e\n\n# Run tests with coverage report\nnpm run test:coverage\n\n# Run tests in watch mode (development)\nnpm run test:watch\n```\n\n### Test Structure\n\n| Type | Location | Description |\n|------|----------|-------------|\n| **Unit** | `src/**/*.test.ts` | Test individual functions/modules |\n| **Integration** | `tests/integration/` | Test multiple components together |\n| **E2E** | `tests/e2e/` | Test full MCP server flow |\n\n### E2E Tests\n\nEnd-to-end tests verify the complete tool execution flow:\n\n- **EVM Tools** - Block, balance, token operations across chains\n- **DeFi Tools** - Protocol TVL, yields, stablecoins via DefiLlama\n- **Market Data** - CoinGecko, Fear & Greed index\n- **Multichain** - Same operations across different networks\n- **Error Recovery** - Error handling, invalid inputs, edge cases\n\n### Custom Test Utilities\n\nThe project includes custom Vitest matchers for MCP responses:\n\n```typescript\n// In your test file\nimport \"../utils/assertions\"\n\nexpect(result).toBeSuccessfulToolResponse()\nexpect(result).toHaveJsonProperty(\"balance\")\nexpect(result).toContainValidAddress()\nexpect(result).toContainToolError(/invalid/i)\n```\n\n### Test Fixtures\n\nReusable test data in `tests/utils/fixtures.ts`:\n\n```typescript\nimport {\n ETH_MAINNET_ADDRESSES,\n MOCK_TOKEN_DATA,\n generateRandomAddress\n} from \"../utils/fixtures\"\n```\n\nFor detailed testing documentation, see [tests/README.md](tests/README.md).\n\n---\n\n## ⚙️ Environment Variables\n\nConfigure optional API keys for enhanced features. Create a `.env` file:\n\n```bash\n# Required for write operations (swaps, transfers, etc.)\nPRIVATE_KEY=your_private_key_here\n\n# Market Data (optional - has free tier)\nCOINGECKO_API_KEY=your_key # https://coingecko.com/api\nCOINSTATS_API_KEY=your_key # https://coinstats.app\n\n# Social Sentiment (optional)\nLUNARCRUSH_API_KEY=your_key # https://lunarcrush.com/developers\n\n# News (optional)\nCRYPTOPANIC_API_KEY=your_key # https://cryptopanic.com/developers\n\n# Cross-chain Swaps (optional)\nRUBIC_API_KEY=your_key # https://rubic.exchange\n\n# Custom RPC endpoints (optional - uses public RPCs by default)\nETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_KEY\nARBITRUM_RPC_URL=https://arb1.arbitrum.io/rpc\nBASE_RPC_URL=https://mainnet.base.org\n```\n\n### What Works Without API Keys\n\n| Feature | Without API Key | With API Key |\n|---------|-----------------|--------------|\n| Token prices | ✅ CoinGecko free tier | ✅ Higher rate limits |\n| DeFi analytics | ✅ DefiLlama (free) | - |\n| Security checks | ✅ GoPlus (free) | - |\n| DEX analytics | ✅ GeckoTerminal (free) | - |\n| Social sentiment | ❌ | ✅ LunarCrush |\n| Crypto news | ❌ | ✅ CryptoPanic |\n| Cross-chain swaps | ✅ Basic | ✅ Best routes |\n\n---\n\n## Documentation\n\nhttps://mcp.giving\n\n---\n\n## � Documentation & Examples\n\n### 📖 Documentation\n\nComprehensive guides and API references:\n\n- **[Getting Started](docs/content/getting-started/)**\n - [Installation Guide](docs/content/getting-started/installation.md)\n - [Configuration](docs/content/getting-started/configuration.md)\n - [Your First MCP Tool](docs/content/getting-started/first-tool.md)\n - [Deployment Guide](docs/content/getting-started/deployment.md)\n\n- **[Package Documentation](docs/content/packages/)**\n - [Core Package](docs/content/packages/core.md)\n - [Trading](docs/content/packages/trading.md)\n - [Market Data](docs/content/packages/market-data.md)\n - [Wallets](docs/content/packages/wallets.md)\n - [DeFi](docs/content/packages/defi.md)\n - [Payments (x402)](docs/content/packages/payments.md)\n\n- **[x402 Deploy Documentation](docs/content/x402-deploy/)**\n - [Overview](docs/content/x402-deploy/overview.md)\n - [Quick Start](docs/content/x402-deploy/quick-start.md)\n - [Configuration](docs/content/x402-deploy/configuration.md)\n - [Providers](docs/content/x402-deploy/providers.md)\n - [Discovery](docs/content/x402-deploy/discovery.md)\n\n- **[Contributing](docs/content/contributing/)**\n - [Development Guide](docs/content/contributing/development.md)\n - [Testing](docs/content/contributing/testing.md)\n - [Releases](docs/content/contributing/releases.md)\n\n### 💻 Examples\n\nWorking code examples you can run and modify:\n\n- **[Basic MCP Server](examples/basic-mcp-server/)** - Minimal MCP server with market data tools\n- **[Paid API Example](examples/paid-api/)** - Add x402 payments to Express API\n- **[Trading Bot](examples/trading-bot/)** - Automated trading bot with RSI + MA strategy\n- **[Full Deployment](examples/full-deployment/)** - Production-ready server with all features\n\nEach example includes:\n- Complete source code\n- README with setup instructions\n- Package configuration\n- Environment setup guide\n\n---\n\n## �🗺️ Roadmap\n\nA comprehensive roadmap of all crypto/blockchain/DeFi/Web3 features to be implemented.\n\n### Legend\n- ✅ Implemented\n- 🚧 In Progress \n- 📋 Planned\n\n

\n

🔗 Core Blockchain Operations (click to expand)

\n\n### 🔗 Core Blockchain Operations\n\n#### Network & Chain\n| Feature | Status |\n|---------|--------|\n| Get chain ID, block number, gas price | ✅ |\n| Get network status/health | ✅ |\n| Switch networks/chains | ✅ |\n| Get supported networks list | ✅ |\n| Get RPC endpoints | ✅ |\n| Estimate block time | ✅ |\n| Get chain metadata (name, symbol, explorers) | ✅ |\n| Get finality status | ✅ |\n| Get mempool/pending transactions | ✅ |\n| Get network peers/nodes | ✅ |\n| Get gas oracle | ✅ |\n\n#### Blocks\n| Feature | Status |\n|---------|--------|\n| Get block by number/hash | ✅ |\n| Get latest block | ✅ |\n| Get block transactions | ✅ |\n| Get block receipts | ✅ |\n| Get uncle blocks | ✅ |\n| Subscribe to new blocks | 📋 |\n| Get block rewards | ✅ |\n| Get block gas used/limit | ✅ |\n| Get block range | ✅ |\n| Get blocks by miner | ✅ |\n\n#### Transactions\n| Feature | Status |\n|---------|--------|\n| Send transaction | ✅ |\n| Get transaction by hash | ✅ |\n| Get transaction receipt | ✅ |\n| Get transaction status | ✅ |\n| Estimate gas | ✅ |\n| Speed up transaction (replace with higher gas) | ✅ |\n| Cancel transaction | ✅ |\n| Decode transaction input | ✅ |\n| Simulate transaction | ✅ |\n| Get transaction trace | 📋 |\n| Get internal transactions | 📋 |\n| Batch transactions | ✅ |\n| Get pending transactions | ✅ |\n| Get transaction history by address | ✅ |\n\n#### Accounts/Wallets\n| Feature | Status |\n|---------|--------|\n| Get balance (native/token) | ✅ |\n| Get nonce | ✅ |\n| Get transaction count | ✅ |\n| Create wallet | ✅ |\n| Import wallet (private key/mnemonic) | ✅ |\n| Export private key | 📋 |\n| Sign message | ✅ |\n| Verify signature | ✅ |\n| Get address from private key | ✅ |\n| Generate mnemonic | ✅ |\n| Derive addresses (HD wallet) | ✅ |\n| Multi-sig wallet operations | 📋 |\n| Get wallet permissions | 📋 |\n| Revoke approvals | ✅ |\n| Account abstraction (ERC-4337) | 📋 |\n| Social recovery | 📋 |\n| Hardware wallet integration | 📋 |\n| Get wallet portfolio | ✅ |\n| Get token approvals | ✅ |\n\n

\n\n

\n

💰 Token Operations (click to expand)

\n\n### 💰 Token Operations\n\n#### Native Tokens\n| Feature | Status |\n|---------|--------|\n| Get native balance | ✅ |\n| Transfer native tokens | ✅ |\n| Wrap/unwrap native tokens (WETH, WBNB) | ✅ |\n\n#### ERC-20 (Fungible Tokens)\n| Feature | Status |\n|---------|--------|\n| Get token info (name, symbol, decimals, total supply) | ✅ |\n| Get token balance | ✅ |\n| Transfer tokens | ✅ |\n| Approve spending | ✅ |\n| Get allowance | ✅ |\n| Transfer from (delegated) | ✅ |\n| Burn tokens | ✅ |\n| Mint tokens | ✅ |\n| Get token holders | ✅ |\n| Get token transfers | ✅ |\n| Permit (gasless approvals - EIP-2612) | ✅ |\n| Batch transfers | ✅ |\n| Token snapshots | 📋 |\n| Get token supply info | ✅ |\n| Check/revoke token approval | ✅ |\n\n#### ERC-721 (NFTs)\n| Feature | Status |\n|---------|--------|\n| Get NFT metadata | ✅ |\n| Get NFT owner | ✅ |\n| Transfer NFT | ✅ |\n| Approve NFT | ✅ |\n| Set approval for all | ✅ |\n| Get NFTs by owner | ✅ |\n| Get NFT collection info | ✅ |\n| Mint NFT | 📋 |\n| Burn NFT | 📋 |\n| Get NFT transfer history | 📋 |\n| Get NFT traits/attributes | ✅ |\n| Get NFT rarity | 📋 |\n| Verify NFT authenticity | 📋 |\n| Batch transfer NFTs | ✅ |\n| Check NFT approval | ✅ |\n| Revoke NFT approval | ✅ |\n| Approve for marketplace | ✅ |\n| Fetch NFT metadata from URI | ✅ |\n\n#### ERC-1155 (Multi-Token)\n| Feature | Status |\n|---------|--------|\n| Get token balance (fungible + NFT) | ✅ |\n| Batch transfers | 📋 |\n| Batch balance queries | 📋 |\n| Safe transfer | ✅ |\n| Get URI | ✅ |\n\n#### Other Token Standards\n| Feature | Status |\n|---------|--------|\n| ERC-777 (advanced fungible) | 📋 |\n| ERC-3525 (semi-fungible) | 📋 |\n| ERC-4626 (tokenized vaults) | 📋 |\n| ERC-6551 (token-bound accounts) | 📋 |\n| ERC-404 (hybrid tokens) | 📋 |\n| Soulbound tokens (SBTs) | 📋 |\n\n

\n\n

\n

🏦 DeFi - DEX, Lending, Staking, Derivatives (click to expand)

\n\n### 🏦 DeFi - Decentralized Exchanges (DEX)\n\n#### Swaps\n| Feature | Status |\n|---------|--------|\n| Get quote/price | ✅ |\n| Swap exact tokens for tokens | ✅ |\n| Swap tokens for exact tokens | ✅ |\n| Multi-hop swaps | ✅ |\n| Split route swaps | 📋 |\n| Cross-DEX aggregation | ✅ |\n| Limit orders | 📋 |\n| TWAP orders (time-weighted) | 📋 |\n| Stop-loss orders | 📋 |\n| Get slippage estimate | ✅ |\n| Get price impact | ✅ |\n| MEV protection (private transactions) | 📋 |\n\n#### DEX Analytics\n| Feature | Status |\n|---------|--------|\n| Get trending pools | ✅ |\n| Get new pools | ✅ |\n| Get top pools by volume | ✅ |\n| Get pool OHLCV data | ✅ |\n| Get pool trades | ✅ |\n| Get token pools | ✅ |\n| Get DEX list | ✅ |\n| Search pools cross-chain | ✅ |\n| Get token price by contract | ✅ |\n| Get pool transactions | ✅ |\n| Multi-token price lookup | ✅ |\n\n#### Liquidity Provision\n| Feature | Status |\n|---------|--------|\n| Add liquidity | ✅ |\n| Remove liquidity | ✅ |\n| Get LP token balance | ✅ |\n| Get pool reserves | ✅ |\n| Get pool APY/APR | 📋 |\n| Get impermanent loss estimate | 📋 |\n| Concentrated liquidity (Uniswap V3) | 📋 |\n| Set price range | 📋 |\n| Collect fees | 📋 |\n| Rebalance position | 📋 |\n| Add liquidity with native token | ✅ |\n| Calculate arbitrage opportunities | ✅ |\n\n#### AMM Types Support\n| Feature | Status |\n|---------|--------|\n| Constant product (x*y=k) | ✅ |\n| Stable swap (Curve) | 📋 |\n| Concentrated liquidity | 📋 |\n| Order book hybrid | 📋 |\n| Virtual AMM (perpetuals) | 📋 |\n\n---\n\n### 🏦 DeFi - Lending & Borrowing\n\n#### Lending\n| Feature | Status |\n|---------|--------|\n| Supply/deposit assets | ✅ |\n| Withdraw assets | ✅ |\n| Get supply APY | ✅ |\n| Get supplied balance | ✅ |\n| Get utilization rate | 📋 |\n| Enable/disable as collateral | 📋 |\n\n#### Borrowing\n| Feature | Status |\n|---------|--------|\n| Borrow assets | ✅ |\n| Repay debt | ✅ |\n| Get borrow APY | ✅ |\n| Get borrowed balance | ✅ |\n| Get health factor | ✅ |\n| Get liquidation threshold | ✅ |\n| Get max borrowable amount | 📋 |\n| Flash loans | ✅ |\n| Get borrow limit | 📋 |\n| Get flash loan info | ✅ |\n\n#### Liquidations\n| Feature | Status |\n|---------|--------|\n| Liquidate unhealthy positions | 📋 |\n| Get liquidatable positions | ✅ |\n| Get liquidation bonus | 📋 |\n| Partial liquidations | 📋 |\n\n#### Isolated Markets\n| Feature | Status |\n|---------|--------|\n| Supply to isolated pool | 📋 |\n| Borrow from isolated pool | 📋 |\n| Get isolation mode debt ceiling | 📋 |\n\n---\n\n### 🥩 DeFi - Staking\n\n#### Native Staking\n| Feature | Status |\n|---------|--------|\n| Stake native tokens | ✅ |\n| Unstake/withdraw | ✅ |\n| Claim rewards | ✅ |\n| Get staking APY | ✅ |\n| Get validator list | 📋 |\n| Delegate to validator | 📋 |\n| Redelegate | 📋 |\n| Get unbonding period | 📋 |\n\n#### Liquid Staking\n| Feature | Status |\n|---------|--------|\n| Stake for liquid staking tokens (stETH, rETH) | ✅ |\n| Unwrap liquid staking tokens | ✅ |\n| Get exchange rate | ✅ |\n| Get staking rewards rate | ✅ |\n\n#### LP Staking/Farming\n| Feature | Status |\n|---------|--------|\n| Stake LP tokens | ✅ |\n| Unstake LP tokens | ✅ |\n| Claim farming rewards | ✅ |\n| Get farming APY | ✅ |\n| Compound rewards | 📋 |\n| Get pending rewards | ✅ |\n| Boost rewards (veTokens) | 📋 |\n\n#### Restaking\n| Feature | Status |\n|---------|--------|\n| Restake assets (EigenLayer) | 📋 |\n| Get restaking points | 📋 |\n| Choose operators | 📋 |\n| Withdraw from restaking | 📋 |\n\n---\n\n### 📊 DeFi - Derivatives\n\n#### Perpetual Futures\n| Feature | Status |\n|---------|--------|\n| Open long/short position | 📋 |\n| Close position | 📋 |\n| Add/remove margin | 📋 |\n| Set leverage | 📋 |\n| Get funding rate | 📋 |\n| Get open interest | 📋 |\n| Get liquidation price | 📋 |\n| Set stop-loss/take-profit | 📋 |\n| Get PnL | 📋 |\n| Partial close | 📋 |\n\n#### Options\n| Feature | Status |\n|---------|--------|\n| Buy call/put options | 📋 |\n| Sell/write options | 📋 |\n| Exercise options | 📋 |\n| Get option greeks | 📋 |\n| Get implied volatility | 📋 |\n| Get option chain | 📋 |\n| Spread strategies | 📋 |\n\n#### Synthetics\n| Feature | Status |\n|---------|--------|\n| Mint synthetic assets | 📋 |\n| Burn synthetic assets | 📋 |\n| Get collateral ratio | 📋 |\n| Get synthetic price feed | 📋 |\n| Liquidate synthetic positions | 📋 |\n\n

\n\n

\n

🌉 Cross-Chain, Governance, Security, NFTs (click to expand)

\n\n### 🌉 Cross-Chain & Bridges\n\n#### Bridging\n| Feature | Status |\n|---------|--------|\n| Bridge tokens cross-chain | ✅ |\n| Get bridge quote | ✅ |\n| Get bridge status | ✅ |\n| Get supported chains | ✅ |\n| Get supported tokens | ✅ |\n| Claim bridged tokens | 📋 |\n| Get bridge fees | ✅ |\n| Get estimated time | ✅ |\n\n#### Cross-Chain Messaging\n| Feature | Status |\n|---------|--------|\n| Send cross-chain message | 📋 |\n| Receive cross-chain message | 📋 |\n| LayerZero operations | 📋 |\n| Axelar operations | 📋 |\n| Wormhole operations | 📋 |\n| CCIP (Chainlink) | 📋 |\n| Hyperlane operations | 📋 |\n\n#### Atomic Swaps\n| Feature | Status |\n|---------|--------|\n| Initiate atomic swap | 📋 |\n| Complete atomic swap | 📋 |\n| Refund atomic swap | 📋 |\n\n---\n\n### 🗳️ Governance\n\n#### Voting\n| Feature | Status |\n|---------|--------|\n| Create proposal | ✅ |\n| Vote on proposal | ✅ |\n| Delegate votes | ✅ |\n| Get voting power | ✅ |\n| Get proposal state | ✅ |\n| Queue proposal | ✅ |\n| Execute proposal | ✅ |\n| Cancel proposal | ✅ |\n| Get vote receipt | ✅ |\n\n#### Token Locking\n| Feature | Status |\n|---------|--------|\n| Lock tokens for voting (veTokens) | 📋 |\n| Extend lock period | 📋 |\n| Increase locked amount | 📋 |\n| Withdraw unlocked tokens | 📋 |\n| Get lock info | 📋 |\n\n#### Snapshot (Off-chain)\n| Feature | Status |\n|---------|--------|\n| Create space | 📋 |\n| Create off-chain proposal | 📋 |\n| Vote off-chain | 📋 |\n| Get snapshot results | 📋 |\n\n---\n\n### 🔐 Security & Analysis\n\n#### Contract Analysis\n| Feature | Status |\n|---------|--------|\n| Verify contract source | ✅ |\n| Get contract ABI | ✅ |\n| Check if contract is proxy | ✅ |\n| Get implementation address | ✅ |\n| Detect honeypots | ✅ |\n| Check for rug pull risks | ✅ |\n| GoPlus token security check | ✅ |\n| GoPlus rug pull detection | ✅ |\n| Audit score | 📋 |\n| Get contract creator | ✅ |\n| Get contract age | ✅ |\n| Detect malicious functions | ✅ |\n\n#### Token Security\n| Feature | Status |\n|---------|--------|\n| Check token safety | ✅ |\n| Get holder distribution | ✅ |\n| Check if mintable | ✅ |\n| Check if pausable | ✅ |\n| Check for hidden fees | ✅ |\n| Check liquidity locked | ✅ |\n| Get top holders | ✅ |\n| Check ownership renounced | ✅ |\n| GoPlus NFT security | ✅ |\n| GoPlus approval security | ✅ |\n\n#### Wallet Security\n| Feature | Status |\n|---------|--------|\n| Get approval list | ✅ |\n| Revoke approvals | ✅ |\n| Check for drainers | ✅ |\n| Simulate transaction safety | ✅ |\n| Get wallet risk score | 📋 |\n| GoPlus address security | ✅ |\n| GoPlus dApp phishing check | ✅ |\n| GoPlus signature decode | ✅ |\n\n---\n\n### 📈 Price & Market Data\n\n#### Price Feeds\n| Feature | Status |\n|---------|--------|\n| Get current price | ✅ |\n| Get historical prices | ✅ |\n| Get OHLCV data | ✅ |\n| Get price from DEX | ✅ |\n| Get price from oracle (Chainlink, Pyth) | ✅ |\n| Get TWAP price | ✅ |\n| Get price across exchanges | ✅ |\n| Get volume | ✅ |\n| Get market cap | ✅ |\n| Get trending coins | ✅ |\n| Get token by contract address | ✅ |\n| Get exchange rates | ✅ |\n| Get coin categories | ✅ |\n| Get derivatives data | ✅ |\n| Get company BTC/ETH holdings | ✅ |\n\n#### Analytics\n| Feature | Status |\n|---------|--------|\n| Get TVL (Total Value Locked) | ✅ |\n| Get protocol metrics | ✅ |\n| Get yield farming APYs | ✅ |\n| Get gas tracker | ✅ |\n| Get whale transactions | 📋 |\n| Get token flow analysis | 📋 |\n| Get DEX volume | ✅ |\n| Get lending metrics | 📋 |\n| Get DeFi fees & revenue | ✅ |\n| Get stablecoin data | ✅ |\n| Get bridge volumes | ✅ |\n| Get liquidation data | ✅ |\n| Get DeFi hacks history | ✅ |\n| Get perpetuals data | ✅ |\n\n---\n\n### 🆔 Identity & Domains\n\n#### ENS (Ethereum Name Service)\n| Feature | Status |\n|---------|--------|\n| Register domain | ✅ |\n| Resolve name to address | ✅ |\n| Reverse resolve address to name | ✅ |\n| Set primary name | 📋 |\n| Set records (text, address, content hash) | ✅ |\n| Transfer domain | ✅ |\n| Renew domain | ✅ |\n| Get expiry date | 📋 |\n| Set subdomains | ✅ |\n\n#### Other Name Services\n| Feature | Status |\n|---------|--------|\n| Unstoppable Domains | 📋 |\n| Space ID (.bnb) | 📋 |\n| Bonfida (.sol) | 📋 |\n| ANS (.avax) | 📋 |\n\n#### DIDs & Verifiable Credentials\n| Feature | Status |\n|---------|--------|\n| Create DID | 📋 |\n| Resolve DID | 📋 |\n| Issue verifiable credential | 📋 |\n| Verify credential | 📋 |\n| Revoke credential | 📋 |\n\n---\n\n### 🖼️ NFT & Metaverse\n\n#### NFT Marketplace\n| Feature | Status |\n|---------|--------|\n| List NFT for sale | 📋 |\n| Buy NFT | 📋 |\n| Make offer | 📋 |\n| Accept offer | 📋 |\n| Cancel listing | 📋 |\n| Auction NFT | 📋 |\n| Bid on auction | 📋 |\n| Get floor price | 📋 |\n| Get collection stats | 📋 |\n\n#### NFT Creation\n| Feature | Status |\n|---------|--------|\n| Deploy NFT collection | 📋 |\n| Mint NFTs | 📋 |\n| Set royalties | 📋 |\n| Set metadata | 📋 |\n| Reveal NFTs | 📋 |\n| Whitelist management | 📋 |\n| Airdrop NFTs | 📋 |\n\n#### NFT Finance\n| Feature | Status |\n|---------|--------|\n| NFT collateralized loans | 📋 |\n| NFT fractionalization | 📋 |\n| NFT renting | 📋 |\n| NFT staking | 📋 |\n\n#### Metaverse\n| Feature | Status |\n|---------|--------|\n| Buy virtual land | 📋 |\n| Sell virtual land | 📋 |\n| Build on land | 📋 |\n| Transfer assets between metaverses | 📋 |\n\n---\n\n### 🔔 Events & Subscriptions\n\n#### Event Listening\n| Feature | Status |\n|---------|--------|\n| Subscribe to contract events | 📋 |\n| Subscribe to pending transactions | 📋 |\n| Subscribe to new blocks | 📋 |\n| Subscribe to logs | 📋 |\n| Filter events by topic | ✅ |\n| Get historical events | ✅ |\n| Decode event logs | ✅ |\n\n#### Webhooks & Notifications\n| Feature | Status |\n|---------|--------|\n| Set up webhook for events | 📋 |\n| Get transaction notifications | 📋 |\n| Get price alerts | 📋 |\n| Get whale alerts | 📋 |\n| Get governance notifications | 📋 |\n\n---\n\n### 📜 Smart Contract Interaction\n\n#### Read Operations\n| Feature | Status |\n|---------|--------|\n| Call view/pure functions | ✅ |\n| Get storage at slot | ✅ |\n| Get contract bytecode | ✅ |\n| Multicall (batch reads) | ✅ |\n| Static call simulation | ✅ |\n\n#### Write Operations\n| Feature | Status |\n|---------|--------|\n| Send transaction to contract | ✅ |\n| Encode function call | ✅ |\n| Decode function result | ✅ |\n| Estimate gas for call | ✅ |\n| Batch transactions | ✅ |\n\n#### Contract Deployment\n| Feature | Status |\n|---------|--------|\n| Deploy contract | ✅ |\n| Deploy with CREATE2 | ✅ |\n| Deploy proxy contract | ✅ |\n| Upgrade proxy | ✅ |\n| Verify on explorer | ✅ |\n\n---\n\n### 🤖 Advanced Features\n\n#### MEV & Flashbots\n| Feature | Status |\n|---------|--------|\n| Submit private transaction | ✅ |\n| Submit bundle | ✅ |\n| Get MEV opportunities | ✅ |\n| Backrun protection | ✅ |\n| Frontrun protection | ✅ |\n| Sandwich protection | ✅ |\n\n#### Account Abstraction (ERC-4337)\n| Feature | Status |\n|---------|--------|\n| Create smart account | 📋 |\n| Execute user operation | 📋 |\n| Batch operations | 📋 |\n| Sponsor gas (Paymaster) | 📋 |\n| Session keys | 📋 |\n| Social recovery | 📋 |\n\n#### Intents & Solvers\n| Feature | Status |\n|---------|--------|\n| Submit intent | 📋 |\n| Get solver quotes | 📋 |\n| Execute via solver | 📋 |\n\n#### Oracles\n| Feature | Status |\n|---------|--------|\n| Get Chainlink price | ✅ |\n| Get Pyth price | 📋 |\n| Get Band Protocol price | 📋 |\n| Get API3 price | 📋 |\n| Request randomness (VRF) | 📋 |\n| Request external data | 📋 |\n\n---\n\n### 🛠️ Utility Functions\n\n#### Gas\n| Feature | Status |\n|---------|--------|\n| Get gas price | ✅ |\n| Get priority fee | ✅ |\n| Get base fee | ✅ |\n| Get gas history | ✅ |\n| Estimate gas for transaction | ✅ |\n| Get EIP-1559 fees | ✅ |\n\n#### Encoding/Decoding\n| Feature | Status |\n|---------|--------|\n| ABI encode | ✅ |\n| ABI decode | ✅ |\n| Keccak256 hash | ✅ |\n| Pack/unpack data | ✅ |\n| Sign typed data (EIP-712) | ✅ |\n\n#### Address Utils\n| Feature | Status |\n|---------|--------|\n| Validate address | ✅ |\n| Checksum address | ✅ |\n| Get address from ENS | ✅ |\n| Check if contract | ✅ |\n| Get contract type | 📋 |\n\n---\n\n### 📰 Data & Information\n\n#### News & Social\n| Feature | Status |\n|---------|--------|\n| Get crypto news | ✅ |\n| Search crypto news | ✅ |\n| Get DeFi news | ✅ |\n| Get Bitcoin news | ✅ |\n| Get breaking news | ✅ |\n| Get social sentiment | ✅ |\n| Get influencer rankings | ✅ |\n| Get trending topics | ✅ |\n| Get coin social metrics | ✅ |\n| Get social feed | ✅ |\n| Get market sentiment index | ✅ |\n| Get Galaxy Score | ✅ |\n| Get AltRank | ✅ |\n| Get Twitter mentions | 📋 |\n| Get Discord activity | 📋 |\n| Get GitHub activity | 📋 |\n\n#### On-Chain Data\n| Feature | Status |\n|---------|--------|\n| Get token holders | 📋 |\n| Get whale wallets | 📋 |\n| Get smart money movements | 📋 |\n| Get protocol users | 📋 |\n| Get daily active addresses | 📋 |\n| Get network hash rate | 📋 |\n\n

\n\n

\n

🏛️ Institutional & Compliance (click to expand)

\n\n### 🏛️ Institutional & Compliance\n\n#### KYC/AML\n| Feature | Status |\n|---------|--------|\n| Wallet screening | 📋 |\n| Transaction monitoring | 📋 |\n| Risk scoring | 📋 |\n| Sanctions checking | 📋 |\n\n#### Custody\n| Feature | Status |\n|---------|--------|\n| Multi-sig operations | 📋 |\n| Cold storage | 📋 |\n| Hot wallet management | 📋 |\n| Policy enforcement | 📋 |\n\n#### Reporting\n| Feature | Status |\n|---------|--------|\n| Tax reporting | 📋 |\n| Portfolio tracking | ✅ |\n| P&L reporting | 📋 |\n| Transaction history export | 📋 |\n\n

\n\n---\n\n## Data Sources\n\nThis MCP server integrates with the following APIs:\n\n| Provider | Data Type | API Key Required |\n|----------|-----------|------------------|\n| [CoinGecko](https://coingecko.com) | Market data, prices, OHLCV | Optional (free tier) |\n| [CoinStats](https://coinstats.app) | Portfolio, prices, wallets | Yes |\n| [DefiLlama](https://defillama.com) | TVL, yields, fees, protocols | No |\n| [LunarCrush](https://lunarcrush.com) | Social sentiment, influencers | Yes |\n| [GoPlus](https://gopluslabs.io) | Security analysis, honeypot detection | No |\n| [GeckoTerminal](https://geckoterminal.com) | DEX pools, trades, OHLCV | No |\n| [DexPaprika](https://dexpaprika.com) | DEX analytics, pools | No |\n| [CryptoPanic](https://cryptopanic.com) | Crypto news | Yes |\n| [Alternative.me](https://alternative.me) | Fear & Greed Index | No |\n\n---\n\n## Related MCP Servers\n\nAdditional specialized MCP servers, maintained in their own repositories:\n\n| Server | Description | Tools |\n|--------|-------------|-------|\n| [Binance-MCP](https://github.com/nirholas/Binance-MCP) | Binance.com global exchange API | 156+ tools |\n| [Binance-US-MCP](https://github.com/nirholas/Binance-US-MCP) | Binance.US exchange API | 71+ tools |\n\n### Binance.com Server\nFull Binance global API coverage including:\n- Spot trading, wallet, staking, mining\n- Convert, Simple Earn, Algo Trading (TWAP/VP)\n- NFT, Pay, Copy Trading, Dual Investment\n- VIP Loans, C2C/P2P, Fiat\n\n```json\n{\n \"mcpServers\": {\n \"binance\": {\n \"command\": \"npx\",\n \"args\": [\"ts-node\", \"binance-mcp-server/src/index.ts\"],\n \"env\": {\n \"BINANCE_API_KEY\": \"your_key\",\n \"BINANCE_API_SECRET\": \"your_secret\"\n }\n }\n }\n}\n```\n\n### Binance.US Server\nUS-regulated exchange with:\n- Market data, spot trading, wallet\n- Staking, OTC, sub-accounts\n- Custodial solutions (institutional)\n\n```json\n{\n \"mcpServers\": {\n \"binance-us\": {\n \"command\": \"node\",\n \"args\": [\"binance-us-mcp-server/build/index.js\"],\n \"env\": {\n \"BINANCE_US_API_KEY\": \"your_key\",\n \"BINANCE_US_API_SECRET\": \"your_secret\"\n }\n }\n }\n}\n```\n\n---\n\n## Credits\n\nBuilt by **[nich](https://x.com/nichxbt)** ([github.com/nirholas](https://github.com/nirholas))\n

\n $\"Follow$ \n

\n\n---\n\n## 🏢 Who's Using This?\n\nUniversal Crypto MCP is used by developers and teams building:\n\n- 🤖 **AI Trading Bots** - Automated portfolio management\n- 📊 **Analytics Dashboards** - DeFi monitoring tools\n- 🔒 **Security Auditors** - Token vetting workflows\n- 🏦 **DeFi Applications** - Cross-chain operations\n- 📱 **Mobile Apps** - Crypto portfolio trackers\n- 🎓 **Educational Tools** - Blockchain learning platforms\n\n> **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.\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions of all kinds! Please read our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Quick Start for Contributors\n\n```bash\n# Fork and clone the repo\ngit clone https://github.com/YOUR_USERNAME/universal-crypto-mcp.git\ncd universal-crypto-mcp\n\n# Install dependencies\nnpm install\n\n# Create a feature branch\ngit checkout -b feat/your-feature\n\n# Make your changes, then run checks\nnpm run lint # Check code style\nnpm test # Run tests\nnpm run test:coverage # Check coverage\n\n# Commit with conventional commits\ngit commit -m \"feat(module): add new feature\"\n\n# Push and create a PR\ngit push origin feat/your-feature\n```\n\n### Code Style\n\nWe use **Prettier** for formatting and **ESLint** for linting:\n\n```bash\nnpm run format # Format code\nnpm run lint # Check types and lint\nnpm run lint:fix # Auto-fix issues\n```\n\n### Ways to Contribute\n\n- 🐛 [Report bugs](https://github.com/nirholas/universal-crypto-mcp/issues/new?template=bug_report.yml)\n- 💡 [Request features](https://github.com/nirholas/universal-crypto-mcp/issues/new?template=feature_request.yml)\n- 📖 [Improve docs](https://github.com/nirholas/universal-crypto-mcp/edit/main/README.md)\n- 🔧 Submit pull requests\n- ⭐ [Star the repo](https://github.com/nirholas/universal-crypto-mcp/stargazers)\n\n---\n\n## 📜 License\n\nApache-2.0 © [nich](https://github.com/nirholas)\n\n---\n\n

\n Stop copy-pasting blockchain queries. Let AI do it.
\n _{Made with 💜 for the crypto community}\n

\n\n

\n \n $\"Star$ \n \n

\n\n---\n\n## 🌐 Live HTTP Deployment\n\n**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.\n\n**Endpoint:**\n```\nhttps://modelcontextprotocol.name/mcp/universal-crypto-mcp\n```\n\n### Connect from any MCP Client\n\nAdd to your MCP client configuration (Claude Desktop, Cursor, SperaxOS, etc.):\n\n```json\n{\n \"mcpServers\": {\n \"universal-crypto-mcp\": {\n \"type\": \"http\",\n \"url\": \"https://modelcontextprotocol.name/mcp/universal-crypto-mcp\"\n }\n }\n}\n```\n\n### Available Tools (11)\n\n| Tool | Description |\n|------|-------------|\n| `get_price` | Get crypto prices |\n| `get_market_overview` | Market overview |\n| `get_trending` | Trending coins |\n| `search_coins` | Search coins |\n| `get_coin_detail` | Coin details |\n| `get_global_stats` | Global stats |\n| `get_defi_protocols` | DeFi protocols |\n| `get_protocol_detail` | Protocol detail |\n| `get_chain_tvl` | Chain TVL |\n| `get_gas_prices` | Ethereum gas prices |\n| `get_token_info` | Token by contract |\n\n### Example Requests\n\n**Get crypto prices:**\n```bash\ncurl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"get_price\",\"arguments\":{\"ids\":\"bitcoin\",\"vs_currencies\":\"usd\"}}}'\n```\n\n**Market overview:**\n```bash\ncurl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"get_market_overview\",\"arguments\":{\"limit\":10}}}'\n```\n\n**Trending coins:**\n```bash\ncurl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/call\",\"params\":{\"name\":\"get_trending\",\"arguments\":{}}}'\n```\n\n### List All Tools\n\n```bash\ncurl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \\\n -H \"Content-Type: application/json\" \\\n -d '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}'\n```\n\n### Also Available On\n\n- **[SperaxOS](https://speraxos.vercel.app)** — Browse and install from the [MCP marketplace](https://speraxos.vercel.app/community/mcp)\n- **All 27 MCP servers** — See the full catalog at [modelcontextprotocol.name](https://modelcontextprotocol.name)\n\n> Powered by [modelcontextprotocol.name](https://modelcontextprotocol.name) — the open MCP HTTP gateway\n", "bytes": 53882, "sha": "f59bc4c344e08451d34a265a5b4dec70c201790901feb450c85a31e47f19ba1d", "repo_slug": "nirholas/universal-crypto-mcp", "fonte": "repo", "truncated": false, "api": "https://agentalog.com/api/listings/mcp_io_github_nirholas_universal_crypto_mcp_ed16f6bb/readme" }