Alchemy MCP Server
@alchemyplatform
About Alchemy MCP Server
Alchemy's official MCP Server. Allow AI agents to interact with Alchemy's blockchain APIs.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"alchemy": {
"command": "npx",
"args": [
"-y",
"@alchemy/mcp-server"
],
"env": {
"ALCHEMY_API_KEY": "YOUR_API_KEY"
}
}
}
}Tools
97List all blockchain networks supported by Alchemy, including EVM and Solana chains
Get current USD prices for tokens by their ticker symbol (e.g. BTC, ETH)
Get current USD prices for tokens by their contract address and network
Get historical token price data over a date range with configurable interval
Get historical token prices using natural language time frames like "last week" or "past 7 days"
Get all ERC-20 tokens owned by wallet addresses across multiple chains
Get transaction history for wallet addresses across multiple chains, with human-readable dates and ETH values
Get token and ETH transfers filtered by address, block range, or contract
Get NFTs owned by wallet addresses across multiple chains, with spam filtering
Get NFT contract data for wallet addresses across multiple chains
Send a transaction from a smart contract account (SCA) via the Alchemy wallet API. Requires AGENT_WALLET_SERVER
Initiate a token swap from a smart contract account (SCA) via the Alchemy wallet API. Requires AGENT_WALLET_SERVER
Get all NFTs owned by an address on a single network, with metadata and spam filtering options
Get all NFTs in a specific contract or collection with optional metadata
Get all NFTs in a collection by contract address or OpenSea slug
Get metadata for a specific NFT by contract address and token ID
Get metadata for an NFT contract (name, symbol, total supply, etc.)
Get metadata for an NFT collection by its OpenSea slug
Invalidate cached metadata for an NFT contract to force a refresh on next query
Get all owner addresses for a specific NFT token
Get all owner addresses for an NFT contract, optionally with token balances
Get a list of all known spam NFT contract addresses on a network
Check if a specific contract address is flagged as spam
Check if a specific NFT is flagged as an airdrop
Get a summary of trait/attribute distribution for an NFT collection
Get the marketplace floor price for an NFT collection
Search for NFT contracts by keyword in their metadata
Check if a wallet address owns any NFTs from a specific contract
Compute the rarity score for a specific NFT within its collection
Get historical NFT sales data, filterable by marketplace, contract, buyer, or seller
Get all NFT contracts that an address owns tokens in
Get all NFT collections that an address owns tokens in
Report an NFT contract address as spam or not spam
Get the ERC-20 token allowance a spender has been granted by an owner
Get ERC-20 token balances for a wallet address on a single network
Get metadata (name, symbol, decimals, logo) for an ERC-20 token contract
Get all transaction receipts for a given block by number or hash
Get the raw RLP-encoded block data for a given block number or tag
Get the raw RLP-encoded block header for a given block number or tag
Get the raw receipt data for all transactions in a block
Replay and trace all transactions in a block identified by its hash
Replay and trace all transactions in a block identified by its number
Trace a call without executing it on-chain — useful for debugging contract interactions
Get a detailed execution trace of an already-mined transaction
Get Parity-style execution traces for all transactions in a block
Execute and trace a call without broadcasting it (Parity-style tracing)
Get a specific sub-trace within a transaction by index position
Trace a raw signed transaction without broadcasting it to the network
Replay all transactions in a block and return traces with optional state diffs
Replay a specific transaction and return its trace with optional state diffs
Get the Parity-style execution trace of an already-mined transaction
Search for traces matching criteria like sender, recipient, and block range
Simulate a transaction and preview what asset changes (token transfers, ETH movements) would occur
Simulate a bundle of 1-2 transactions and preview the combined asset changes
Simulate full transaction execution and get detailed call traces, logs, and return data
Simulate execution of a bundle of 1-2 transactions with full call traces
Get the recommended max priority fee per gas for EIP-1559 transactions
Get the receipt for an ERC-4337 user operation by its hash
Get the entry point contract addresses supported for ERC-4337 account abstraction
Get details of an ERC-4337 user operation by its hash
Estimate gas costs for an ERC-4337 user operation against an entry point
Simulate an ERC-4337 user operation and preview the predicted asset changes
Get Ethereum Beacon Chain genesis information (time, validator root, fork version)
Get a Beacon Chain block by slot number, root, or keyword (head, finalized, genesis)
Get attestations included in a specific Beacon Chain block
Get the root hash of a specific Beacon Chain block
Get blob sidecars for a Beacon Chain block (EIP-4844 blob data)
Get Beacon Chain block headers, optionally filtered by slot or parent root
Get a specific Beacon Chain block header by its block ID
Get voluntary validator exit messages currently in the Beacon Chain mempool
Get attestations currently pending in the Beacon Chain mempool
Get beacon committee assignments for a given state, optionally filtered by epoch/slot
Get finality checkpoints (justified and finalized epochs) for a given state
Get the fork version information for a given Beacon Chain state
Get pending validator consolidation requests for a given state
Get the state root hash for a given Beacon Chain state
Get sync committee assignments for a given state and optional epoch
Get the RANDAO mix value for a given Beacon Chain state and optional epoch
Get validator ETH balances for a given state, optionally filtered by validator ID
Get validator details for a given state, optionally filtered by ID or status
Get full details for a specific Beacon Chain validator by index or public key
Get the block rewards breakdown (proposer, attestation, sync committee) for a Beacon block
Get the full Beacon Chain configuration specification and protocol constants
Check whether a Beacon Chain node is currently syncing and its sync progress
Get the software version string of the Beacon Chain node
Get detailed information about a Solana asset (token, NFT, or compressed NFT) by its mint ID
Get detailed information about multiple Solana assets by their mint IDs in a single request
Get the Merkle proof for a compressed Solana asset, needed for on-chain verification
Get Merkle proofs for multiple compressed Solana assets in a single request
Get all Solana assets managed by a specific authority address
Get all Solana assets created by a specific address, with optional verification filter
Get all Solana assets in a specific group (e.g. an NFT collection)
Get all Solana assets (tokens, NFTs) owned by a specific wallet address
Get transaction signatures associated with a specific Solana asset
Get edition information (master/print editions) for a Solana NFT
Get Solana SPL token accounts filtered by mint address or owner
Search for Solana assets with flexible filters (owner, creator, authority, burnt, frozen status)
Overview
What is Alchemy MCP Server?
This open-source Model Context Protocol server bridges AI agents with Alchemy's blockchain APIs, enabling queries for token prices, NFT ownership, transaction history, token balances, and asset transfers across multiple networks. It also supports sending transactions and executing token swaps via Smart Contract Accounts (requires external wallet infrastructure). A hosted remote version at https://mcp.alchemy.com/mcp is recommended; a local STDIO version is available as legacy.
How to use Alchemy MCP Server?
To use the recommended hosted server, point your MCP client to https://mcp.alchemy.com/mcp with Streamable HTTP transport and authenticate via OAuth — no API key required. The local STDIO server runs via npx -y @alchemy/mcp-server and requires the ALCHEMY_API_KEY environment variable. For transaction and swap methods, also set AGENT_WALLET_SERVER to a configured wallet agent server.
Key features of Alchemy MCP Server
- Query token prices by symbol or contract address
- Retrieve historical price data with flexible time frames
- Check token balances across multiple blockchain networks
- Get NFT ownership and contract data across chains
- View transaction history and detailed asset transfers
- Send transactions and execute DEX swaps (requires wallet agent)
Use cases of Alchemy MCP Server
- An AI analyst fetching real-time and historical token prices.
- A portfolio tracker checking token balances across Ethereum and Base.
- An NFT curator listing NFTs owned by a wallet with spam filtering.
- A transaction auditor retrieving transfer history with advanced filters.
- A DeFi assistant initiating swaps and transfers via Smart Contract Accounts.
FAQ from Alchemy MCP Server
How does this server differ from directly calling Alchemy's REST APIs?
It abstracts Alchemy's blockchain APIs into an MCP interface, allowing AI agents to call them via natural language prompts instead of manual HTTP requests.
What are the runtime requirements?
The hosted server needs no local installation. The local STDIO server requires Node.js and an Alchemy API key. For transactions and swaps, a separate wallet agent server is required.
Where does data live?
All data is fetched live from Alchemy's blockchain APIs. The server acts as a real-time bridge with no local storage.
Are there any known limits?
The local STDIO server is legacy and not actively maintained. It may lag behind the hosted server's tool coverage and behavior. Alchemy plans to sunset this repository.
What transports and authentication are supported?
The hosted server uses Streamable HTTP transport with OAuth authentication. The local server uses STDIO transport and authenticates via an API key environment variable.
Frequently asked questions
How does this server differ from directly calling Alchemy's REST APIs?
It abstracts Alchemy's blockchain APIs into an MCP interface, allowing AI agents to call them via natural language prompts instead of manual HTTP requests.
What are the runtime requirements?
The hosted server needs no local installation. The local STDIO server requires Node.js and an Alchemy API key. For transactions and swaps, a separate wallet agent server is required.
Where does data live?
All data is fetched live from Alchemy's blockchain APIs. The server acts as a real-time bridge with no local storage.
Are there any known limits?
The local STDIO server is legacy and not actively maintained. It may lag behind the hosted server's tool coverage and behavior. Alchemy plans to sunset this repository.
What transports and authentication are supported?
The hosted server uses Streamable HTTP transport with OAuth authentication. The local server uses STDIO transport and authenticates via an API key environment variable.
Basic information
More Other MCP servers
Lemon.io
lemon-ioRequest dedicated senior developers to work on your project, write job descriptions, and prep technical interviews — all without leaving your Claude chat. Just describe what you need, and Lemon.io MCP does the rest. 1–3
Maestro
mobile-dev-incPainless E2E Automation for Mobile and Web
DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
Comments