Alchemy MCP Server

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

Remote MCP Server (Recommended)

The fastest way to get started is to connect to the hosted remote server at https://mcp.alchemy.com/mcp. It authenticates via OAuth — just sign in with your Alchemy account when prompted. No API key or local install required.

Full documentation: alchemy.com/docs/alchemy-mcp-server

Note: The hosted server at mcp.alchemy.com and this open-source repo are maintained separately and may not be in sync.

{
  "mcpServers": {
    "alchemy": {
      "type": "streamable-http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

{
  "servers": {
    "alchemy": {
      "type": "http",
      "url": "https://mcp.alchemy.com/mcp"
    }
  }
}

For any other MCP-compatible client, point it at https://mcp.alchemy.com/mcp using Streamable HTTP transport.

Local STDIO Server

This MCP server creates a bridge between AI agents and Alchemy's blockchain APIs, allowing agents to:

• Query token prices and price history (including flexible time frame queries)
• Get NFT ownership information and contract data
• View transaction history across multiple networks
• Check token balances across multiple blockchain networks
• Retrieve detailed asset transfers with filtering
• Send transactions via Smart Contract Accounts (requires configured wallet agent server)
• Execute token swaps via DEX protocols (requires configured wallet agent server)
• And more!

Quick Setup

To quickly set up the MCP server, use the following configuration in your MCP config file (typically 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.

Environment Variables

The MCP server requires the following environment variable:

• ALCHEMY_API_KEY - Your Alchemy API key (required for all blockchain data queries)

For transaction and swap functionality, you must also configure:

• AGENT_WALLET_SERVER - URL of a configured wallet agent server that handles Smart Contract Account operations

⚠️ Important: The sendTransaction and swap methods will not function without a properly c

... View full README on GitHub