# Alchemy MCP Server

> Query blockchain data from your AI tool with the Alchemy MCP server.

The [Alchemy MCP Server](https://github.com/alchemyplatform/alchemy-mcp-server) gives your AI tools direct access to blockchain data through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). Query token prices, NFT ownership, transaction history, and more as tool calls, with no code required.

## Add the server to your MCP config

Add this configuration to your MCP config file:

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

Get your API key at the [Alchemy Dashboard](https://dashboard.alchemy.com/).

> The Alchemy MCP server currently only supports [STDIO transport](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#stdio) for local MCP client use. Remote connection via [Streamable-HTTP transport](https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http) is in development.

## Configure your client

### Claude Desktop

Add the configuration above to your Claude Desktop config file:

* **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
* **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`

Restart Claude Desktop after saving.

### Cursor

Add the configuration to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project-level).

### Claude Code

```bash
claude mcp add-json "alchemy" '{"command":"npx","args":["-y","@alchemy/mcp-server"],"env":{"ALCHEMY_API_KEY":"YOUR_API_KEY"}}'
```

### VS Code Copilot

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

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

### Windsurf

Add the configuration to your Windsurf MCP config file:

* **macOS:** `~/.codeium/windsurf/mcp_config.json`
* **Windows:** `%USERPROFILE%\.codeium\windsurf\mcp_config.json`

## Available tools

The MCP server exposes the following tools:

**Token prices**
* `fetchTokenPriceBySymbol`: Get current token prices by symbol
* `fetchTokenPriceByAddress`: Get current token prices by contract address
* `fetchTokenPriceHistoryBySymbol`: Get historical price data over time
* `fetchTokenPriceHistoryByTimeFrame`: Get historical price data using flexible time frames or natural language

**Token balances**
* `fetchTokensOwnedByMultichainAddresses`: Get token balances across multiple chains

**Transactions and transfers**
* `fetchAddressTransactionHistory`: Get single-address transaction history
* `fetchTransfers`: Get token transfer data with filtering

**NFTs**
* `fetchNftsOwnedByMultichainAddresses`: Get NFT ownership across chains with spam filtering
* `fetchNftContractDataByMultichainAddress`: Get NFT collection data

## Supported chains

We support 50+ blockchains including Ethereum, Base, Polygon, Arbitrum, Optimism, Solana, Starknet, and more.

## Watch the walkthrough

<div style={{ position: "relative", paddingBottom: "56.25%", height: 0, overflow: "hidden" }}>
  <iframe style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: "none" }} src="https://www.youtube.com/embed/ZhR9O5mC_3Q" title="YouTube video player" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerPolicy="strict-origin-when-cross-origin" allowFullScreen />
</div>

## Next steps

* [GitHub: alchemyplatform/alchemy-mcp-server](https://github.com/alchemyplatform/alchemy-mcp-server)
* [npm: @alchemy/mcp-server](https://www.npmjs.com/package/@alchemy/mcp-server)