Alchemy

Dados de blockchain em mais de 100 redes: preços de tokens, NFTs, transferências, simulação, traces, Solana DAS

Documentação

Servidor MCP da Alchemy

Dê ao seu agente de codificação de IA acesso direto a mais de 100 blockchains com 168 ferramentas por meio do Model Context Protocol.

Para o índice completo da documentação, consulte llms.txt.

O Servidor MCP da Alchemy conecta suas ferramentas de IA aos dados de blockchain por meio do Model Context Protocol (MCP). Ele expõe 168 ferramentas em resolução ENS, preços de tokens, metadados de NFTs, histórico de transações, simulação de contratos inteligentes, rastreamento, abstração de contas, carteiras inteligentes, Solana DAS e muito mais — cobrindo mais de 100 redes, incluindo Ethereum, Base, Polygon, Arbitrum, Optimism, Solana e Starknet.

Conecte seu cliente

O servidor roda em https://mcp.alchemy.com/mcp e autentica via OAuth — basta entrar com sua conta Alchemy quando solicitado. Não é necessária chave de API ou instalação local.

{` .mcp-client-tabs [role="tablist"] { display: flex; width: 100%; } .mcp-client-tabs [role="tablist"] > [role="tab"] { flex: 1 1 0; display: flex; align-items: center; justify-content: center; text-align: center; } `}
  1. Adicione o servidor:
claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp
  1. Reinicie o Claude Code (ou inicie uma nova conversa).

  2. Selecione alchemy e autentique:

/mcp

Você deve ver alchemy na lista de servidores MCP ativos. Na primeira vez que usar uma ferramenta, uma janela do navegador será aberta para entrar com sua conta Alchemy.

  1. Adicione o servidor:
codex mcp add alchemy --url https://mcp.alchemy.com/mcp
  1. Verifique se foi adicionado:
codex mcp list

Adicione o seguinte JSON ao seu arquivo de configuração MCP:

  • Cursor: ~/.cursor/mcp.json (global) ou .cursor/mcp.json (nível de projeto)
{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

Reinicie seu editor após salvar. Para o Cursor, você também pode verificar por meio de Cursor Settings > MCP.

Adicione em ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

Reinicie o Claude Desktop após salvar.

Adicione em .vscode/mcp.json no seu projeto:

{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

Para qualquer outro cliente compatível com MCP, aponte-o para https://mcp.alchemy.com/mcp usando transporte Streamable HTTP. O servidor suporta OAuth 2.1 com PKCE — seu cliente lidará com o fluxo de autorização automaticamente.

Primeiros passos

Após conectar, entre com sua conta Alchemy quando solicitado. Em seguida, o fluxo de trabalho típico é:

  1. Diga ao seu agente qual app usar — ex.: "Selecione um app da Alchemy"
  2. Pergunte ao seu agente — ex.: "Qual é o preço atual do ETH?" ou "Mostre-me os NFTs pertencentes a vitalik.eth"

Ferramentas disponíveis

O servidor expõe 168 ferramentas em três categorias:

Admin — Gerenciamento de Conta e Apps (8 ferramentas)

Gerencie sua conta e seus apps na Alchemy. Essas ferramentas não interagem com a blockchain.

FerramentaDescrição
pingVerificação de integridade
list_appsListe seus apps da Alchemy
get_appObtenha detalhes do app
select_appSelecione um app e armazene em cache sua chave de API para ferramentas RPC/Dados
create_appCrie um novo app
update_appAtualize o nome ou a descrição do app
list_chainsListe todas as 100+ redes suportadas
update_allowlistAtualize as listas de permissões do app (rede, endereço, origem, IP)

RPC — JSON-RPC Onchain (132 ferramentas)

Faça chamadas JSON-RPC para nós de blockchain. Todas exigem select_app primeiro.

FerramentaDescrição
ethBlockNumberObtenha o número do bloco mais recente
ethChainIdObtenha o ID da cadeia
ethGasPriceObtenha o preço atual do gás
ethMaxPriorityFeePerGasObtenha a taxa máxima de prioridade por gás
ethBlobBaseFeeObtenha a taxa base de blob EIP-4844
ethSyncingObtenha o status de sincronização do nó
ethGetBalanceObtenha o saldo de ETH de um endereço
ethGetCodeObtenha o bytecode do contrato
ethGetStorageAtObtenha o valor de armazenamento em uma posição
ethGetProofObtenha a prova de Merkle para armazenamento de conta
ethGetBlockByNumberObtenha um bloco por número
ethGetBlockByHashObtenha um bloco por hash
ethGetBlockReceiptsObtenha todos os recibos de um bloco
ethGetBlockTransactionCountByHashObtenha a contagem de transações em um bloco por hash
ethGetBlockTransactionCountByNumberObtenha a contagem de transações em um bloco por número
ethGetTransactionByHashObtenha uma transação por hash
ethGetTransactionByBlockHashAndIndexObtenha uma transação por hash de bloco e índice
ethGetTransactionByBlockNumberAndIndexObtenha uma transação por número de bloco e índice
ethGetTransactionReceiptObtenha um recibo de transação
ethGetTransactionCountObtenha o nonce de um endereço
ethGetLogsObtenha logs que correspondem a um filtro
ethCallExecute uma chamada de contrato inteligente somente leitura
ethEstimateGasEstime o gás para uma transação
ethCreateAccessListGere lista de acesso EIP-2930
ethFeeHistoryObtenha dados históricos de taxas
ethCallBundleSimule um pacote de transações em um bloco
ethCallManySimule múltiplos pacotes de transações entre blocos
netListeningVerifique se o nó está ouvindo conexões
netVersionObtenha o ID da rede
web3ClientVersionObtenha a versão do cliente
web3Sha3Calcule um hash Keccak-256
resolveEnsNameResolva um nome ENS onchain da mainnet para um endereço Ethereum
FerramentaDescrição
getTokenBalancesObtenha saldos de tokens ERC-20 para um endereço
getTokenMetadataObtenha nome, símbolo, decimais e logotipo do token
getTokenAllowanceObtenha a permissão ERC-20 para um gastador
FerramentaDescrição
getAssetTransfersObtenha transferências históricas de ativos (ERC-20, ERC-721, nativas, internas)
getTransactionReceiptsObtenha todos os recibos de transação de um bloco
FerramentaDescrição
simulateAssetChangesSimule as mudanças de ativos de uma transação
simulateExecutionSimule o rastreamento de execução de uma transação
simulateAssetChangesBundleSimule as mudanças de ativos de um pacote de transações
simulateExecutionBundleSimule os rastreamentos de execução de um pacote de transações
simulateUserOperationAssetChangesSimule as mudanças de ativos de uma UserOperation
FerramentaDescrição
traceCallRastreie uma chamada sem criar uma transação
traceTransactionRastreie uma transação minerada
traceBlockRastreie todas as transações em um bloco
traceFilterFiltre rastreamentos por endereço e intervalo de blocos
traceReplayTransactionReproduza uma transação com rastreamentos
traceReplayBlockTransactionsReproduza todas as transações em um bloco
FerramentaDescrição
debugTraceTransactionRastreie uma transação em modo de depuração
debugTraceCallRastreie uma chamada em modo de depuração
debugTraceBlockByNumberRastreie um bloco por número em modo de depuração
debugTraceBlockByHashRastreie um bloco por hash em modo de depuração
debugGetRawBlockObtenha dados brutos de bloco codificados em RLP
debugGetRawReceiptsObtenha recibos brutos de transação para um bloco
FerramentaDescrição
estimateUserOperationGasEstime o gás para uma UserOperation
getUserOperationReceiptObtenha um recibo de UserOperation
getUserOperationByHashObtenha uma UserOperation por hash
supportedEntryPointsListe os endereços EntryPoint suportados
rundlerMaxPriorityFeePerGasObtenha a taxa máxima de prioridade por gás do bundler
requestGasAndPaymasterAndDataSolicite patrocínio de gás + dados de paymaster
requestPaymasterAndDataSolicite apenas dados de paymaster
FerramentaDescrição
walletPrepareCallsPrepare chamadas para envio de carteira inteligente
walletSendPreparedCallsEnvie chamadas preparadas e assinadas de carteira inteligente
walletGetCallsStatusObtenha o status das chamadas enviadas de carteira inteligente
walletGetCapabilitiesObtenha capacidades de carteira inteligente para cadeias especificadas
walletListAccountsListe contas inteligentes associadas a um endereço de signatário
walletCreateSessionCrie uma sessão de carteira inteligente com permissões definidas
walletGetCrossChainStatusObtenha o status de transação na mesma cadeia ou entre cadeias
walletRequestQuoteSolicite uma cotação de swap para uma troca de tokens
FerramentaDescrição
solana_getBalanceObtenha saldo de SOL em lamports
solana_getAccountInfoObtenha dados da conta (proprietário, lamports, dados)
solana_getMultipleAccountsObtenha dados de múltiplas contas
solana_getTransactionObtenha uma transação confirmada por assinatura
solana_getSignaturesForAddressObtenha assinaturas de transação para um endereço
solana_getSignatureStatusesObtenha status de assinaturas de transação
solana_simulateTransactionSimule uma transação sem enviar
solana_getTokenAccountBalanceObtenha saldo de conta de token SPL
solana_getTokenAccountsByOwnerObtenha todas as contas de token de uma carteira
solana_getTokenAccountsByDelegateObtenha contas de token delegadas
solana_getTokenSupplyObtenha o fornecimento total de um token SPL
solana_getTokenLargestAccountsObtenha os 20 principais detentores de um token
solana_getBlockObtenha um bloco confirmado por slot
solana_getBlockHeightObtenha a altura atual do bloco
solana_getBlockTimeObtenha o timestamp Unix de um slot
solana_getBlocksObtenha blocos confirmados em um intervalo
solana_getBlocksWithLimitObtenha blocos confirmados a partir de um slot com limite
solana_getBlockCommitmentObtenha o compromisso de voto de um bloco
solana_getBlockProductionObtenha estatísticas de produção de blocos
solana_getSlotObtenha o slot atual
solana_getSlotLeaderObtenha o líder do slot atual
solana_getSlotLeadersObtenha líderes de slot para um intervalo
solana_getLatestBlockhashObtenha o blockhash mais recente
solana_isBlockhashValidVerifique a validade do blockhash
solana_getProgramAccountsObtenha todas as contas pertencentes a um programa
solana_getEpochInfoObtenha informações da época atual
solana_getEpochScheduleObtenha o cronograma de épocas
solana_getSupplyObtenha o detalhamento do fornecimento de SOL
solana_getVersionObtenha a versão do software do nó
solana_getTransactionCountObtenha a contagem total de transações
solana_getInflationRateObtenha a taxa de inflação atual
solana_getInflationGovernorObtenha parâmetros do governador de inflação
solana_getInflationRewardObtenha recompensas de staking por época
solana_getVoteAccountsObtenha contas de voto de validadores
solana_getLargestAccountsObtenha as 20 principais contas por saldo
solana_getClusterNodesObtenha informações de nós do cluster
solana_getLeaderScheduleObtenha o cronograma de líderes de uma época
solana_getFeeForMessageObtenha a taxa de uma mensagem
solana_getRecentPrioritizationFeesObtenha dados recentes de taxa de prioridade
solana_getMinimumBalanceForRentExemptionObtenha o mínimo isento de aluguel
solana_getFirstAvailableBlockObtenha o bloco mais baixo disponível
solana_getGenesisHashObtenha o hash de gênese
solana_getHighestSnapshotSlotObtenha o slot de snapshot mais alto
solana_getIdentityObtenha a chave pública de identidade do nó
solana_getMaxRetransmitSlotObtenha o slot máximo de retransmissão
solana_getMaxShredInsertSlotObtenha o slot máximo de inserção de shred
solana_getRecentPerformanceSamplesObtenha amostras recentes de TPS
solana_getStakeActivationObtenha o estado de ativação de stake
solana_minimumLedgerSlotObtenha o slot mais baixo do ledger
solana_requestAirdropAirdrop de SOL (somente devnet)
| Ferramenta | Descrição | |------|-------------| | `solana_getPriorityFeeEstimate` | Obter estimativas de taxa de prioridade por nível | | `solana_simulateBundle` | Simular um pacote de transações | | `solana_getAsset` | Obter detalhes de um ativo Solana | | `solana_getAssets` | Obter múltiplos ativos Solana | | `solana_getAssetProof` | Obter prova de Merkle para um ativo comprimido | | `solana_getAssetsByOwner` | Obter ativos pertencentes a uma carteira | | `solana_getAssetsByAuthority` | Obter ativos por endereço de autoridade | | `solana_getAssetsByGroup` | Obter ativos por grupo (ex.: coleção) | | `solana_getAssetsByCreator` | Obter ativos por endereço do criador | | `solana_searchAssets` | Pesquisar ativos por critérios | | `solana_getAssetSignatures` | Obter assinaturas de transação para um ativo | | `solana_getNftEditions` | Obter edições de NFT para uma edição mestre | | `solana_getTokenAccounts` | Obter contas de token para uma carteira |

Dados — APIs REST (28 ferramentas)

Chame as APIs REST da Alchemy para obter dados de blockchain enriquecidos. Todas exigem select_app primeiro.

FerramentaDescrição
getNFTsForOwnerObter todos os NFTs pertencentes a um endereço
getNFTsForContractObter todos os NFTs em um contrato
getNFTsForCollectionObter todos os NFTs em uma coleção
getNFTMetadataObter metadados de NFT por ID de token
getNFTMetadataBatchObter metadados para até 100 NFTs
getContractMetadataObter metadados do contrato de NFT
getContractMetadataBatchObter metadados para múltiplos contratos
getOwnersForNFTObter proprietários de um NFT específico
getOwnersForContractObter todos os proprietários em um contrato
getFloorPriceObter preço mínimo de marketplaces
getContractsForOwnerObter contratos de NFT mantidos por um endereço
isSpamContractVerificar se um contrato é spam
FerramentaDescrição
getTokenPricesBySymbolObter preços de tokens por símbolo (ETH, BTC, etc.)
getTokenPricesByAddressObter preços de tokens por endereço de contrato
getHistoricalTokenPricesObter dados históricos de preços em um intervalo de tempo
FerramentaDescrição
getTokensByAddressObter tokens em múltiplas cadeias
getTokenBalancesByAddressObter saldos de tokens com valores em USD em múltiplas cadeias
getNFTsByAddressObter NFTs em múltiplas cadeias
getNFTContractsByAddressObter contratos de NFT em múltiplas cadeias

Cadeias suportadas

Suportamos mais de 100 blockchains, incluindo Ethereum, Base, Polygon, Arbitrum, Optimism, Solana, Starknet, zkSync, Scroll, Linea, Mantle, Blast e muitos outros. Use list_chains para ver a lista completa.

Ferramentas relacionadas

  • Agent Skills ensinam ao seu agente de codificação todas as APIs da Alchemy no nível do código-fonte
  • O Alchemy CLI encapsula as mesmas APIs como uma interface de ferramentas amigável ao shell para consultas ao vivo, trabalho administrativo e automação local
  • Autenticação por carteira para APIs da Alchemy permite que agentes se autentiquem com uma carteira em vez de uma chave de API