npx @nirholas/universal-crypto-mcp

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)...

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

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

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..."

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

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

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

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?

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

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

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?

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

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?

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

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?

Show me active proposals on Uniswap

What's my voting power on Compound?

Get the results of the latest Aave governance vote

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

Resolve vitalik.eth to an address

Who owns the ENS domain "ethereum.eth"?

Register the domain mycoolname.eth for 1 year

Get the latest crypto news

Search news about Bitcoin ETF

What's the breaking news in DeFi?

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

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...

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

What are the top crypto prediction markets on Polymarket?

Search for Bitcoin price predictions

What's the current odds for ETH reaching $5000?

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...

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

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

# 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

npm run test:inspector

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

# 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

# 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

// In your test file
import "../utils/assertions"

expect(result).toBeSuccessfulToolResponse()
expect(result).toHaveJsonProperty("balance")
expect(result).toContainValidAddress()
expect(result).toContainToolError(/invalid/i)

import {
  ETH_MAINNET_ADDRESSES,
  MOCK_TOKEN_DATA,
  generateRandomAddress
} from "../utils/fixtures"

# 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

{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["ts-node", "binance-mcp-server/src/index.ts"],
      "env": {
        "BINANCE_API_KEY": "your_key",
        "BINANCE_API_SECRET": "your_secret"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}

# 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

npm run format    # Format code
npm run lint      # Check types and lint
npm run lint:fix  # Auto-fix issues

https://modelcontextprotocol.name/mcp/universal-crypto-mcp

{
  "mcpServers": {
    "universal-crypto-mcp": {
      "type": "http",
      "url": "https://modelcontextprotocol.name/mcp/universal-crypto-mcp"
    }
  }
}

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"}}}'

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}}}'

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":{}}}'

curl -X POST https://modelcontextprotocol.name/mcp/universal-crypto-mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'