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 (scope_in)

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 NOT to use this skill (scope_out, handoff)

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

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 alchemy-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