Alchemy Mcp

alchemyplatform/skills/skills/alchemy-mcp

by alchemyplatform4caf3e555c3af8dbb9e5b540aed558aef986d885MIT49 starsListed Oct 9, 2026Updated Oct 9, 2026Repository updated 8 days ago

Use the Alchemy MCP server (`https://mcp.alchemy.com/mcp`) for live blockchain data and admin work when MCP is wired into your AI client and the Alchemy CLI is NOT installed locally. Exposes 159 tools across 100+ chains for token prices, NFT metadata, transactions, simulation, tracing, account abstraction, Solana DAS, and app management. Use for live querying, analysis, admin work, or on-machine agent work — not for application code that ships to production. For application code, use the `alchemy-api` skill (with API key) or `agentic-gateway` skill (without). When the CLI is also installed locally, prefer `alchemy-cli` instead.

Instructions onlyAI & Agents

AI-generated overview

Connects an MCP client to Alchemy's hosted server for live blockchain data and app administration.

What it does: This skill explains how to wire an MCP-compatible AI client to the hosted Alchemy MCP server and use its 159 tools across 100+ chains. It covers client setup for Claude Code, Codex, Cursor, Claude Desktop and VS Code Copilot, an app-selection bootstrap workflow, a catalog of admin, RPC and data tools, and troubleshooting notes. It produces live query results and admin actions rather than shipped application code.
When to use it: Use it when an MCP client is already configured against the hosted Alchemy server, the Alchemy CLI is not installed locally, and the user wants live on-chain querying, analysis, transaction simulation or Alchemy app administration. It is not intended for production application code, which the document directs to other skills.
Requirements: An MCP-compatible AI client configured against the hosted Alchemy MCP server over Streamable HTTP, plus OAuth sign-in with an Alchemy account; no API key or local install is required. Network access is needed. The skill ships no scripts.

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
An MCP-compatible client (Claude Code, Codex, Cursor, Claude Desktop, VS Code Copilot, etc.) is already wired against https://mcp.alchemy.com/mcp, OR the user is willing to add it
The Alchemy CLI (@alchemy/cli) is not installed locally

If the CLI is installed locally — or if both CLI and MCP are available — prefer the alchemy-cli skill instead. The CLI is the preferred local fallback runtime path.

When to use a different skill

Situation	Use this skill instead
`@alchemy/cli` is installed locally, or both CLI and MCP are available	`alchemy-cli`
Neither CLI nor MCP is available	install `alchemy-cli` (`npm i -g @alchemy/cli`), then use `alchemy-cli`
Building application code that runs outside this agent session, with an Alchemy API key	`alchemy-api`
Building application code without an API key, or as an autonomous agent that needs to pay for itself, or you explicitly want x402/MPP	`agentic-gateway`

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 agent skills in one install:

Then run /alchemy:setup to pick an app for the session. OAuth opens automatically on the first Alchemy tool call.

To wire just the MCP server without the plugin, use the manual command:

Restart Claude Code, then run /mcp and select alchemy to authenticate.

Codex

Verify with codex mcp list.

Cursor

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):

json

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

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

Restart Cursor and verify via Cursor Settings > MCP.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

json

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

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

VS Code Copilot

Add to .vscode/mcp.json in your project:

json

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

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

Any other MCP client

Point it at https://mcp.alchemy.com/mcp using Streamable HTTP transport. The server supports OAuth 2.1 with PKCE; the client handles the authorization flow automatically.

Bootstrap workflow

Once the server is connected and you've signed in via OAuth:

List apps — list_apps to see your Alchemy apps.
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.
Run tools — call any of the 159 tools (e.g. getTokenPricesBySymbol, getNFTsForOwner, simulateAssetChanges, solana_getBalance).

If you need to create an app first:

Then select_app against the new app.

Tool catalog

The server exposes 159 tools across three categories.

Admin (8 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 (123 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	7	`estimateUserOperationGas`, `getUserOperationReceipt`, `requestGasAndPaymasterAndData`
Solana Standard RPC	50	`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 (with API key) or agentic-gateway (without).

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.

Official links

Source and attribution

Source:alchemyplatform/skillsinskills/alchemy-mcpat commit4caf3e5

License: MIT

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

Alchemy Mcp

Alchemy MCP

When to use this skill

When to use a different skill

Connect your client

Claude Code

Codex

Cursor

Claude Desktop

VS Code Copilot

Any other MCP client

Bootstrap workflow

Tool catalog

Admin (8 tools) — Account & app management

RPC (123 tools) — On-chain JSON-RPC

Data (28 tools) — REST APIs

Common task → tool map

Operating rules

Supported chains

Troubleshooting

"No app selected"

OAuth flow doesn't open

Tool not found

Rate limits / compute units

Official links

Source and attribution

More from alchemyplatform/skills

Alchemy Mcp

More in AI & Agents

Ppt Template Creator

Skill Development

Plugin Structure

Command Development

Claude Md Improver

Find Skills