Universal Crypto MCP

Permitir que agentes de IA interajam com qualquer blockchain EVM por meio de linguagem natural.

Documentação

🤖💰 Universal Crypto MCP

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

npx @nirholas/universal-crypto-mcp

npm version npm downloads x402 enabled chains

MCP Compatible TypeScript Node.js 18+ License: Apache 2.0

GitHub Stars Issues

Universal Crypto MCP Demo

✨ Novidades: Marketplace de Serviços de IA

Monetize seus serviços de IA e descubra as melhores APIs! 💸

O Marketplace de Serviços de IA é um ecossistema completo para descoberta de serviços de IA, monetização e gestão de reputação:

  • 🏪 Registre seu serviço de IA - Monetização instantânea com pagamento por uso ou assinaturas
  • 🔍 Agentes de IA descobrem serviços - Descoberta automática por categoria, preço e avaliação
  • Reputação on-chain - Construa confiança com avaliações e comentários verificados
  • 💳 Preços flexíveis - Pagamento por uso, assinaturas, níveis gratuitos
  • 📊 Painel de análises - Acompanhe uso, receita e desempenho
  • 🔒 Pagamentos seguros - Escrow, resolução de disputas, reembolsos automáticos

Saiba mais → | Ver Tutorial →

Protocolo de Pagamento x402

Agentes de IA agora podem pagar por coisas na 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)...

Agentes de IA agora podem:

  • 💸 Pagar por APIs premium automaticamente
  • 🏪 Vender seus próprios serviços para outros agentes
  • 🔄 Negociar com outros agentes de IA peer-to-peer
  • ⛓️ Operar entre cadeias EVM + Solana

Se você acha isso útil, por favor dê uma estrela no repositório! Isso ajuda outras pessoas a descobrirem este projeto.


Um servidor Universal Model Context Protocol para todas as redes compatíveis com EVM + Solana.

Permite que agentes de IA (Claude, ChatGPT, Cursor) interajam com qualquer blockchain EVM através de linguagem natural.

🆚 Por que Universal Crypto MCP?

RecursoUniversal Crypto MCPOutros Servidores MCP
Ferramentas380+ ferramentas10-50 ferramentas
Cadeias20+ cadeias (EVM + multi-cadeia)1-3 cadeias
Suporte DEXMulti-agregador (1inch, 0x, ParaSwap)DEX único ou nenhum
SegurançaGoPlus, honeypot, detecção de rug pullBásica ou nenhuma
DeFiAave, Compound, Lido, UniswapLimitado
Dados de MercadoCoinGecko, DefiLlama, LunarCrushPreços básicos
PontesLayerZero, Stargate, WormholeNenhuma
Proteção MEVIntegração FlashbotsNenhuma
Transportestdio, HTTP, SSEGeralmente apenas stdio
Suporte ChatGPT✅ Modo HTTP nativo❌ A maioria não

📦 Estrutura do Pacote

O monorepo MCP de cripto mais abrangente com 10+ pacotes integrados dos melhores projetos licenciados sob MIT:

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

📖 Ver Documentação do Pacote →

Servidores MCP Comunitários Integrados

Este repositório consolida os melhores projetos MCP de cripto licenciados sob MIT com atribuição adequada:

ProjetoAutorCategoriaDescrição
evm-mcp-servermcpdotdirectdefi60+ redes, 22+ ferramentas
crypto-indicators-mcpNOVOKukapaydados-de-mercadoIndicadores técnicos (RSI, MACD, Bollinger)
crypto-sentiment-mcpNOVOKukapaydados-de-mercadoAnálise de sentimento multi-fonte
crypto-feargreed-mcpNOVOKukapaydados-de-mercadoÍndice de Medo e Ganância
cryptopanic-mcp-serverKukapaydados-de-mercadoAgregação de notícias de cripto
coinmarketcap-mcpNOVOShinzo Labsdados-de-mercadoAPI CMC completa
whale-tracker-mcpKukapayanálisesRastreamento de grandes carteiras
mcp-web3-statscrazyrabbitLTCanálisesIntegração Dune Analytics
dexpaprika-mcpCoinPaprikapreçosDados de preços DEX
algorand-mcpNOVOGoPlausibleblockchain40+ ferramentas Algorand
bybit-mcp-serverNOVOethancod1ngexchangeIntegração API Bybit
bsc-mcpNOVOTermiXdefiOperações e segurança BSC
onchain-mcpBanklessdefiFerramentas on-chain
mcp-free-usdc-transferMagnetAIpagamentosTransferências USDC gratuitas

Todos os projetos integrados mantêm suas licenças MIT originais com atribuição completa.
Veja CONTRIBUTORS.md para atribuição detalhada e nossas modificações.


Redes Suportadas

Cadeias EVM

  • Ethereum, BNB Smart Chain (BSC), Polygon, Arbitrum, Base, Optimism
  • Avalanche, Fantom, zkSync Era, Linea, Scroll, Blast, Mode, Mantle
  • opBNB + todas as testnets

Multi-Cadeia (NOVO)

  • Cosmos/IBC - ATOM, OSMO, JUNO, INJ, e mais
  • Near Protocol - NEAR nativo + contratos
  • Sui - SUI com suporte Move
  • Aptos - APT com suporte Move
  • Bitcoin, Litecoin, Solana, TON, XRP, THORChain

Recursos

  • 🔄 Swap/DEX - Trocas de tokens via 1inch, 0x, ParaSwap
  • 🌉 Ponte - Transferências entre cadeias via LayerZero, Stargate, Wormhole
  • Gas - Preços de gas entre cadeias, sugestões EIP-1559
  • 📦 Multicall - Operações de leitura/escrita em lote
  • 📊 Eventos/Logs - Consultar eventos históricos, decodificar logs
  • 🔒 Segurança - Detecção de rug pull, verificação de honeypot, segurança de token/endereço GoPlus, detecção de phishing em dApps
  • 💰 Staking - Staking líquido (Lido), farming de LP
  • ✍️ Assinaturas - Assinar mensagens, verificar assinaturas, EIP-712
  • 🏦 Empréstimos - Posições Aave/Compound, taxas de empréstimo
  • 📈 Feeds de Preço - Preços históricos, TWAP, agregação de oráculos
  • 📁 Portfólio - Acompanhar participações entre cadeias
  • 🏛️ Governança - Votos Snapshot, propostas on-chain
  • 🚀 Implantação - Implantar contratos, CREATE2, proxies atualizáveis, verificação
  • 🛡️ Proteção MEV - Flashbots Protect, transações privadas, simulação de pacotes
  • 🆔 ENS/Domínios - Registrar, transferir, renovar, definir registros, subdomínios
  • 📊 Dados de Mercado - Preços CoinGecko & CoinStats, OHLCV, tendências, categorias, exchanges
  • 🌐 Análises DeFi - DefiLlama TVL, rendimentos, taxas, pontes, stablecoins, dados de protocolo
  • 💬 Sentimento Social - Métricas sociais LunarCrush, influenciadores, tópicos em tendência
  • 📈 Análises DEX - Pools DexPaprika & GeckoTerminal, negociações, OHLCV, tokens em tendência
  • 🔮 Previsões - Mercados de previsão Polymarket, previsões de cripto
  • 📉 Indicadores Técnicos - 50+ indicadores (RSI, MACD, Bandas de Bollinger, etc.)
  • 🔔 Alertas - Alertas de preço, alertas de movimento de baleias, alertas de gas (NOVO)
  • 📡 WebSockets - Streams de preço em tempo real, feeds de negociação, monitoramento de mempool (NOVO)
  • 🐋 Análises de Carteira - Rastreamento de baleias, pontuação de carteiras, análise de comportamento (NOVO)
  • 🌐 Multi-Cadeia - Suporte nativo Cosmos, Near, Sui, Aptos (NOVO)
  • 💰 Pagamentos x402 - Agentes de IA podem pagar por APIs premium automaticamente (NOVO)

💰 Protocolo de Pagamento x402 (NOVO!)

x402 Give Claude Money

Dê dinheiro ao Claude! Agentes de IA agora podem fazer e receber pagamentos em criptomoedas.

O que é x402?

x402 implementa HTTP 402 Payment Required, permitindo que agentes de IA:

  • 💸 Paguem por APIs - Paguem automaticamente por acesso a APIs premium
  • 🤖 Pagamentos Autônomos - Sem necessidade de aprovação humana
  • 🏦 Mantenham fundos - Agentes têm suas próprias carteiras de cripto
  • 📈 Ganhem rendimento - Pagamentos usam stablecoin USDs (~5% APY com rendimento automático)

Configuração Rápida

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

Ferramentas x402 (14 no Total)

FerramentaDescrição
x402_pay_requestFazer requisição HTTP com pagamento 402 automático
x402_balanceVerificar saldo da carteira (USDC/USDs + nativo)
x402_sendEnviar pagamento direto para um endereço
x402_batch_sendEnviar múltiplos pagamentos em uma transação
x402_gasless_sendEnviar pagamento sem pagar gas
x402_estimateVerificar custo antes de pagar
x402_addressObter seu endereço de carteira
x402_networksListar redes suportadas
x402_yieldVerificar ganhos de rendimento automático USDs
x402_apyObter taxa APY atual
x402_yield_estimateProjetar rendimento futuro
x402_approveAprovar gasto de tokens
x402_tx_statusVerificar status da transação
x402_configVer configuração atual

Redes Suportadas

RedeCAIP-2Status
Baseeip155:8453✅ Recomendada
Arbitrumeip155:42161✅ Suportada
Ethereumeip155:1✅ Suportada
Polygoneip155:137✅ Suportada
Solanasolana:mainnet✅ Suportada

Exemplo

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

Arquitetura x402

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

📖 Documentação Completa:


Início Rápido

Claude Desktop

Adicione ao seu 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)"
      }
    }
  }
}

Cursor

Adicione às suas configurações MCP:

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

Modo Desenvolvedor ChatGPT

  1. Ative o Modo Desenvolvedor nas configurações do ChatGPT
  2. Inicie o servidor HTTP:
    npx @nirholas/universal-crypto-mcp@latest --http
    
  3. Em Configurações do ChatGPT → Apps, clique em Criar app
  4. Digite a URL do seu servidor: http://localhost:3001/mcp
  5. Selecione o app nas conversas através do menu Modo desenvolvedor

Para instruções detalhadas de configuração, veja Guia de Configuração ChatGPT.

Modos de Servidor

ModoComandoCaso de Uso
stdionpx @nirholas/universal-crypto-mcpClaude Desktop, Cursor
HTTPnpx @nirholas/universal-crypto-mcp --httpModo Desenvolvedor ChatGPT
SSEnpx @nirholas/universal-crypto-mcp --sseClientes HTTP legados

💬 Exemplos de Prompts (Copie e Cole!)

Prompts reais que você pode usar com Claude, ChatGPT ou Cursor. Basta copiar e colar!

🔄 Trocas de Tokens

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?

📊 Dados de Mercado e Preços

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

🌐 Análises DeFi (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

📈 Análises DEX

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?

🔒 Verificações de Segurança

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

💰 Staking e Empréstimos

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?

🌉 Pontes Cross-Chain

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

⛽ Gás e Rede

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?

🏛️ Governança

Show me active proposals on Uniswap
What's my voting power on Compound?
Get the results of the latest Aave governance vote

💬 Sentimento Social (LunarCrush)

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

🆔 Domínios ENS

Resolve vitalik.eth to an address
Who owns the ENS domain "ethereum.eth"?
Register the domain mycoolname.eth for 1 year

📰 Notícias de Cripto

Get the latest crypto news
Search news about Bitcoin ETF
What's the breaking news in DeFi?

📁 Portfólio e Carteira

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

🚀 Operações Avançadas

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

📉 Indicadores Técnicos

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

🔮 Mercados de Previsão

What are the top crypto prediction markets on Polymarket?
Search for Bitcoin price predictions
What's the current odds for ETH reaching $5000?

📊 Eventos e Logs

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

✍️ Assinaturas e Mensagens

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

📦 Operações em Lote (Multicall)

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

🧪 Testes

Usamos Vitest como nosso framework de testes com cobertura abrangente de testes.

Executando Testes

# 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

Teste suas ferramentas MCP interativamente usando o MCP Inspector oficial:

npm run test:inspector

Isso abre uma interface baseada em navegador onde você pode:

  • Navegar por todas as ferramentas e prompts disponíveis
  • Testar a execução de ferramentas com parâmetros personalizados
  • Visualizar respostas das ferramentas e depurar problemas
  • Validar a implementação do seu servidor MCP

Estrutura de Testes

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

Desenvolvimento Local

# 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

🧪 Testes

Code Coverage Tests

Executando Testes

# 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

Estrutura de Testes

TipoLocalizaçãoDescrição
Unitáriosrc/**/*.test.tsTesta funções/módulos individuais
Integraçãotests/integration/Testa múltiplos componentes juntos
E2Etests/e2e/Testa o fluxo completo do servidor MCP

Testes E2E

Os testes de ponta a ponta verificam o fluxo completo de execução das ferramentas:

  • Ferramentas EVM - Operações de bloco, saldo e token entre cadeias
  • Ferramentas DeFi - TVL de protocolos, rendimentos, stablecoins via DefiLlama
  • Dados de Mercado - CoinGecko, índice de Medo e Ganância
  • Multicadeia - Mesmas operações em diferentes redes
  • Recuperação de Erros - Tratamento de erros, entradas inválidas, casos extremos

Utilitários de Teste Personalizados

O projeto inclui matchers personalizados do Vitest para respostas MCP:

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

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

Fixtures de Teste

Dados de teste reutilizáveis em tests/utils/fixtures.ts:

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

Para documentação detalhada de testes, consulte tests/README.md.


⚙️ Variáveis de Ambiente

Configure chaves de API opcionais para recursos aprimorados. Crie um arquivo .env:

# 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

O Que Funciona Sem Chaves de API

RecursoSem Chave de APICom Chave de API
Preços de tokens✅ CoinGecko nível gratuito✅ Limites de taxa mais altos
Análises DeFi✅ DefiLlama (gratuito)-
Verificações de segurança✅ GoPlus (gratuito)-
Análises DEX✅ GeckoTerminal (gratuito)-
Sentimento social✅ LunarCrush
Notícias de cripto✅ CryptoPanic
Trocas cross-chain✅ Básico✅ Melhores rotas

Documentação

https://mcp.giving


📖 Documentação e Exemplos

📖 Documentação

Guias abrangentes e referências de API:

💻 Exemplos

Exemplos de código funcionais que você pode executar e modificar:

Cada exemplo inclui:

  • Código-fonte completo
  • README com instruções de configuração
  • Configuração do pacote
  • Guia de configuração de ambiente

🗺️ Roadmap

Um roadmap abrangente de todos os recursos de cripto/blockchain/DeFi/Web3 a serem implementados.

Legenda

  • ✅ Implementado
  • 🚧 Em Andamento
  • 📋 Planejado
🔗 Operações Principais de Blockchain (clique para expandir)

🔗 Operações Principais de Blockchain

Rede e Cadeia

RecursoStatus
Obter ID da cadeia, número do bloco, preço do gás
Obter status/health da rede
Alternar redes/cadeias
Obter lista de redes suportadas
Obter endpoints RPC
Estimar tempo de bloco
Obter metadados da cadeia (nome, símbolo, exploradores)
Obter status de finalidade
Obter transações pendentes/mempool
Obter peers/nós da rede
Obter oráculo de gás

Blocos

RecursoStatus
Obter bloco por número/hash
Obter bloco mais recente
Obter transações do bloco
Obter recibos do bloco
Obter blocos tio
Assinar novos blocos📋
Obter recompensas do bloco
Obter gás usado/limite do bloco
Obter intervalo de blocos
Obter blocos por minerador

Transações

RecursoStatus
Enviar transação
Obter transação por hash
Obter recibo da transação
Obter status da transação
Estimar gás
Acelerar transação (substituir com gás maior)
Cancelar transação
Decodificar entrada da transação
Simular transação
Obter rastreamento da transação📋
Obter transações internas📋
Transações em lote
Obter transações pendentes
Obter histórico de transações por endereço

Contas/Carteiras

RecursoStatus
Obter saldo (nativo/token)
Obter nonce
Obter contagem de transações
Criar carteira
Importar carteira (chave privada/mnemônica)
Exportar chave privada📋
Assinar mensagem
Verificar assinatura
Obter endereço a partir da chave privada
Gerar mnemônica
Derivar endereços (carteira HD)
Operações de carteira multi-assinatura📋
Obter permissões da carteira📋
Revogar aprovações
Abstração de conta (ERC-4337)📋
Recuperação social📋
Integração com carteira de hardware📋
Obter portfólio da carteira
Obter aprovações de tokens
💰 Operações com Tokens (clique para expandir)

💰 Operações com Tokens

Tokens Nativos

RecursoStatus
Obter saldo nativo
Transferir tokens nativos
Envolver/desenvolver tokens nativos (WETH, WBNB)

ERC-20 (Tokens Fungíveis)

RecursoStatus
Obter informações do token (nome, símbolo, decimais, fornecimento total)
Obter saldo do token
Transferir tokens
Aprovar gastos
Obter allowance
Transferir de (delegado)
Queimar tokens
Cunhar tokens
Obter detentores do token
Obter transferências do token
Permit (aprovações sem gás - EIP-2612)
Transferências em lote
Snapshots de tokens📋
Obter informações de fornecimento do token
Verificar/revogar aprovação do token

ERC-721 (NFTs)

RecursoStatus
Obter metadados do NFT
Obter proprietário do NFT
Transferir NFT
Aprovar NFT
Definir aprovação para todos
Obter NFTs por proprietário
Obter informações da coleção NFT
Cunhar NFT📋
Queimar NFT📋
Obter histórico de transferências do NFT📋
Obter características/atributos do NFT
Obter raridade do NFT📋
Verificar autenticidade do NFT📋
Transferir NFTs em lote
Verificar aprovação do NFT
Revogar aprovação do NFT
Aprovar para marketplace
Buscar metadados do NFT a partir da URI

ERC-1155 (Multi-Token)

RecursoStatus
Obter saldo do token (fungível + NFT)
Transferências em lote📋
Consultas de saldo em lote📋
Transferência segura
Obter URI

Outros Padrões de Token

RecursoStatus
ERC-777 (fungível avançado)📋
ERC-3525 (semi-fungível)📋
ERC-4626 (vaults tokenizados)📋
ERC-6551 (contas vinculadas a tokens)📋
ERC-404 (tokens híbridos)📋
Tokens Soulbound (SBTs)📋
🏦 DeFi - DEX, Empréstimos, Staking, Derivativos (clique para expandir)

🏦 DeFi - Exchanges Descentralizadas (DEX)

Trocas

RecursoStatus
Obter cotação/preço
Trocar tokens exatos por tokens
Trocar tokens por tokens exatos
Trocas multi-hop
Trocas com rota dividida📋
Agregação cross-DEX
Ordens limitadas📋
Ordens TWAP (média ponderada no tempo)📋
Ordens stop-loss📋
Obter estimativa de slippage
Obter impacto no preço
Proteção MEV (transações privadas)📋

Análises DEX

RecursoStatus
Obter pools em tendência
Obter novos pools
Obter principais pools por volume
Obter dados OHLCV do pool
Obter negociações do pool
Obter pools do token
Obter lista de DEX
Pesquisar pools cross-chain
Obter preço do token por contrato
Obter transações do pool
Consulta de preço multi-token

Provisão de Liquidez

RecursoStatus
Adicionar liquidez
Remover liquidez
Obter saldo do token LP
Obter reservas do pool
Obter APY/APR do pool📋
Obter estimativa de perda impermanente📋
Liquidez concentrada (Uniswap V3)📋
Definir faixa de preço📋
Coletar taxas📋
Rebalancear posição📋
Adicionar liquidez com token nativo
Calcular oportunidades de arbitragem

Suporte a Tipos de AMM

RecursoStatus
Produto constante (x*y=k)
Stable swap (Curve)📋
Liquidez concentrada📋
Híbrido de livro de ordens📋
AMM virtual (perpetuais)📋

🏦 DeFi - Empréstimos e Tomada de Empréstimos

Empréstimos

RecursoStatus
Fornecer/depositar ativos
Retirar ativos
Obter APY de fornecimento
Obter saldo fornecido
Obter taxa de utilização📋
Habilitar/desabilitar como garantia📋

Tomada de Empréstimos

RecursoStatus
Tomar emprestado ativos
Pagar dívida
Obter APY de empréstimo
Obter saldo emprestado
Obter fator de saúde
Obter limite de liquidação
Obter valor máximo emprestável📋
Empréstimos relâmpago
Obter limite de empréstimo📋
Obter informações de empréstimo relâmpago

Liquidações

RecursoStatus
Liquidar posições não saudáveis📋
Obter posições liquidáveis
Obter bônus de liquidação📋
Liquidações parciais📋

Mercados Isolados

RecursoStatus
Fornecer ao pool isolado📋
Tomar emprestado do pool isolado📋
Obter teto de dívida do modo isolamento📋

🥩 DeFi - Staking

Staking Nativo

RecursoStatus
Stakear tokens nativos
Unstakear/retirar
Reivindicar recompensas
Obter APY de staking
Obter lista de validadores📋
Delegar para validador📋
Redelegar📋
Obter período de unbonding📋

Staking Líquido

RecursoStatus
Stakear para tokens de staking líquido (stETH, rETH)
Desembrulhar tokens de staking líquido
Obter taxa de câmbio
Obter taxa de recompensas de staking

Staking de LP/Farming

RecursoStatus
Stakear tokens de LP
Unstakear tokens de LP
Reivindicar recompensas de farming
Obter APY de farming
Recompensas compostas📋
Obter recompensas pendentes
Recompensas impulsionadas (veTokens)📋

Restaking

RecursoStatus
Restakear ativos (EigenLayer)📋
Obter pontos de restaking📋
Escolher operadores📋
Retirar do restaking📋

📊 DeFi - Derivativos

Futuros Perpétuos

RecursoStatus
Abrir posição comprada/vendida📋
Fechar posição📋
Adicionar/remover margem📋
Definir alavancagem📋
Obter taxa de funding📋
Obter juros em aberto📋
Obter preço de liquidação📋
Definir stop-loss/take-profit📋
Obter PnL📋
Fechamento parcial📋

Opções

RecursoStatus
Comprar opções de compra/venda📋
Vender/emitir opções📋
Exercer opções📋
Obter gregos de opções📋
Obter volatilidade implícita📋
Obter cadeia de opções📋
Estratégias de spread📋

Sintéticos

RecursoStatus
Cunhar ativos sintéticos📋
Queimar ativos sintéticos📋
Obter índice de colateral📋
Obter feed de preço sintético📋
Liquidar posições sintéticas📋
🌉 Cross-Chain, Governança, Segurança, NFTs (clique para expandir)

🌉 Cross-Chain & Pontes

Ponte (Bridging)

RecursoStatus
Ponte de tokens entre chains
Obter cotação de ponte
Obter status da ponte
Obter chains suportadas
Obter tokens suportados
Reivindicar tokens transferidos📋
Obter taxas de ponte
Obter tempo estimado

Mensageria Cross-Chain

RecursoStatus
Enviar mensagem cross-chain📋
Receber mensagem cross-chain📋
Operações LayerZero📋
Operações Axelar📋
Operações Wormhole📋
CCIP (Chainlink)📋
Operações Hyperlane📋

Swaps Atômicos

RecursoStatus
Iniciar swap atômico📋
Completar swap atômico📋
Reembolsar swap atômico📋

🗳️ Governança

Votação

RecursoStatus
Criar proposta
Votar em proposta
Delegar votos
Obter poder de voto
Obter estado da proposta
Enfileirar proposta
Executar proposta
Cancelar proposta
Obter recibo de voto

Bloqueio de Tokens

RecursoStatus
Bloquear tokens para votação (veTokens)📋
Estender período de bloqueio📋
Aumentar valor bloqueado📋
Retirar tokens desbloqueados📋
Obter informações de bloqueio📋

Snapshot (Off-chain)

RecursoStatus
Criar espaço📋
Criar proposta off-chain📋
Votar off-chain📋
Obter resultados de snapshot📋

🔐 Segurança & Análise

Análise de Contratos

RecursoStatus
Verificar código-fonte do contrato
Obter ABI do contrato
Verificar se o contrato é proxy
Obter endereço da implementação
Detectar honeypots
Verificar riscos de rug pull
Verificação de segurança de token GoPlus
Detecção de rug pull GoPlus
Pontuação de auditoria📋
Obter criador do contrato
Obter idade do contrato
Detectar funções maliciosas

Segurança de Tokens

RecursoStatus
Verificar segurança do token
Obter distribuição de detentores
Verificar se é cunhável
Verificar se é pausável
Verificar taxas ocultas
Verificar liquidez bloqueada
Obter principais detentores
Verificar renúncia de propriedade
Segurança de NFT GoPlus
Segurança de aprovações GoPlus

Segurança de Carteiras

RecursoStatus
Obter lista de aprovações
Revogar aprovações
Verificar drainers
Simular segurança de transação
Obter pontuação de risco da carteira📋
Segurança de endereço GoPlus
Verificação de phishing de dApp GoPlus
Decodificação de assinatura GoPlus

📈 Dados de Preço & Mercado

Feeds de Preço

RecursoStatus
Obter preço atual
Obter preços históricos
Obter dados OHLCV
Obter preço de DEX
Obter preço de oracle (Chainlink, Pyth)
Obter preço TWAP
Obter preço em várias exchanges
Obter volume
Obter capitalização de mercado
Obter moedas em alta
Obter token por endereço de contrato
Obter taxas de câmbio
Obter categorias de moedas
Obter dados de derivativos
Obter participações de BTC/ETH de empresas

Análises

RecursoStatus
Obter TVL (Total Value Locked)
Obter métricas de protocolo
Obter APYs de yield farming
Obter rastreador de gas
Obter transações de baleias📋
Obter análise de fluxo de tokens📋
Obter volume de DEX
Obter métricas de empréstimos📋
Obter taxas e receita de DeFi
Obter dados de stablecoins
Obter volumes de pontes
Obter dados de liquidação
Obter histórico de hacks de DeFi
Obter dados de perpétuos

🆔 Identidade & Domínios

ENS (Ethereum Name Service)

RecursoStatus
Registrar domínio
Resolver nome para endereço
Resolver reverso de endereço para nome
Definir nome principal📋
Definir registros (texto, endereço, hash de conteúdo)
Transferir domínio
Renovar domínio
Obter data de expiração📋
Definir subdomínios

Outros Serviços de Nomes

RecursoStatus
Unstoppable Domains📋
Space ID (.bnb)📋
Bonfida (.sol)📋
ANS (.avax)📋

DIDs & Credenciais Verificáveis

RecursoStatus
Criar DID📋
Resolver DID📋
Emitir credencial verificável📋
Verificar credencial📋
Revogar credencial📋

🖼️ NFT & Metaverso

Marketplace de NFT

RecursoStatus
Listar NFT para venda📋
Comprar NFT📋
Fazer oferta📋
Aceitar oferta📋
Cancelar listagem📋
Leiloar NFT📋
Dar lance em leilão📋
Obter preço mínimo📋
Obter estatísticas da coleção📋

Criação de NFT

RecursoStatus
Implantar coleção de NFT📋
Cunhar NFTs📋
Definir royalties📋
Definir metadados📋
Revelar NFTs📋
Gerenciamento de whitelist📋
Airdrop de NFTs📋

Finanças de NFT

RecursoStatus
Empréstimos com colateral de NFT📋
Fracionamento de NFT📋
Aluguel de NFT📋
Staking de NFT📋

Metaverso

RecursoStatus
Comprar terra virtual📋
Vender terra virtual📋
Construir em terra📋
Transferir ativos entre metaversos📋

🔔 Eventos & Assinaturas

Escuta de Eventos

RecursoStatus
Assinar eventos de contrato📋
Assinar transações pendentes📋
Assinar novos blocos📋
Assinar logs📋
Filtrar eventos por tópico
Obter eventos históricos
Decodificar logs de eventos

Webhooks & Notificações

RecursoStatus
Configurar webhook para eventos📋
Obter notificações de transações📋
Obter alertas de preço📋
Obter alertas de baleias📋
Obter notificações de governança📋

📜 Interação com Contratos Inteligentes

Operações de Leitura

RecursoStatus
Chamar funções view/pure
Obter armazenamento em slot
Obter bytecode do contrato
Multicall (leituras em lote)
Simulação de chamada estática

Operações de Escrita

RecursoStatus
Enviar transação para contrato
Codificar chamada de função
Decodificar resultado de função
Estimar gas para chamada
Transações em lote

Implantação de Contratos

RecursoStatus
Implantar contrato
Implantar com CREATE2
Implantar contrato proxy
Atualizar proxy
Verificar no explorador

🤖 Recursos Avançados

MEV & Flashbots

RecursoStatus
Enviar transação privada
Enviar bundle
Obter oportunidades de MEV
Proteção contra backrun
Proteção contra frontrun
Proteção contra sandwich

Account Abstraction (ERC-4337)

RecursoStatus
Criar conta inteligente📋
Executar user operation📋
Operações em lote📋
Patrocinar gas (Paymaster)📋
Chaves de sessão📋
Recuperação social📋

Intents & Solvers

RecursoStatus
Enviar intent📋
Obter cotações de solvers📋
Executar via solver📋

Oracles

RecursoStatus
Obter preço Chainlink
Obter preço Pyth📋
Obter preço Band Protocol📋
Obter preço API3📋
Solicitar aleatoriedade (VRF)📋
Solicitar dados externos📋

🛠️ Funções Utilitárias

Gas

RecursoStatus
Obter preço do gas
Obter taxa de prioridade
Obter taxa base
Obter histórico de gas
Estimar gas para transação
Obter taxas EIP-1559

Codificação/Decodificação

RecursoStatus
Codificação ABI
Decodificação ABI
Hash Keccak256
Empacotar/desempacotar dados
Assinar dados tipados (EIP-712)

Utilitários de Endereço

RecursoStatus
Validar endereço
Endereço com checksum
Obter endereço de ENS
Verificar se é contrato
Obter tipo de contrato📋

📰 Dados & Informações

Notícias & Redes Sociais

RecursoStatus
Obter notícias de cripto
Pesquisar notícias de cripto
Obter notícias de DeFi
Obter notícias de Bitcoin
Obter notícias de última hora
Obter sentimento social
Obter rankings de influenciadores
Obter tópicos em alta
Obter métricas sociais de moedas
Obter feed social
Obter índice de sentimento de mercado
Obter Galaxy Score
Obter AltRank
Obter menções no Twitter📋
Obter atividade no Discord📋
Obter atividade no GitHub📋

Dados On-Chain

RecursoStatus
Obter detentores de tokens📋
Obter carteiras de baleias📋
Obter movimentos de smart money📋
Obter usuários de protocolo📋
Obter endereços ativos diários📋
Obter hash rate da rede📋
🏛️ Institucional & Compliance (clique para expandir)

🏛️ Institucional & Compliance

KYC/AML

RecursoStatus
Triagem de carteiras📋
Monitoramento de transações📋
Pontuação de risco📋
Verificação de sanções📋

Custódia

RecursoStatus
Operações multi-assinatura📋
Armazenamento a frio📋
Gerenciamento de carteira quente📋
Aplicação de políticas📋

Relatórios

RecursoStatus
Relatórios fiscais📋
Acompanhamento de portfólio
Relatórios de P&L📋
Exportação de histórico de transações📋

Fontes de Dados

Este servidor MCP integra-se com as seguintes APIs:

ProvedorTipo de DadosChave de API Necessária
CoinGeckoDados de mercado, preços, OHLCVOpcional (plano gratuito)
CoinStatsPortfólio, preços, carteirasSim
DefiLlamaTVL, rendimentos, taxas, protocolosNão
LunarCrushSentimento social, influenciadoresSim
GoPlusAnálise de segurança, detecção de honeypotNão
GeckoTerminalPools DEX, negociações, OHLCVNão
DexPaprikaAnálises DEX, poolsNão
CryptoPanicNotícias de criptomoedasSim
Alternative.meÍndice de Medo e GanânciaNão

Servidores MCP Relacionados

Servidores MCP especializados adicionais, mantidos em seus próprios repositórios:

ServidorDescriçãoFerramentas
Binance-MCPAPI da exchange global Binance.com156+ ferramentas
Binance-US-MCPAPI da exchange Binance.US71+ ferramentas

Servidor Binance.com

Cobertura completa da API global da Binance, incluindo:

  • Negociação à vista, carteira, staking, mineração
  • Convert, Simple Earn, Algo Trading (TWAP/VP)
  • NFT, Pay, Copy Trading, Dual Investment
  • VIP Loans, C2C/P2P, Fiat
{
  "mcpServers": {
    "binance": {
      "command": "npx",
      "args": ["ts-node", "binance-mcp-server/src/index.ts"],
      "env": {
        "BINANCE_API_KEY": "your_key",
        "BINANCE_API_SECRET": "your_secret"
      }
    }
  }
}

Servidor Binance.US

Exchange regulamentada nos EUA com:

  • Dados de mercado, negociação à vista, carteira
  • Staking, OTC, sub-contas
  • Soluções de custódia (institucional)
{
  "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"
      }
    }
  }
}

Créditos

Construído por nich (github.com/nirholas)

Follow on X


🏢 Quem Está Usando Isso?

O Universal Crypto MCP é usado por desenvolvedores e equipes que criam:

  • 🤖 Bots de Negociação com IA - Gerenciamento automatizado de portfólio
  • 📊 Dashboards de Análise - Ferramentas de monitoramento DeFi
  • 🔒 Auditores de Segurança - Fluxos de verificação de tokens
  • 🏦 Aplicações DeFi - Operações cross-chain
  • 📱 Aplicativos Móveis - Rastreadores de portfólio de criptomoedas
  • 🎓 Ferramentas Educacionais - Plataformas de aprendizado sobre blockchain

Usando o Universal Crypto MCP? Nos avise! Adoraríamos destacar seu projeto.


🤝 Contribuindo

Aceitamos contribuições de todos os tipos! Por favor, leia nosso Guia de Contribuição para detalhes.

Início Rápido para Contribuidores

# 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

Estilo de Código

Usamos Prettier para formatação e ESLint para linting:

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

Formas de Contribuir


📜 Licença

Apache-2.0 © nich


Pare de copiar e colar consultas de blockchain. Deixe a IA fazer isso.
Feito com 💜 para a comunidade cripto

Star on GitHub


🌐 Implantação HTTP ao Vivo

O Universal Crypto MCP está implantado e acessível via HTTP através do transporte MCP Streamable HTTP — sem necessidade de instalação local.

Endpoint:

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

Conecte-se a partir de qualquer Cliente MCP

Adicione à configuração do seu cliente MCP (Claude Desktop, Cursor, SperaxOS, etc.):

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

Ferramentas Disponíveis (11)

FerramentaDescrição
get_priceObter preços de criptomoedas
get_market_overviewVisão geral do mercado
get_trendingMoedas em alta
search_coinsPesquisar moedas
get_coin_detailDetalhes da moeda
get_global_statsEstatísticas globais
get_defi_protocolsProtocolos DeFi
get_protocol_detailDetalhes do protocolo
get_chain_tvlTVL por cadeia
get_gas_pricesPreços de gás Ethereum
get_token_infoToken por contrato

Exemplos de Solicitações

Obter preços de criptomoedas:

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

Visão geral do mercado:

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

Moedas em alta:

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

Listar Todas as Ferramentas

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

Também Disponível Em

Desenvolvido por modelcontextprotocol.name — o gateway HTTP MCP aberto