alchemy-mcp-server

# 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](https://www.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 | <details> <summary>JSON config for Cursor / Windsurf / Claude Desktop / Cline</summary> ```json { "mcpServers": { "alchemy": { "type": "streamable-http", "url": "https://mcp.alchemy.com/mcp" } } } ``` </details> <details> <summary>JSON config for VS Code Copilot</summary> ```json { "servers": { "alchemy": { "type": "http", "url": "https://mcp.alchemy.com/mcp" } } } ``` </details> 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: ```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](#setup) section above. You can drop `ALCHEMY_API_KEY` from your MCP config; the hosted server signs you in with your Alchemy account instead.