Alchemy MCP Server README

Alchemy MCP Server

[!IMPORTANT] The legacy local MCP server has been retired. Its source code has been removed from this repository, and the @alchemy/mcp-server npm package will stop working on September 30, 2026. Use the hosted Alchemy MCP Server at https://mcp.alchemy.com/mcp instead.

The hosted Alchemy MCP Server gives AI agents access to Alchemy's blockchain APIs and onchain data. It authenticates via OAuth — just sign in with your Alchemy account when prompted. No API key or local install required.

Full documentation: alchemy.com/docs/alchemy-mcp-server

Setup

Client	Setup
Claude Code	`claude mcp add alchemy --transport http https://mcp.alchemy.com/mcp`
Codex	`codex mcp add alchemy --url https://mcp.alchemy.com/mcp`
Cursor	Add to `~/.cursor/mcp.json` or `.cursor/mcp.json` — see JSON config below
Windsurf	Add to `~/.codeium/windsurf/mcp_config.json` — see JSON config below
VS Code Copilot	Add to `.vscode/mcp.json` — see JSON config below
Claude Desktop	Add to `claude_desktop_config.json` — see JSON config below
Cline	Open `Cline: MCP Servers` from the VS Code command palette — see JSON config below

JSON config for Cursor / Windsurf / Claude Desktop / Cline

config.json

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

JSON config for VS Code Copilot

config.json

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

For any other MCP-compatible client, point it at https://mcp.alchemy.com/mcp using Streamable HTTP transport.

Migrating from the local server

If your MCP config runs the local server through npx, like this:

config.json

{
  "mcpServers": {
    "alchemy": {
      "command": "npx",
      "args": ["-y", "@alchemy/mcp-server"],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

replace that entry with the hosted server config for your client from the Setup section above. You can drop ALCHEMY_API_KEY from your MCP config; the hosted server signs you in with your Alchemy account instead.