home / mcp / alchemy mcp server

Alchemy MCP Server

Alchemy's official MCP Server. Allow AI agents to interact with Alchemy's blockchain APIs.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "alchemyplatform-alchemy-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@alchemy/mcp-server"
      ],
      "env": {
        "ALCHEMY_API_KEY": "YOUR_API_KEY",
        "AGENT_WALLET_SERVER": "https://wallet.example/agent"
      }
    }
  }
}

This MCP server lets you bridge your AI agent with Alchemy’s blockchain APIs, enabling you to query prices, NFT data, balances, transfers, and more without writing integration code. It handles data retrieval across networks and can perform actions when you connect a wallet agent server for signing and sending transactions.

How to use

You will use an MCP client to interact with the Alchemy MCP server. Start by provisioning the server with your API key and, if you plan to send transactions or perform swaps, a wallet agent server. From there you can query current token prices, historical price data, NFT ownership, multi-network balances and transfers, and more. When you prompt your AI agent, specify the data you want (for example, the price of ETH and BTC, or NFT collections owned by a wallet) and the MCP will return the results. If you want to execute on-chain actions such as sending transactions or swaps, ensure AGENT_WALLET_SERVER is configured and available.

How to install

Prerequisites: Install Node.js (version 14 or newer) and have a working npm or pnpm installation on your machine.

Create your MCP server configuration. You can enable the Alchemy MCP server by adding the following configuration to your MCP config file.

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

Save this JSON as your MCP configuration file and replace YOUR_API_KEY with your actual Alchemy API key. If you plan to perform transactions or swaps, also configure a wallet agent server in your environment.

Run the MCP server entry through your MCP client runtime. The configuration uses npx to start the MCP server module when invoked by your client.

# Ensure your environment variable is set
export ALCHEMY_API_KEY=your_actual_api_key

# Start the MCP server using the provided configuration
npx -y @alchemy/mcp-server

Available tools

fetchTokenPriceBySymbol

Gets current price data for tokens by symbol.

fetchTokenPriceByAddress

Gets current price data for tokens by contract address.

fetchTokenPriceHistoryBySymbol

Gets historical price data for tokens with specific date ranges.

fetchTokenPriceHistoryByTimeFrame

Gets historical price data using flexible time frames or natural language.

fetchTokensOwnedByMultichainAddresses

Gets token balances for addresses across multiple networks.

fetchAddressTransactionHistory

Gets transaction history for addresses across multiple networks.

fetchTransfers

Gets detailed asset transfer data with advanced filtering options.

fetchNftsOwnedByMultichainAddresses

Gets all NFTs owned by addresses with spam filtering.

fetchNftContractDataByMultichainAddress

Gets NFT contract data for addresses.

sendTransaction

Sends transactions via Smart Contract Accounts.

swap

Executes token swaps via DEX protocols (Uniswap).