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

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:

/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.

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

claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp

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

Codex

codex mcp add alchemy --url https://mcp.alchemy.com/mcp

Verify with codex mcp list.

Cursor

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

{
  "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):

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

VS Code Copilot

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

{
  "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:

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 159 tools (e.g. getTokenPricesBySymbol, getNFTsForOwner, simulateAssetChanges, solana_getBalance).

If you need to create an app first:

create_app(name="My App", networks=["eth-mainnet", "base-mainnet"])

Then select_app against the new app.

Tool catalog

The server exposes 159 tools across three categories.

Admin (8 tools) — Account & app management

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.

Data (28 tools) — REST APIs

Common task → tool map

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

• Alchemy MCP server (hosted)
• Alchemy MCP source on GitHub
• Alchemy developer docs
• Model Context Protocol
• Alchemy dashboard