alchemy

Alchemy MCP Server provides a bridge between AI agents and Alchemy's blockchain APIs, enabling queries about token prices, price history, NFT ownership, multi-network balances, transaction history, and asset transfers. It also exposes methods to send transactions and perform token swaps via a wallet agent server when configured. You can prompt your agent to call these methods to fetch live blockchain data and to execute operations that require signing, such as transfers or swaps, once you have a wallet agent server in place.

To use the server, configure the MCP in your client (e.g., Claude Desktop or Cursor) with the provided mcpServers entry. Supply your Alchemy API key via ALCHEMY_API_KEY and, if you plan to perform transactions or swaps, provide AGENT_WALLET_SERVER that points to your wallet agent service. After starting the MCP server, you can invoke methods like fetchTokenPriceBySymbol, fetchAddressTransactionHistory, fetchNftsOwnedByMultichainAddresses, and fetchTransfers to retrieve data. For transactional actions, use sendTransaction and swap, ensuring the wallet agent server is reachable and properly configured.

Prerequisites:

• Node.js and npm/yarn/pnpm installed
• Access to an Alchemy API key (for data queries)

Installation steps:

1. Install pnpm globally if you don’t have it:

npm install -g pnpm

2. Clone the repository (or skip if using npx approach from README):

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

3. Install dependencies:

pnpm install

4. Run the MCP server locally (example using npm script or the provided npx entry):

pnpm run start

Alternatively, if you prefer using the published MCP server via npx without cloning:

npx -y @alchemy/mcp-server

5. For development/workflows, you can use:

pnpm run watch   # development mode
pnpm run build   # production build
pnpm run inspector  # open MCP Inspector for debugging

Configure environment variables as needed (see mcp_config example) and ensure AGENT_WALLET_SERVER is accessible if you intend to use transactional methods.

Notes and tips:

• Ensure ALCHEMY_API_KEY is set in your environment to access Alchemy APIs.
• For sendTransaction and swap methods, a configured wallet agent server is required via AGENT_WALLET_SERVER. Without it, transactional methods will not function.
• The MCP Inspector can assist in testing methods and parameters before integrating into agents.
• If you rotate API keys or endpoints, update environment variables accordingly.
• The npx-based setup allows quick trials without cloning the repository, but cloning is helpful for local development and debugging.