# Universal Crypto Mcp

> Universal MCP server for AI agents to interact with any* blockchain via natural language and plugins. Supports swaps, bridges, gas, staking, lending, and more across Ethereum, Arbitrum, Base, Polygon, BSC, and testnets.

- **Type:** MCP server
- **Install:** `agentstack add mcp-nirholas-universal-crypto-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [nirholas](https://agentstack.voostack.com/s/nirholas)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [nirholas](https://github.com/nirholas)
- **Source:** https://github.com/nirholas/universal-crypto-mcp
- **Website:** https://mcp.giving

## Install

```sh
agentstack add mcp-nirholas-universal-crypto-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 🤖💰 Universal Crypto MCP     
 

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

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

  
  
  
  

  
  
  
  

  
  

  

## ✨ What's New: AI Service Marketplace

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

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

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

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

### x402 Payment Protocol

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

```
User: "Get premium weather data for Tokyo"

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

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

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

---

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

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

## 🆚 Why Universal Crypto MCP?

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

---

## 📦 Package Structure

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

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

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

### Integrated Community MCP Servers

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

| Project | Author | Category | Description |
|---------|--------|----------|-------------|
| [evm-mcp-server](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](CONTRIBUTORS.md) for detailed attribution and our modifications.

---

## Supported Networks

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

### Multi-Chain (NEW)
- **Cosmos/IBC** - ATOM, OSMO, JUNO, INJ, and more
- **Near Protocol** - NEAR native + contracts
- **Sui** - SUI with Move support
- **Aptos** - APT with Move support
- Bitcoin, Litecoin, Solana, TON, XRP, THORChain

## Features

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

---

## 💰 x402 Payment Protocol (NEW!)

  
  

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

### What is x402?

x402 implements HTTP 402 Payment Required, enabling AI agents to:
- 💸 **Pay for APIs** - Automatically pay for premium API access
- 🤖 **Autonomous Payments** - No human approval needed
- 🏦 **Hold funds** - Agents have their own crypto wallets
- 📈 **Earn yield** - Payments use USDs stablecoin (~5% APY auto-yield)

### Quick Setup

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

---

## Quick Start

### Claude Desktop

Add to your `claude_desktop_config.json`:

```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? 0x

…

## Source & license

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

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

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** yes
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** yes
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-nirholas-universal-crypto-mcp
- Seller: https://agentstack.voostack.com/s/nirholas
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.