alchemy-mcp

# Alchemy MCP 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](https://www.alchemy.com/docs/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: ```text /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: 1. **List apps** — `list_apps` to see your Alchemy apps. 2. **Select an app** — `select_app` with the app ID. This caches the API key the server uses for RPC and Data tools. **Required before any RPC or Data tool call.** 3. **Run tools** — call any of the 150+ tools (e.g. `getTokenPricesBySymbol`, `getNFTsForOwner`, `simulateAssetChanges`, `solana_getBalance`). If you need to create an app first: ```text 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_app` first** 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](https://dashboard.alchemy.com/). ## Official links - [Alchemy MCP server (hosted)](https://mcp.alchemy.com/mcp) - [Alchemy MCP source on GitHub](https://github.com/alchemyplatform/alchemy-mcp-server) - [Alchemy developer docs](https://www.alchemy.com/docs) - [Model Context Protocol](https://modelcontextprotocol.io/) - [Alchemy dashboard](https://dashboard.alchemy.com/)