Skip to content
Alchemy Logo

Alchemy MCP Server

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

The Alchemy MCP Server gives your AI tools direct access to blockchain data through the Model Context Protocol (MCP). Query token prices, NFT ownership, transaction history, and more as tool calls, with no code required.

Add this configuration to your MCP config file:

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

Get your API key at the Alchemy Dashboard.

The Alchemy MCP server currently only supports STDIO transport for local MCP client use. Remote connection via Streamable-HTTP transport is in development.

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.

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

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

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

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

Add the configuration to your Windsurf MCP config file:

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

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

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

Was this page helpful?