What is Wormhole Mcp

Wormhole MCP is a TypeScript/Node.js Model Context Protocol (MCP) server that facilitates automatic token transfers across multiple blockchains using the Wormhole SDK. It simplifies cross-chain interactions by providing a structured layer for managing token transfers securely.

Use cases

Use cases for Wormhole MCP include facilitating token swaps in DeFi applications, enabling cross-chain transactions for decentralized applications (dApps), and integrating with bots or agents that require reliable access to multi-chain liquidity.

How to use

To use Wormhole MCP, clone the repository from GitHub, install the necessary dependencies using npm or yarn, build the project, and configure it for use with Claude for Desktop. Follow the setup instructions provided in the README.

Key features

Key features include cross-chain swaps between EVM and non-EVM chains, an agent-friendly protocol for encoding user intent, secure and verifiable transfers, modular integration capabilities, a chain-agnostic design, and secure transaction handling with environment-based key management.

Where to use

Wormhole MCP can be used in various fields such as decentralized finance (DeFi), blockchain applications requiring cross-chain liquidity, and any system needing secure token transfers across different blockchain networks.

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
   

2. Install dependencies:

   npm install
   # or
   yarn install
   

3. Build the project:

   npm run build
   # or
   yarn run build
   

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

   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.