What it does

The server provides a bridge between AI agents and Alchemy's blockchain APIs, exposing 97 tools for querying on-chain data. Agents can fetch token prices and history, retrieve NFT ownership and contract metadata, view transaction histories, check balances across multiple networks, and list asset transfers with filtering. Two deployment modes are available: a hosted remote server at mcp.alchemy.com (no local setup required) or a local STDIO server for private deployments.

Who it's for

Web3 engineers, DApp developers, and AI researchers who need to query live blockchain data within Claude workflows. Useful for building agents that analyze on-chain activity, research token and NFT positions, or automate blockchain queries without writing custom RPC clients.

Common use cases

Query current and historical token prices by symbol or contract address
Fetch token balances and ownership across Ethereum, Base, and other supported networks
Retrieve transaction and asset transfer histories for wallet addresses
Look up NFT holdings and collection metadata for given addresses
Send transactions via Smart Contract Accounts (requires wallet agent configuration)
Execute decentralized exchange swaps programmatically

Setup pitfalls

ALCHEMY_API_KEY environment variable is required; obtain one from alchemy.com
sendTransaction and swap methods require a separate wallet agent server endpoint for signing and broadcasting
Security scanner detected 2 embedded secrets in the codebase — audit before production use
Hosted server at mcp.alchemy.com and the open-source repository are maintained separately and may diverge

Tool name

Description

Destructive?

listSupportedNetworks

✓ no

fetchTokenPriceBySymbol

✓ no

fetchTokenPriceByAddress

✓ no

fetchTokenPriceHistoryBySymbol

✓ no

fetchTokenPriceHistoryByTimeFrame

✓ no

fetchTokensOwnedByMultichainAddresses		✓ no
fetchAddressTransactionHistory		✓ no
fetchTransfers		✓ no
fetchNftsOwnedByMultichainAddresses		✓ no
fetchNftContractDataByMultichainAddress		✓ no
sendTransaction		✓ no
swap		✓ no
getNFTsForOwner		✓ no
getNFTsForContract		✓ no
getNFTsForCollection		✓ no
getNFTMetadata		✓ no
getContractMetadata		✓ no
getCollectionMetadata		✓ no
invalidateNFTContractCache		✓ no
getOwnersForNFT		✓ no
getOwnersForContract		✓ no
getSpamContracts		✓ no
isSpamContract		✓ no
isAirdropNFT⚠		⚠ yes
summarizeNFTAttributes		✓ no
getFloorPrice		✓ no
searchContractMetadata		✓ no
isHolderOfContract		✓ no
computeRarity		✓ no
getNFTSales		✓ no
getContractsForOwner		✓ no
getCollectionsForOwner		✓ no
reportSpam		✓ no
getTokenAllowance		✓ no
getTokenBalances		✓ no
getTokenMetadata		✓ no
getTransactionReceipts		✓ no
debugGetRawBlock		✓ no
debugGetRawHeader		✓ no
debugGetRawReceipts		✓ no
debugTraceBlockByHash		✓ no
debugTraceBlockByNumber		✓ no
debugTraceCall		✓ no
debugTraceTransaction		✓ no
traceBlock		✓ no
traceCall		✓ no
traceGet		✓ no
traceRawTransaction		✓ no
traceReplayBlockTransactions		✓ no
traceReplayTransaction		✓ no

@alchemy/mcp-server

What it does

Who it's for

Common use cases

Setup pitfalls