Universal Blockchain MCP

Official

by nirholas · TypeScript

Universal blockchain MCP - swaps bridges staking lending Ethereum Arbitrum

Universal blockchain MCP focused on crypto interoperability. It targets “swaps” and also covers bridges, staking, and lending across multiple EVM networks, including Ethereum, Arbitrum, Optimism, Base, Polygon, and BSC.

🛠️ Key Features

Swaps
Bridges
Staking
Lending
Multi-network support across EVM ecosystems

🚀 Use Cases

Interacting with DeFi actions such as swapping assets
Accessing bridge workflows between supported chains
Performing staking and lending related operations

⚡ Developer Benefits

Built around Model Context Protocol (MCP)
Aligns with developer workflows spanning web3 and EVM tooling
Includes TypeScript in its implementation topics

⚠️ Limitations

Scope appears limited to universal blockchain/DeFi functionality listed in its description (swaps, bridges, staking, lending)

Topics

aiai-agentsarbitrumbaseblockchainbsccryptodefidexethereumevmllmmcpmodel-context-protocoloptimismpolygonsmart-contractstypescriptweb3

README.md56 KBView on GitHub

🤖💰 Universal Crypto MCP

code

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

bash

npx @nirholas/universal-crypto-mcp

npm version npm downloads x402 enabled chains

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 → | View Tutorial →

x402 Payment Protocol

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

code

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:

code

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 →

Integrated Community MCP Servers

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

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

All integrated projects maintain their original MIT licenses with full attribution.
See CONTRIBUTORS.md 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

code

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

code

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

📖 Full Documentation:

x402 README - Overview and quick start
Quickstart Guide - 5-minute setup
MCP Tools Reference - All 14 tools explained
Architecture - Technical deep dive
Examples - Real-world use cases
Security Guide - 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

Enable Developer Mode in ChatGPT settings

Start the HTTP server:

bash

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

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

For detailed setup instructions, see ChatGPT Setup Guide.

Server Modes

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

💬 Example Prompts (Copy & Paste!)

Real prompts you can use with Claude, ChatGPT, or Cursor. Just copy and paste!

🔄 Token Swaps

code

Swap 0.1 ETH for USDC on Arbitrum

code

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

code

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

📊 Market Data & Prices

code

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

code

Show me the top 10 trending coins on CoinGecko right now

code

Get the 7-day OHLCV data for Solana

code

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

code

Show me the price of token 0xdAC17F958D2ee523a2206206994597C13D831ec7 on Ethereum

🌐 DeFi Analytics (DefiLlama)

code

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

code

Show me the top 10 protocols by TVL

code

What are the best yield opportunities for stablecoins right now?

code

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

code

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

📈 DEX Analytics

code

Show me the top trending pools on Uniswap V3

code

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

code

Find all liquidity pools for PEPE on Ethereum

code

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

🔒 Security Checks

code

Is this token safe? 0x95aD61b0a150d79219dCF64E1E6Cc01f0B64C4cE (SHIB)

code

Check if this token is a honeypot: 0x... on BSC

code

Scan my wallet for risky approvals: 0xYourAddress

code

Is this dApp URL safe to connect to? https://suspicious-site.xyz

💰 Staking & Lending

code

What's the current staking APY for ETH on Lido?

code

Show me Aave lending rates for USDC on Arbitrum

code

What's my health factor on Aave if I borrow 1000 USDC against 2 ETH?

🌉 Cross-Chain Bridges

code

Bridge 100 USDC from Ethereum to Arbitrum

code

What's the cheapest way to bridge ETH from mainnet to Base?

code

Get a bridge quote for 0.5 ETH from Polygon to Optimism

⛽ Gas & Network

code

What's the current gas price on Ethereum?

code

Get EIP-1559 gas fees for all supported chains

code

Is it cheap to transact on Arbitrum right now?

🏛️ Governance

code

Show me active proposals on Uniswap

code

What's my voting power on Compound?

code

Get the results of the latest Aave governance vote

code

What's the social sentiment for Bitcoin right now?

code

Show me the top crypto influencers on social media

code

What tokens are trending on Twitter/X today?

code

Get the Galaxy Score for Ethereum

🆔 ENS Domains

code

Resolve vitalik.eth to an address

code

Who owns the ENS domain "ethereum.eth"?

code

Register the domain mycoolname.eth for 1 year

📰 Crypto News

code

Get the latest crypto news

code

Search news about Bitcoin ETF

code

What's the breaking news in DeFi?

📁 Portfolio & Wallet

code

Show my token balances on Ethereum: 0xYourAddress

code

Get all NFTs owned by vitalik.eth

code

What approvals have I granted from my wallet?

code

Track my portfolio across all EVM chains

🚀 Advanced Operations

code

Deploy a new ERC-20 token called "MyToken" (MTK) with 1 million supply on Base

code

Submit this transaction privately via Flashbots to avoid MEV

code

Encode a call to the transfer function for 100 USDC

code

Simulate this transaction before executing: 0x...

📉 Technical Indicators

code

Calculate RSI for Bitcoin over the last 14 days

code

Get MACD signal for ETH/USDT on the 4-hour timeframe

code

Show Bollinger Bands for SOL with 20-period SMA

code

What's the current trend signal for BTC using multiple indicators?

code

Run a momentum strategy analysis on DOGE

🔮 Prediction Markets

code

What are the top crypto prediction markets on Polymarket?

code

Search for Bitcoin price predictions

code

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

📊 Events & Logs

code

Get all Transfer events for USDC in the last 100 blocks on Ethereum

code

Show me Approval events for my wallet address

code

Decode this transaction log: 0x...

✍️ Signatures & Messages

code

Sign this message with my wallet: "Hello World"

code

Verify this signature is from vitalik.eth

code

Create an EIP-712 typed data signature for a permit

📦 Batch Operations (Multicall)

code

Get token balances for 10 different tokens in one call

code

Read multiple contract values at once from Aave

code

Batch check allowances for all my approved tokens

🧪 Testing

We use Vitest 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:

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

code

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

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.

⚙️ 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
Package Documentation
- Core Package
- Trading
- Market Data
- Wallets
- DeFi
- Payments (x402)
x402 Deploy Documentation
Contributing

💻 Examples

Working code examples you can run and modify:

Basic MCP Server - Minimal MCP server with market data tools
Paid API Example - Add x402 payments to Express API
Trading Bot - Automated trading bot with RSI + MA strategy
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

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	Market data, prices, OHLCV	Optional (free tier)
CoinStats	Portfolio, prices, wallets	Yes
DefiLlama	TVL, yields, fees, protocols	No
LunarCrush	Social sentiment, influencers	Yes
GoPlus	Security analysis, honeypot detection	No
GeckoTerminal	DEX pools, trades, OHLCV	No
DexPaprika	DEX analytics, pools	No
CryptoPanic	Crypto news	Yes
Alternative.me	Fear & Greed Index	No

Additional specialized MCP servers, maintained in their own repositories:

Server	Description	Tools
Binance-MCP	Binance.com global exchange API	156+ tools
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 (github.com/nirholas)

🏢 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! We'd love to feature your project.

🤝 Contributing

We welcome contributions of all kinds! Please read our Contributing Guide 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
💡 Request features
📖 Improve docs
🔧 Submit pull requests
⭐ Star the repo

📜 License

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

🌐 Live HTTP Deployment

Universal Crypto MCP is deployed and accessible over HTTP via MCP Streamable HTTP transport — no local installation required.

Endpoint:

code

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 — Browse and install from the MCP marketplace
All 27 MCP servers — See the full catalog at modelcontextprotocol.name

Powered by modelcontextprotocol.name — the open MCP HTTP gateway

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

🤖💰 Universal Crypto MCP

✨ What's New: AI Service Marketplace

x402 Payment Protocol

🆚 Why Universal Crypto MCP?

📦 Package Structure

Integrated Community MCP Servers

Supported Networks

EVM Chains

Multi-Chain (NEW)

Features

💰 x402 Payment Protocol (NEW!)

What is x402?

Quick Setup

x402 Tools (14 Total)

Supported Networks

Example

x402 Architecture

Quick Start

Claude Desktop

Cursor

ChatGPT Developer Mode

Server Modes

💬 Example Prompts (Copy & Paste!)

🔄 Token Swaps

📊 Market Data & Prices

🌐 DeFi Analytics (DefiLlama)

📈 DEX Analytics

🔒 Security Checks

💰 Staking & Lending

🌉 Cross-Chain Bridges

⛽ Gas & Network

🏛️ Governance

💬 Social Sentiment (LunarCrush)

🆔 ENS Domains

📰 Crypto News

📁 Portfolio & Wallet

🚀 Advanced Operations

📉 Technical Indicators

🔮 Prediction Markets

📊 Events & Logs

✍️ Signatures & Messages

📦 Batch Operations (Multicall)

🧪 Testing

Running Tests

MCP Inspector

Test Structure

Local Development

🧪 Testing

Running Tests

Test Structure

E2E Tests

Custom Test Utilities

Test Fixtures

⚙️ Environment Variables

What Works Without API Keys

Documentation

� Documentation & Examples

📖 Documentation

💻 Examples

�🗺️ Roadmap

Legend

🔗 Core Blockchain Operations

Network & Chain

Blocks

Transactions

Accounts/Wallets

💰 Token Operations

Native Tokens

ERC-20 (Fungible Tokens)

ERC-721 (NFTs)

ERC-1155 (Multi-Token)

Other Token Standards

🏦 DeFi - Decentralized Exchanges (DEX)

Swaps

DEX Analytics