Alchemy Blockchain API MCP server for AI agents

The Alchemy MCP Server creates a bridge between AI agents and Alchemy's blockchain APIs, allowing agents to query blockchain data directly without writing code. It enables querying token prices, viewing NFT ownership, checking transaction history, retrieving token balances across blockchain networks, and more.

Quick Setup

To set up the Alchemy MCP server, add the following configuration to your MCP config file (typically found in Claude Desktop or Cursor settings):

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

This allows you to use the server without manually cloning the repository. Make sure to replace YOUR_API_KEY with your actual Alchemy API key.

Available Methods

You can prompt AI agents to use the following blockchain data retrieval methods:

Token Price Methods

fetchTokenPriceBySymbol

Gets current price data for tokens by symbol.

Example prompt: "What's the current price of ETH and BTC?"

fetchTokenPriceByAddress

Gets current price data for tokens by contract address.

Example prompt: "What's the price of the token at address 0x1234...5678 on Ethereum mainnet?"

fetchTokenPriceHistoryBySymbol

Gets historical price data for tokens.

Example prompt: "Show me BTC price history from Jan 1 to Feb 1, 2023, with daily intervals"

Multichain Token Methods

fetchTokensOwnedByMultichainAddresses

Gets token balances for addresses across multiple networks.

Example prompt: "What tokens does 0xabc...123 hold on Ethereum and Base?"

Transaction History Methods

fetchMultichainWalletAddressTransactionHistory

Gets transaction history for addresses across multiple networks.

Example prompt: "Show recent transactions for wallet 0xdef...456 on Ethereum"

fetchTransfers

Gets token transfer data for addresses.

Example prompt: "Show me all ERC-20 transfers to or from 0xghi...789"

NFT Methods

fetchNftsOwnedByMultichainAddresses

Gets all NFTs owned by addresses.

Example prompt: "What NFTs does 0xjkl...012 own?"

fetchNftContractDataByMultichainAddress

Gets NFT contract data for addresses.

Example prompt: "What NFT collections does 0xmno...345 have tokens from?"

Example Prompts

Here are some additional example prompts you can use with your AI agent:

"What's the current price of Bitcoin and Ethereum?"
"Show me the NFTs owned by the wallet 0x1234...5678 on Ethereum."
"What tokens does wallet 0xabcd...6789 hold across Ethereum and Base?"
"Get me the transaction history for 0x9876...5432 from the last week."
"Show me the price history of Ethereum from January 1st to today with daily intervals."

Additional Resources

For more information about Alchemy's APIs, refer to the Alchemy API Documentation.

How to install this MCP server

For Claude Code

To add this MCP server to Claude Code, run this command in your terminal:

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

See the official Claude Code MCP documentation for more details.

For Cursor

There are two ways to add an MCP server to Cursor. The most common way is to add the server globally in the ~/.cursor/mcp.json file so that it is available in all of your projects.

If you only need the server in a single project, you can add it to the project instead by creating or adding it to the .cursor/mcp.json file.

Adding an MCP server to Cursor globally

To add a global MCP server go to Cursor Settings > Tools & Integrations and click "New MCP Server".

When you click that button the ~/.cursor/mcp.json file will be opened and you can add your server like this:

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

Adding an MCP server to a project

To add an MCP server to a project you can create a new .cursor/mcp.json file or add it to the existing one. This will look exactly the same as the global MCP server example above.

How to use the MCP server

Once the server is installed, you might need to head back to Settings > MCP and click the refresh button.

The Cursor agent will then be able to see the available tools the added MCP server has available and will call them when it needs to.

You can also explicitly ask the agent to use the tool by mentioning the tool name and describing what the function does.

For Claude Desktop

To add this MCP server to Claude Desktop:

1. Find your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

2. Add this to your configuration file:

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

3. Restart Claude Desktop for the changes to take effect