Alchemy

Datos de blockchain en más de 100 cadenas: precios de tokens, NFTs, transferencias, simulación, trazas, Solana DAS

Documentación

Servidor MCP de Alchemy

Dale a tu agente de codificación con IA acceso directo a más de 100 blockchains con 168 herramientas a través del Protocolo de Contexto de Modelo.

Para el índice completo de documentación, consulta llms.txt.

El Servidor MCP de Alchemy conecta tus herramientas de IA a datos de blockchain a través del Protocolo de Contexto de Modelo (MCP). Expone 168 herramientas que abarcan resolución de ENS, precios de tokens, metadatos de NFT, historial de transacciones, simulación de contratos inteligentes, trazado, abstracción de cuentas, billeteras inteligentes, Solana DAS y más — cubriendo más de 100 redes incluyendo Ethereum, Base, Polygon, Arbitrum, Optimism, Solana y Starknet.

Conecta tu cliente

El servidor se ejecuta en https://mcp.alchemy.com/mcp y se autentica mediante OAuth — solo inicia sesión con tu cuenta de Alchemy cuando se te solicite. No se requiere clave API ni instalación 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. Agrega el servidor:
claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp
  1. Reinicia Claude Code (o inicia una nueva conversación).

  2. Selecciona alchemy y autentícate:

/mcp

Deberías ver alchemy en la lista de servidores MCP activos. La primera vez que uses una herramienta, se abrirá una ventana del navegador para iniciar sesión con tu cuenta de Alchemy.

  1. Agrega el servidor:
codex mcp add alchemy --url https://mcp.alchemy.com/mcp
  1. Verifica que se haya agregado:
codex mcp list

Agrega el siguiente JSON a tu archivo de configuración de MCP:

  • Cursor: ~/.cursor/mcp.json (global) o .cursor/mcp.json (a nivel de proyecto)
{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

Reinicia tu editor después de guardar. Para Cursor, también puedes verificar mediante Configuración de Cursor > MCP.

Agrega a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Reinicia Claude Desktop después de guardar.

Agrega a .vscode/mcp.json en tu proyecto:

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

Para cualquier otro cliente compatible con MCP, apúntalo a https://mcp.alchemy.com/mcp usando transporte HTTP Streamable. El servidor admite OAuth 2.1 con PKCE — tu cliente manejará el flujo de autorización automáticamente.

Primeros pasos

Una vez conectado, inicia sesión con tu cuenta de Alchemy cuando se te solicite. Luego, el flujo de trabajo típico es:

  1. Dile a tu agente qué aplicación usar — p. ej. "Selecciona una aplicación de Alchemy"
  2. Pregunta a tu agente — p. ej. "¿Cuál es el precio actual de ETH?" o "Muéstrame los NFTs que posee vitalik.eth"

Herramientas disponibles

El servidor expone 168 herramientas en tres categorías:

Administración — Gestión de Cuenta y Aplicaciones (8 herramientas)

Gestiona tu cuenta y aplicaciones de Alchemy. Estas herramientas no interactúan con la blockchain.

HerramientaDescripción
pingVerificación de estado
list_appsLista tus aplicaciones de Alchemy
get_appObtén detalles de la aplicación
select_appSelecciona una aplicación y almacena en caché su clave API para herramientas RPC/Datos
create_appCrea una nueva aplicación
update_appActualiza el nombre o la descripción de la aplicación
list_chainsLista las más de 100 redes compatibles
update_allowlistActualiza las listas permitidas de la aplicación (red, dirección, origen, IP)

RPC — JSON-RPC en cadena (132 herramientas)

Realiza llamadas JSON-RPC a nodos de blockchain. Todas requieren select_app primero.

HerramientaDescripción
ethBlockNumberObtén el número de bloque más reciente
ethChainIdObtén el ID de la cadena
ethGasPriceObtén el precio actual del gas
ethMaxPriorityFeePerGasObtén la tarifa máxima de prioridad por gas
ethBlobBaseFeeObtén la tarifa base de blob EIP-4844
ethSyncingObtén el estado de sincronización del nodo
ethGetBalanceObtén el saldo de ETH para una dirección
ethGetCodeObtén el bytecode del contrato
ethGetStorageAtObtén el valor de almacenamiento en una posición
ethGetProofObtén la prueba de Merkle para el almacenamiento de una cuenta
ethGetBlockByNumberObtén un bloque por número
ethGetBlockByHashObtén un bloque por hash
ethGetBlockReceiptsObtén todos los recibos de un bloque
ethGetBlockTransactionCountByHashObtén el conteo de transacciones en un bloque por hash
ethGetBlockTransactionCountByNumberObtén el conteo de transacciones en un bloque por número
ethGetTransactionByHashObtén una transacción por hash
ethGetTransactionByBlockHashAndIndexObtén una transacción por hash de bloque e índice
ethGetTransactionByBlockNumberAndIndexObtén una transacción por número de bloque e índice
ethGetTransactionReceiptObtén un recibo de transacción
ethGetTransactionCountObtén el nonce para una dirección
ethGetLogsObtén registros que coincidan con un filtro
ethCallEjecuta una llamada de contrato inteligente de solo lectura
ethEstimateGasEstima el gas para una transacción
ethCreateAccessListGenera la lista de acceso EIP-2930
ethFeeHistoryObtén datos históricos de tarifas
ethCallBundleSimula un lote de transacciones en un bloque
ethCallManySimula múltiples lotes de transacciones entre bloques
netListeningVerifica si el nodo está escuchando conexiones
netVersionObtén el ID de la red
web3ClientVersionObtén la versión del cliente
web3Sha3Calcula un hash Keccak-256
resolveEnsNameResuelve un nombre ENS de mainnet en cadena a una dirección de Ethereum
HerramientaDescripción
getTokenBalancesObtén saldos de tokens ERC-20 para una dirección
getTokenMetadataObtén nombre, símbolo, decimales y logo del token
getTokenAllowanceObtén la asignación ERC-20 para un gastador
HerramientaDescripción
getAssetTransfersObtén transferencias de activos históricas (ERC-20, ERC-721, nativas, internas)
getTransactionReceiptsObtén todos los recibos de transacción de un bloque
HerramientaDescripción
simulateAssetChangesSimula los cambios de activos de una transacción
simulateExecutionSimula el rastro de ejecución de una transacción
simulateAssetChangesBundleSimula los cambios de activos de un lote de transacciones
simulateExecutionBundleSimula los rastros de ejecución de un lote de transacciones
simulateUserOperationAssetChangesSimula los cambios de activos de una UserOperation
HerramientaDescripción
traceCallTraza una llamada sin crear una transacción
traceTransactionTraza una transacción minada
traceBlockTraza todas las transacciones en un bloque
traceFilterFiltra rastros por dirección y rango de bloques
traceReplayTransactionReproduce una transacción con rastros
traceReplayBlockTransactionsReproduce todas las transacciones en un bloque
HerramientaDescripción
debugTraceTransactionTraza una transacción para depuración
debugTraceCallTraza una llamada para depuración
debugTraceBlockByNumberTraza un bloque por número para depuración
debugTraceBlockByHashTraza un bloque por hash para depuración
debugGetRawBlockObtén datos de bloque crudos codificados en RLP
debugGetRawReceiptsObtén recibos de transacción crudos para un bloque
HerramientaDescripción
estimateUserOperationGasEstima el gas para una UserOperation
getUserOperationReceiptObtén un recibo de UserOperation
getUserOperationByHashObtén una UserOperation por hash
supportedEntryPointsLista las direcciones EntryPoint compatibles
rundlerMaxPriorityFeePerGasObtén la tarifa máxima de prioridad por gas del bundler
requestGasAndPaymasterAndDataSolicita patrocinio de gas + datos de paymaster
requestPaymasterAndDataSolicita solo datos de paymaster
HerramientaDescripción
walletPrepareCallsPrepara llamadas para el envío de billeteras inteligentes
walletSendPreparedCallsEnvía llamadas de billetera inteligente preparadas y firmadas
walletGetCallsStatusObtén el estado de las llamadas de billetera inteligente enviadas
walletGetCapabilitiesObtén las capacidades de billetera inteligente para cadenas especificadas
walletListAccountsLista cuentas inteligentes asociadas con una dirección de firmante
walletCreateSessionCrea una sesión de billetera inteligente con permisos limitados
walletGetCrossChainStatusObtén el estado de transacciones en la misma cadena o entre cadenas
walletRequestQuoteSolicita una cotización de intercambio para un intercambio de tokens
HerramientaDescripción
solana_getBalanceObtén el saldo de SOL en lamports
solana_getAccountInfoObtén datos de cuenta (propietario, lamports, datos)
solana_getMultipleAccountsObtén datos de múltiples cuentas
solana_getTransactionObtén una transacción confirmada por firma
solana_getSignaturesForAddressObtén firmas de transacciones para una dirección
solana_getSignatureStatusesObtén estados de firmas de transacciones
solana_simulateTransactionSimula una transacción sin enviarla
solana_getTokenAccountBalanceObtén el saldo de una cuenta de token SPL
solana_getTokenAccountsByOwnerObtén todas las cuentas de token de una billetera
solana_getTokenAccountsByDelegateObtén cuentas de token delegadas
solana_getTokenSupplyObtén el suministro total de un token SPL
solana_getTokenLargestAccountsObtén los 20 principales tenedores de un token
solana_getBlockObtén un bloque confirmado por slot
solana_getBlockHeightObtén la altura actual del bloque
solana_getBlockTimeObtén la marca de tiempo Unix para un slot
solana_getBlocksObtén bloques confirmados en un rango
solana_getBlocksWithLimitObtén bloques confirmados desde un slot con límite
solana_getBlockCommitmentObtén el compromiso de voto para un bloque
solana_getBlockProductionObtén estadísticas de producción de bloques
solana_getSlotObtén el slot actual
solana_getSlotLeaderObtén el líder del slot actual
solana_getSlotLeadersObtén líderes de slot para un rango
solana_getLatestBlockhashObtén el hash de bloque más reciente
solana_isBlockhashValidVerifica la validez del hash de bloque
solana_getProgramAccountsObtén todas las cuentas propiedad de un programa
solana_getEpochInfoObtén información de la época actual
solana_getEpochScheduleObtén el cronograma de épocas
solana_getSupplyObtén el desglose del suministro de SOL
solana_getVersionObtén la versión del software del nodo
solana_getTransactionCountObtén el conteo total de transacciones
solana_getInflationRateObtén la tasa de inflación actual
solana_getInflationGovernorObtén los parámetros del gobernador de inflación
solana_getInflationRewardObtén recompensas de staking por época
solana_getVoteAccountsObtén cuentas de voto de validadores
solana_getLargestAccountsObtén las 20 principales cuentas por saldo
solana_getClusterNodesObtén información de nodos del clúster
solana_getLeaderScheduleObtén el cronograma de líderes para una época
solana_getFeeForMessageObtén la tarifa de un mensaje
solana_getRecentPrioritizationFeesObtén datos recientes de tarifas de prioridad
solana_getMinimumBalanceForRentExemptionObtén el mínimo exento de renta
solana_getFirstAvailableBlockObtén el bloque disponible más bajo
solana_getGenesisHashObtén el hash de génesis
solana_getHighestSnapshotSlotObtén el slot de snapshot más alto
solana_getIdentityObtén la clave pública de identidad del nodo
solana_getMaxRetransmitSlotObtén el slot máximo de retransmisión
solana_getMaxShredInsertSlotObtén el slot máximo de inserción de shred
solana_getRecentPerformanceSamplesObtén muestras recientes de TPS
solana_getStakeActivationObtén el estado de activación de stake
solana_minimumLedgerSlotObtén el slot de ledger más bajo
solana_requestAirdropAirdrop de SOL (solo devnet)
| Herramienta | Descripción | |------|-------------| | `solana_getPriorityFeeEstimate` | Obtén estimaciones de tarifas prioritarias por nivel | | `solana_simulateBundle` | Simula un paquete de transacciones | | `solana_getAsset` | Obtén detalles de un activo de Solana | | `solana_getAssets` | Obtén múltiples activos de Solana | | `solana_getAssetProof` | Obtén la prueba de Merkle para un activo comprimido | | `solana_getAssetsByOwner` | Obtén activos propiedad de una billetera | | `solana_getAssetsByAuthority` | Obtén activos por dirección de autoridad | | `solana_getAssetsByGroup` | Obtén activos por grupo (p. ej., colección) | | `solana_getAssetsByCreator` | Obtén activos por dirección de creador | | `solana_searchAssets` | Busca activos por criterios | | `solana_getAssetSignatures` | Obtén firmas de transacción para un activo | | `solana_getNftEditions` | Obtén ediciones NFT para una edición maestra | | `solana_getTokenAccounts` | Obtén cuentas de token para una billetera |

Datos — APIs REST (28 herramientas)

Llama a las APIs REST de Alchemy para obtener datos de blockchain enriquecidos. Todas requieren select_app primero.

HerramientaDescripción
getNFTsForOwnerObtén todos los NFT propiedad de una dirección
getNFTsForContractObtén todos los NFT en un contrato
getNFTsForCollectionObtén todos los NFT en una colección
getNFTMetadataObtén metadatos de NFT por ID de token
getNFTMetadataBatchObtén metadatos de hasta 100 NFT
getContractMetadataObtén metadatos del contrato NFT
getContractMetadataBatchObtén metadatos de múltiples contratos
getOwnersForNFTObtén propietarios de un NFT específico
getOwnersForContractObtén todos los propietarios en un contrato
getFloorPriceObtén el precio mínimo de los mercados
getContractsForOwnerObtén contratos NFT en poder de una dirección
isSpamContractComprueba si un contrato es spam
HerramientaDescripción
getTokenPricesBySymbolObtén precios de tokens por símbolo (ETH, BTC, etc.)
getTokenPricesByAddressObtén precios de tokens por dirección de contrato
getHistoricalTokenPricesObtén datos históricos de precios en un rango de tiempo
HerramientaDescripción
getTokensByAddressObtén tokens en múltiples cadenas
getTokenBalancesByAddressObtén saldos de tokens con valores en USD en múltiples cadenas
getNFTsByAddressObtén NFT en múltiples cadenas
getNFTContractsByAddressObtén contratos NFT en múltiples cadenas

Cadenas compatibles

Soportamos más de 100 blockchains incluyendo Ethereum, Base, Polygon, Arbitrum, Optimism, Solana, Starknet, zkSync, Scroll, Linea, Mantle, Blast, y muchas más. Usa list_chains para ver la lista completa.

Herramientas relacionadas

  • Agent Skills enseñan a tu agente de codificación cada API de Alchemy a nivel de código fuente
  • El Alchemy CLI envuelve las mismas APIs como una superficie de herramientas amigable con la shell para consultas en vivo, trabajo administrativo y automatización local
  • Autenticación de billetera para APIs de Alchemy permite a los agentes autenticarse con una billetera en lugar de una clave de API