Wormhole MCP – Multichain Token Transfer MCP via Wormhole SDK

Wormhole MCP is a TypeScript/Node.js Model Context Protocol (MCP) server that enables automatic transfer of tokens across multiple blockchains using the Wormhole SDK. It provides utilities for managing cross-chain transfers, wallet operations, and environment-based configuration for secure key management.

This MCP abstracts the complexity of cross-chain interactions by providing a structured, context-aware layer for initiating and managing token transfers. It is designed for easy integration with LLM agents, bots, or applications that require secure and reliable access to decentralized cross-chain liquidity.

Features

• 🌐 Cross-Chain Swaps: Move native tokens between EVM and non-EVM chains using Wormhole’s trusted bridging layer.
• 🤖 Agent-Friendly Protocol: Encodes user intent and target chain data into a standardized, model-readable format.
• 🔐 Secure & Verifiable Transfers: Ensures swaps are signed and verified with full user approval.
• ⚙️ Modular Integration: Easily plugs into existing model or bot frameworks alongside other MCP components.
• 📡 Chain-Agnostic Design: Built to support a growing number of chains supported by Wormhole NTT.
• 💼 Secure Transaction Handling: Signs and sends transactions securely, using environment-based key management.

Setup

Prerequisites

• Node.js (v16 or higher recommended)
• npm or yarn
• Claude for Deskop

Installation

1. Clone the repository:

   git clone https://github.com/collinsezedike/wormhole-mcp
   cd wormhole-mcp
   

   Copy

2. Install dependencies:

   npm install
   # or
   yarn install
   

   Copy

3. Build the project:

   npm run build
   # or
   yarn run build
   

   Copy

4. Configure the MCP for Claude for Desktop:
   Add the MCP configuration to C:\Users\{User}\AppData\Roaming\Claude\claude_desktop_config.json

   "wormhole-mcp": {
      "command": "node",
      "args": [
          "<PROJECT_ABSOLUTE_FILEPATH>\\build\\index.js"
      ],
      "env": {
          "SOL_PRIVATE_KEY": "<base58-encoded solana private key>",
          "ETH_PRIVATE_KEY": "<base16-encoded ethereum private key>"
      }
   }
   

   Copy

   Follow this guide

5. Run the application: Head to open Claude for Desktop and verify that the Wormhole MCP tools has been added. Try asking the Chatbot for the to bridge from Sepolia to Avalanche.

   NOTE: Ensure you have testnet USDC in your wallet. You can get some testnet USDC from the Circle Faucet.

Contributing

Pull requests are welcome! For major changes, please open an issue first to discuss what you would like to change.