Use the hosted Alchemy MCP server for live blockchain data, transaction simulation, tracing, NFT/portfolio queries, and Alchemy app administration from inside your AI client.
When to use this skill
Use alchemy-mcp when all of the following are true:
- The user wants live agent work — live querying, analysis, admin work, or on-machine automation that the agent runs now in this session
- The Alchemy MCP server (
https://mcp.alchemy.com/mcp) is connected in this session (the Alchemy plugin provides the connection)
When to use a different skill
| Situation | Use this skill instead |
|---|---|
| Building application code that runs outside this agent session, with an Alchemy API key | alchemy-api |
| Building application code and you don't have an API key yet | alchemy-api (copy a key from the Alchemy Dashboard, https://dashboard.alchemy.com) |
Do not use this skill to write production application code — MCP tools are for live agent work, not for embedding into shipped software.
Connect your client
The server runs at https://mcp.alchemy.com/mcp and authenticates via OAuth — your client opens a browser to sign in with your Alchemy account on first use. No API key or local install required.
Claude Code
The fastest path is the official Alchemy Claude Plugin, which bundles this MCP server, slash commands (/alchemy:balance, /alchemy:nfts, /alchemy:portfolio, etc.), and the alchemy-mcp and alchemy-api skills in one install:
/plugin marketplace add alchemyplatform/alchemy-claude-plugin
/plugin install alchemy@alchemy
Then run /alchemy:setup to pick an app for the session. OAuth opens automatically on the first Alchemy tool call.
Bootstrap workflow
Once the server is connected and you've signed in via OAuth:
- List apps —
list_appsto see your Alchemy apps. - Select an app —
select_appwith the app ID. This caches the API key the server uses for RPC and Data tools. Required before any RPC or Data tool call. - Run tools — call any of the 150+ tools (e.g.
getTokenPricesBySymbol,getNFTsForOwner,simulateAssetChanges,solana_getBalance).
If you need to create an app first:
create_app(name="My App", chain_networks=["eth-mainnet", "base-mainnet"])
Then select_app against the new app.
Tool catalog
The server exposes 171 tools in this plugin's profile. This is a selected catalog: the Admin list below shows 8 of the 23 admin tools and omits the team, webhook, Gas Manager policy, usage, and feedback tools, and the RPC and Data tables show example tools per cluster.
Admin (8 selected of 23 tools) — Account & app management
| Tool | Purpose |
|---|---|
ping |
Health check |
list_apps |
List your Alchemy apps |
get_app |
Get app details |
select_app |
Select an app and cache its API key for RPC/Data tools |
create_app |
Create a new app |
update_app |
Update app name or description |
list_chains |
List all 100+ supported networks |
update_allowlist |
Update app allowlists (network, address, origin, IP) |
RPC (120 tools) — On-chain JSON-RPC
Standard EVM RPC, Token API, Transfers & Receipts, Transaction Simulation, Trace API, Debug API, ERC-4337 Account Abstraction, Solana standard RPC, and Solana Enhanced & DAS.
| Cluster | Count | Examples |
|---|---|---|
| Standard EVM RPC | 31 | ethBlockNumber, ethGetBalance, ethCall, ethGetLogs, ethCallBundle |
| Token API | 3 | getTokenBalances, getTokenMetadata, getTokenAllowance |
| Transfers & Receipts | 2 | getAssetTransfers, getTransactionReceipts |
| Transaction Simulation | 5 | simulateAssetChanges, simulateExecution, simulateUserOperationAssetChanges |
| Trace API | 6 | traceCall, traceTransaction, traceBlock, traceFilter |
| Debug API | 6 | debugTraceTransaction, debugTraceCall, debugTraceBlockByNumber |
| ERC-4337 Account Abstraction | 5 | estimateUserOperationGas, getUserOperationReceipt, getUserOperationByHash |
| Solana Standard RPC | 49 | solana_getBalance, solana_getTokenAccountsByOwner, solana_getBlock, solana_simulateTransaction |
| Solana Enhanced & DAS | 13 | solana_getAsset, solana_getAssetsByOwner, solana_searchAssets, solana_getPriorityFeeEstimate |
Data (28 tools) — REST APIs
| Cluster | Count | Examples |
|---|---|---|
| NFT API | 21 | getNFTsForOwner, getNFTMetadata, getOwnersForNFT, getFloorPrice, getNFTsForContract |
| Prices API | 3 | getTokenPricesBySymbol, getTokenPricesByAddress, getHistoricalTokenPrices |
| Portfolio (multi-chain) | 4 | getTokensByAddress, getTokenBalancesByAddress, getNFTsByAddress, getNFTContractsByAddress |
Common task → tool map
| Task | Tool | Notes |
|---|---|---|
| Latest ETH block number | ethBlockNumber |
Pass network: "eth-mainnet" |
| ETH balance for an address | ethGetBalance |
Returns hex wei |
| ERC-20 balances | getTokenBalances |
Use getTokenMetadata to resolve symbol/decimals |
| ERC-20 metadata | getTokenMetadata |
name, symbol, decimals, logo |
| Asset transfers (history) | getAssetTransfers |
Filter by category (erc20, erc721, erc1155, external, internal) |
| Simulate a tx | simulateAssetChanges |
Pre-flight asset deltas |
| Trace a tx | traceTransaction |
Internal call tree |
| Debug-trace a tx | debugTraceTransaction |
Geth-style structured trace |
| List owned NFTs | getNFTsForOwner |
Across one chain |
| Multi-chain NFTs | getNFTsByAddress |
Across many chains |
| NFT metadata | getNFTMetadata |
Per token id |
| NFT floor price | getFloorPrice |
From major marketplaces |
| Token prices (spot) | getTokenPricesBySymbol |
e.g. ["ETH","USDC"] |
| Token prices (historical) | getHistoricalTokenPrices |
Time range queries |
| Multi-chain portfolio | getTokenBalancesByAddress |
With USD values |
| Solana balance | solana_getBalance |
Lamports |
| Solana token accounts | solana_getTokenAccountsByOwner |
SPL tokens |
| Compressed NFT lookup | solana_getAsset |
DAS standard |
| Owner's compressed NFTs | solana_getAssetsByOwner |
DAS standard |
| Solana priority fees | solana_getPriorityFeeEstimate |
Recent samples |
| User operation receipt | getUserOperationReceipt |
ERC-4337 |
Operating rules
- Always call
select_appfirst before any RPC or Data tool. Tools error out with a clear message if no app is selected. - Use the canonical chain slugs returned by
list_chains(e.g.eth-mainnet,base-mainnet,solana-mainnet). Tool error messages will guide you if you guess wrong. - Don't bypass the MCP server with raw curl/HTTP from inside the agent — that's the API-key path covered by
alchemy-api. MCP tools are the canonical interface for this skill. - Don't use MCP tools to generate production application code. When the user wants to ship code, hand off to
alchemy-api(copy your API key from the Alchemy Dashboard).
Supported chains
100+ chains including Ethereum, Base, Polygon, Arbitrum, Optimism, BNB, Solana, Starknet, zkSync, Scroll, Linea, Mantle, Blast, World Chain, and many more. Use list_chains to fetch the full list.
Troubleshooting
"No app selected"
Call select_app with the desired app ID. If you don't have an app yet, run create_app first.
OAuth flow doesn't open
Restart your MCP client after adding the server. For Claude Code, run /mcp and select alchemy to trigger the sign-in flow manually.
Tool not found
Some tools are namespaced (e.g. solana_* for Solana). Use list_chains to confirm the chain slug and check the tool catalog above for the exact name.
Rate limits / compute units
The MCP server inherits the rate limits of the selected app. Check usage in the Alchemy dashboard.