Alchemy MCP Server

🚀 Alchemy MCP Server

A Model Context Protocol (MCP) server that enables AI agents to interact with Alchemy's blockchain API in a structured manner. This allows agents to directly query blockchain data without writing any code.

🚀 Quick Start

This MCP server serves as a bridge between AI agents and Alchemy's blockchain API, allowing agents to:

• Query token prices and price histories
• Obtain NFT owner information
• View transaction records
• Check token balances across multiple blockchain networks
• Retrieve asset transfers
• And more!

🛠️ Quick Setup

To quickly set up the MCP server, use the following configuration in your MCP configuration file (usually located in Claude Desktop or Cursor settings):

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

This configuration allows you to use the server without manually cloning the repository.

✨ Features

You can prompt your AI agent to use the following methods:

Token Price Methods

1. fetchTokenPriceBySymbol

   • Fetch the current token price data based on the symbol.
   • Example: "What are the current prices of ETH and BTC?"

2. fetchTokenPriceByAddress

   • Fetch the current token price data based on the contract address.
   • Example: "What is the price of ETH at address 0x1234...5678?"

3. fetchTokenPriceHistoryBySymbol

   • Fetch the historical price data of a token.
   • Example: "Show the daily price history of BTC between January 1st and February 1st, 2023."

Multi-chain Token Methods

4. fetchTokensOwnedByMultichainAddresses
   • Get the token balances of addresses across multiple networks.
   • Example: "Which tokens does 0xabc...123 hold on the Ethereum and Base networks?"

Transaction Record Methods

5. fetchMultichainWalletAddressTransactionHistory

   • Get the transaction history of a multi-chain wallet address.
   • Example: "Show the recent transaction records of address 0xdef...456 on the Ethereum network."

6. fetchTransfers

   • Get the token transfer data of an address.
   • Example: "Show all ERC-20 transfers to or from 0xghi...789."

NFT Methods

7. fetchNftsOwnedByMultichainAddresses

   • Get all NFTs owned by multiple addresses.
   • Example: "Which NFTs does address 0xjkl...012 own?"

8. fetchNftContractDataByMultichainAddress

   • Get the NFT contract data of multiple addresses.
   • Example: "Which NFT collection series is address 0xmno...345 involved in?"

📦 Installation

Local Development and Open-source Contribution

1. Clone the repository

git clone https://github.com/alchemyplatform/alchemy-mcp.git
cd alchemy-mcp

2. Install dependencies

npm install

Run Tests

npm test

Build the Project

npm run build

Start the Local Development Server

npm start

Open-source Contribution

We welcome contributions from the community! Please refer to CONTRIBUTING.md to learn how to get involved.

📄 License

This project is protected under the MIT License.

💻 Usage Examples

Here are some usage examples:

Query Token Price

curl -X POST http://localhost:3000/api/v1/queryTokenPrice \
  -H "Content-Type: application/json" \
  -d '{"symbol": "ETH"}'

Get NFT Information

curl -X POST http://localhost:3000/api/v1/getNfts \
  -H "Content-Type: application/json" \
  -d '{"address": "0xjkl...012"}'

📚 Documentation

For the full API documentation, please refer to API DOCS.

With the above information, you can easily start using the Alchemy MCP server to interact with the blockchain.