by nirholas
Enables AI agents to interact with any blockchain via natural language, providing swaps, bridges, gas estimation, staking, lending, and autonomous crypto payments across Ethereum, Arbitrum, Base, Polygon, BSC, Solana and many testnets.
Universal Crypto MCP is a Model Context Protocol (MCP) server that lets AI agents execute blockchain operations without writing code. It aggregates more than 380 tools covering DeFi, market data, security analysis, cross‑chain bridges, and the new x402 payment protocol, so agents can both pay for services and receive crypto directly.
npx @nirholas/universal-crypto-mcp
Use the --http flag for ChatGPT Developer Mode or --sse for legacy clients..env:
PRIVATE_KEY=0xYOUR_PRIVATE_KEY # required for any transaction
COINGECKO_API_KEY=YOUR_KEY
LUNARCRUSH_API_KEY=YOUR_KEY
CRYPTOPANIC_API_KEY=YOUR_KEY
RUBIC_API_KEY=YOUR_KEY
ETHEREUM_RPC_URL=https://mainnet.infura.io/v3/YOUR_PROJECT_ID
Q: Do I need a private key to use the server? A: A private key is only required for write actions (swaps, transfers, payments). Read‑only queries work without it.
Q: Which chains are supported out of the box? A: All major EVM chains (Ethereum, BSC, Polygon, Arbitrum, Base, Optimism, Avalanche, Fantom, zkSync Era, Linea, Scroll, Blast, Mode, Mantle, opBNB) plus Solana, Cosmos‑IBC, Near, Sui, Aptos, Bitcoin, Litecoin, TON, XRP, THORChain.
Q: How does x402 differ from a regular transaction? A: x402 implements HTTP 402 Payment Required. The agent sends a request, the server automatically deducts the required USDs amount from its wallet, and forwards the request to the target API, enabling “pay‑per‑use” without human interaction.
Q: Can I run the server locally behind a firewall? A: Yes. The server runs as a standard Node.js process and can be bound to any port or used via stdio for offline environments.
Q: What limits exist for free API usage?
A: Most public APIs (CoinGecko, DefiLlama, GoPlus) have generous free tiers. For higher rate limits, provide the corresponding API keys in the .env file.
Q: How do I add my own custom tool?
A: Create a new package under packages/ following the existing tool conventions, export the tool definition, and rebuild the monorepo. The server will automatically expose it.
Q: Is the server compatible with ChatGPT’s developer mode?
A: Yes. Start the server with npx @nirholas/universal-crypto-mcp --http and point ChatGPT to http://localhost:<port>/mcp in the Apps settings.
npx @nirholas/universal-crypto-mcp
Monetize your AI services & discover the best APIs! 💸
The AI Service Marketplace is a complete ecosystem for AI service discovery, monetization, and reputation management:
Learn more → | View Tutorial →
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:
⭐ 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.
| 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 |
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 →
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.
Give Claude Money! AI agents can now make and receive cryptocurrency payments.
x402 implements HTTP 402 Payment Required, enabling AI agents to:
# Add to your environment
export X402_PRIVATE_KEY=0x... # Your EVM private key
export X402_CHAIN=arbitrum # Default chain (or base, ethereum, polygon)
| 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 |
| Network | CAIP-2 | Status |
|---|---|---|
| Base | eip155:8453 |
✅ Recommended |
| Arbitrum | eip155:42161 |
✅ Supported |
| Ethereum | eip155:1 |
✅ Supported |
| Polygon | eip155:137 |
✅ Supported |
| Solana | solana:mainnet |
✅ Supported |
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 │
│ │ │
└────────────────┴───────────────────┘
📖 Full Documentation:
Add to your claude_desktop_config.json:
{
"mcpServers": {
"universal-crypto-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
"env": {
"PRIVATE_KEY": "your_private_key_here (optional)"
}
}
}
}
Add to your MCP settings:
{
"mcpServers": {
"universal-crypto-mcp": {
"command": "npx",
"args": ["-y", "@nirholas/universal-crypto-mcp@latest"],
"env": {
"PRIVATE_KEY": "your_private_key_here (optional)"
}
}
}
}
npx @nirholas/universal-crypto-mcp@latest --http
http://localhost:3001/mcpFor detailed setup instructions, see ChatGPT Setup Guide.
| 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 |
Real prompts you can use with Claude, ChatGPT, or Cursor. Just copy and paste!
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
We use Vitest as our testing framework with comprehensive test coverage.
# 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
Test your MCP tools interactively using the official MCP Inspector:
npm run test:inspector
This opens a browser-based UI where you can:
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
| 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 |
End-to-end tests verify the complete tool execution flow:
The project includes custom Vitest matchers for MCP responses:
// In your test file
import "../utils/assertions"
expect(result).toBeSuccessfulToolResponse()
expect(result).toHaveJsonProperty("balance")
expect(result).toContainValidAddress()
expect(result).toContainToolError(/invalid/i)
Reusable test data in tests/utils/fixtures.ts:
import {
ETH_MAINNET_ADDRESSES,
MOCK_TOKEN_DATA,
generateRandomAddress
} from "../utils/fixtures"
For detailed testing documentation, see tests/README.md.
Configure optional API keys for enhanced features. Create a .env file:
# 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
| 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 |
Comprehensive guides and API references:
Working code examples you can run and modify:
Each example includes:
A comprehensive roadmap of all crypto/blockchain/DeFi/Web3 features to be implemented.
| 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 | ✅ |
| 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 | ✅ |
| 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 | ✅ |
| 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 | ✅ |
| Feature | Status |
|---|---|
| Get native balance | ✅ |
| Transfer native tokens | ✅ |
| Wrap/unwrap native tokens (WETH, WBNB) | ✅ |
| 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 | ✅ |
| 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 | ✅ |
| Feature | Status |
|---|---|
| Get token balance (fungible + NFT) | ✅ |
| Batch transfers | 📋 |
| Batch balance queries | 📋 |
| Safe transfer | ✅ |
| Get URI | ✅ |
| 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) | 📋 |
| 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) | 📋 |
| 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 | ✅ |
| 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 | ✅ |
| Feature | Status |
|---|---|
| Constant product (x*y=k) | ✅ |
| Stable swap (Curve) | 📋 |
| Concentrated liquidity | 📋 |
| Order book hybrid | 📋 |
| Virtual AMM (perpetuals) | 📋 |
| Feature | Status |
|---|---|
| Supply/deposit assets | ✅ |
| Withdraw assets | ✅ |
| Get supply APY | ✅ |
| Get supplied balance | ✅ |
| Get utilization rate | 📋 |
| Enable/disable as collateral | 📋 |
| 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 | ✅ |
| Feature | Status |
|---|---|
| Liquidate unhealthy positions | 📋 |
| Get liquidatable positions | ✅ |
| Get liquidation bonus | 📋 |
| Partial liquidations | 📋 |
| Feature | Status |
|---|---|
| Supply to isolated pool | 📋 |
| Borrow from isolated pool | 📋 |
| Get isolation mode debt ceiling | 📋 |
| Feature | Status |
|---|---|
| Stake native tokens | ✅ |
| Unstake/withdraw | ✅ |
| Claim rewards | ✅ |
| Get staking APY | ✅ |
| Get validator list | 📋 |
| Delegate to validator | 📋 |
| Redelegate | 📋 |
| Get unbonding period | 📋 |
| Feature | Status |
|---|---|
| Stake for liquid staking tokens (stETH, rETH) | ✅ |
| Unwrap liquid staking tokens | ✅ |
| Get exchange rate | ✅ |
| Get staking rewards rate | ✅ |
| Feature | Status |
|---|---|
| Stake LP tokens | ✅ |
| Unstake LP tokens | ✅ |
| Claim farming rewards | ✅ |
| Get farming APY | ✅ |
| Compound rewards | 📋 |
| Get pending rewards | ✅ |
| Boost rewards (veTokens) | 📋 |
| Feature | Status |
|---|---|
| Restake assets (EigenLayer) | 📋 |
| Get restaking points | 📋 |
| Choose operators | 📋 |
| Withdraw from restaking | 📋 |
| 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 | 📋 |
| Feature | Status |
|---|---|
| Buy call/put options | 📋 |
| Sell/write options | 📋 |
| Exercise options | 📋 |
| Get option greeks | 📋 |
| Get implied volatility | 📋 |
| Get option chain | 📋 |
| Spread strategies | 📋 |
| Feature | Status |
|---|---|
| Mint synthetic assets | 📋 |
| Burn synthetic assets | 📋 |
| Get collateral ratio | 📋 |
| Get synthetic price feed | 📋 |
| Liquidate synthetic positions | 📋 |
| 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 | ✅ |
| Feature | Status |
|---|---|
| Send cross-chain message | 📋 |
| Receive cross-chain message | 📋 |
| LayerZero operations | 📋 |
| Axelar operations | 📋 |
| Wormhole operations | 📋 |
| CCIP (Chainlink) | 📋 |
| Hyperlane operations | 📋 |
| Feature | Status |
|---|---|
| Initiate atomic swap | 📋 |
| Complete atomic swap | 📋 |
| Refund atomic swap | 📋 |
| Feature | Status |
|---|---|
| Create proposal | ✅ |
| Vote on proposal | ✅ |
| Delegate votes | ✅ |
| Get voting power | ✅ |
| Get proposal state | ✅ |
| Queue proposal | ✅ |
| Execute proposal | ✅ |
| Cancel proposal | ✅ |
| Get vote receipt | ✅ |
| Feature | Status |
|---|---|
| Lock tokens for voting (veTokens) | 📋 |
| Extend lock period | 📋 |
| Increase locked amount | 📋 |
| Withdraw unlocked tokens | 📋 |
| Get lock info | 📋 |
| Feature | Status |
|---|---|
| Create space | 📋 |
| Create off-chain proposal | 📋 |
| Vote off-chain | 📋 |
| Get snapshot results | 📋 |
| 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 | ✅ |
| 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 | ✅ |
| 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 | ✅ |
| 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 | ✅ |
| 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 | ✅ |
| 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 | ✅ |
| Feature | Status |
|---|---|
| Unstoppable Domains | 📋 |
| Space ID (.bnb) | 📋 |
| Bonfida (.sol) | 📋 |
| ANS (.avax) | 📋 |
| Feature | Status |
|---|---|
| Create DID | 📋 |
| Resolve DID | 📋 |
| Issue verifiable credential | 📋 |
| Verify credential | 📋 |
| Revoke credential | 📋 |
| 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 | 📋 |
| Feature | Status |
|---|---|
| Deploy NFT collection | 📋 |
| Mint NFTs | 📋 |
| Set royalties | 📋 |
| Set metadata | 📋 |
| Reveal NFTs | 📋 |
| Whitelist management | 📋 |
| Airdrop NFTs | 📋 |
| Feature | Status |
|---|---|
| NFT collateralized loans | 📋 |
| NFT fractionalization | 📋 |
| NFT renting | 📋 |
| NFT staking | 📋 |
| Feature | Status |
|---|---|
| Buy virtual land | 📋 |
| Sell virtual land | 📋 |
| Build on land | 📋 |
| Transfer assets between metaverses | 📋 |
| 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 | ✅ |
| Feature | Status |
|---|---|
| Set up webhook for events | 📋 |
| Get transaction notifications | 📋 |
| Get price alerts | 📋 |
| Get whale alerts | 📋 |
| Get governance notifications | 📋 |
| Feature | Status |
|---|---|
| Call view/pure functions | ✅ |
| Get storage at slot | ✅ |
| Get contract bytecode | ✅ |
| Multicall (batch reads) | ✅ |
| Static call simulation | ✅ |
| Feature | Status |
|---|---|
| Send transaction to contract | ✅ |
| Encode function call | ✅ |
| Decode function result | ✅ |
| Estimate gas for call | ✅ |
| Batch transactions | ✅ |
| Feature | Status |
|---|---|
| Deploy contract | ✅ |
| Deploy with CREATE2 | ✅ |
| Deploy proxy contract | ✅ |
| Upgrade proxy | ✅ |
| Verify on explorer | ✅ |
| Feature | Status |
|---|---|
| Submit private transaction | ✅ |
| Submit bundle | ✅ |
| Get MEV opportunities | ✅ |
| Backrun protection | ✅ |
| Frontrun protection | ✅ |
| Sandwich protection | ✅ |
| Feature | Status |
|---|---|
| Create smart account | 📋 |
| Execute user operation | 📋 |
| Batch operations | 📋 |
| Sponsor gas (Paymaster) | 📋 |
| Session keys | 📋 |
| Social recovery | 📋 |
| Feature | Status |
|---|---|
| Submit intent | 📋 |
| Get solver quotes | 📋 |
| Execute via solver | 📋 |
| Feature | Status |
|---|---|
| Get Chainlink price | ✅ |
| Get Pyth price | 📋 |
| Get Band Protocol price | 📋 |
| Get API3 price | 📋 |
| Request randomness (VRF) | 📋 |
| Request external data | 📋 |
| Feature | Status |
|---|---|
| Get gas price | ✅ |
| Get priority fee | ✅ |
| Get base fee | ✅ |
| Get gas history | ✅ |
| Estimate gas for transaction | ✅ |
| Get EIP-1559 fees | ✅ |
| Feature | Status |
|---|---|
| ABI encode | ✅ |
| ABI decode | ✅ |
| Keccak256 hash | ✅ |
| Pack/unpack data | ✅ |
| Sign typed data (EIP-712) | ✅ |
| Feature | Status |
|---|---|
| Validate address | ✅ |
| Checksum address | ✅ |
| Get address from ENS | ✅ |
| Check if contract | ✅ |
| Get contract type | 📋 |
| 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 | 📋 |
| Feature | Status |
|---|---|
| Get token holders | 📋 |
| Get whale wallets | 📋 |
| Get smart money movements | 📋 |
| Get protocol users | 📋 |
| Get daily active addresses | 📋 |
| Get network hash rate | 📋 |
| Feature | Status |
|---|---|
| Wallet screening | 📋 |
| Transaction monitoring | 📋 |
| Risk scoring | 📋 |
| Sanctions checking | 📋 |
| Feature | Status |
|---|---|
| Multi-sig operations | 📋 |
| Cold storage | 📋 |
| Hot wallet management | 📋 |
| Policy enforcement | 📋 |
| Feature | Status |
|---|---|
| Tax reporting | 📋 |
| Portfolio tracking | ✅ |
| P&L reporting | 📋 |
| Transaction history export | 📋 |
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 in this workspace:
| Server | Description | Tools |
|---|---|---|
| binance-mcp-server | Binance.com global exchange API | 156+ tools |
| binance-us-mcp-server | Binance.US exchange API | 71+ tools |
Full Binance global API coverage including:
{
"mcpServers": {
"binance": {
"command": "npx",
"args": ["ts-node", "binance-mcp-server/src/index.ts"],
"env": {
"BINANCE_API_KEY": "your_key",
"BINANCE_API_SECRET": "your_secret"
}
}
}
}
US-regulated exchange with:
{
"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"
}
}
}
}
Built by nich (github.com/nirholas)
Universal Crypto MCP is used by developers and teams building:
Using Universal Crypto MCP? Let us know! We'd love to feature your project.
We welcome contributions of all kinds! Please read our Contributing Guide for details.
# 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
We use Prettier for formatting and ESLint for linting:
npm run format # Format code
npm run lint # Check types and lint
npm run lint:fix # Auto-fix issues
Apache-2.0 © nich
Please log in to share your review and rating for this MCP.
Explore related MCPs that share similar capabilities and solve comparable challenges
by modelcontextprotocol
A Model Context Protocol server for Git repository interaction and automation.
by zed-industries
A high‑performance, multiplayer code editor designed for speed and collaboration.
by modelcontextprotocol
Model Context Protocol Servers
by modelcontextprotocol
A Model Context Protocol server that provides time and timezone conversion capabilities.
by cline
An autonomous coding assistant that can create and edit files, execute terminal commands, and interact with a browser directly from your IDE, operating step‑by‑step with explicit user permission.
by upstash
Provides up-to-date, version‑specific library documentation and code examples directly inside LLM prompts, eliminating outdated information and hallucinated APIs.
by daytonaio
Provides a secure, elastic infrastructure that creates isolated sandboxes for running AI‑generated code with sub‑90 ms startup, unlimited persistence, and OCI/Docker compatibility.
by continuedev
Enables faster shipping of code by integrating continuous AI agents across IDEs, terminals, and CI pipelines, offering chat, edit, autocomplete, and customizable agent workflows.
by github
Connects AI tools directly to GitHub, enabling natural‑language interactions for repository browsing, issue and pull‑request management, CI/CD monitoring, code‑security analysis, and team collaboration.
{
"mcpServers": {
"universal-crypto-mcp": {
"command": "npx",
"args": [
"-y",
"@nirholas/universal-crypto-mcp"
],
"env": {
"PRIVATE_KEY": "<YOUR_PRIVATE_KEY>",
"COINGECKO_API_KEY": "<YOUR_COINGECKO_API_KEY>",
"COINSTATS_API_KEY": "<YOUR_COINSTATS_API_KEY>",
"LUNARCRUSH_API_KEY": "<YOUR_LUNARCRUSH_API_KEY>",
"CRYPTOPANIC_API_KEY": "<YOUR_CRYPTOPANIC_API_KEY>",
"RUBIC_API_KEY": "<YOUR_RUBIC_API_KEY>",
"ETHEREUM_RPC_URL": "<YOUR_ETHEREUM_RPC_URL>",
"ARBITRUM_RPC_URL": "<YOUR_ARBITRUM_RPC_URL>",
"BASE_RPC_URL": "<YOUR_BASE_RPC_URL>"
}
}
}
}claude mcp add universal-crypto-mcp npx -y @nirholas/universal-crypto-mcp