README - Monad Bridge MCP Server by rawakinode

Monad Bridge MCP Server

A lightweight Model Context Protocol (MCP) server that enables bridging functionality between Ethereum Sepolia and Monad Testnet networks using the Wormhole bridge. This MCP interacts with Monadbridge and Wormholes APIs.

🚀 Supported Tools

This MCP server provides the following tools:

Tools Name	Description	Command
`get-wallet-address`	Get wallet address from private key.	`show my wallet address`
`get-eth-balance`	Check ETH balance on Sepolia testnet.	`check our ETH balance`
`get-mon-balance`	Check MON balance on Monad testnet.	`check our MONAD balance`
`bridge-sepolia-wmon-to-monad`	Bridge wrapped MON (wMON) on Sepolia to MON on Monad.	`bridge 1 mon sepolia to monad`
`bridge-monad-to-sepolia-wmon`	Bridge MON from Monad to wMON on Sepolia.	`bridge 1 monad to sepolia`
`get-wmon-sepolia-balance`	Check Wrapped MON (wMON) balance on Sepolia.	`check our wmon balance on sepolia`
`get-10-last-bridge-transaction`	Get and view the last 10 bridge transactions from Sepolia to Monad or Monad to Sepolia	`get 10 last bridge transaction` `get last bridge`

Quick Start

Clone the repository

git clone https://github.com/rawakinode/monad-bridge-mcp-server.git
cd monad-bridge-mcp-server
npm install

Build and run

npm run build

Prerequisites

Node.js (v16 or newer)
npm or yarn
Claude Desktop (for MCP Client integration)

How to Use

You need to Download and install Claude Dekstop
Open Claude Dekstop
Go to Settings > Developer
Open config . Edit claude_desktop_config.json
Add the following configuration.

{
  "mcpServers": {
    "monad-mcp": {
      "command": "node",
      "args": ["<your-local-path>monad-bridge-mcp-server\\build\\index.js"],
      "env": {
        "PRIVATE_KEY": "<your-private-key>" 
      }
    }
  }
}

Replace <your-local-path>monad-bridge-mcp-server\\build\\index.js with the actual path to your project directory (e.g., E:\data\monad-bridge-mcp-server\build\index.js on Windows or /home/user/monad-bridge-mcp-server\build\index.js on Linux).
Restart Claude Desktop.
When prompted, allow MCP access for the chat session (Allow for This Chat).

Command Usage

Check Wallet Address

Write command show my wallet address on Claude.
Allow MCP access for the chat session (Allow for This Chat).
Claude will respon with your wallet address from your PRIVATE_KEY.

Check Wallet Balance (ETH, MONAD, and wMON)

Write command check our ETH balance, check our MONAD balance, and check our wmon balance on sepolia on Claude.
Allow MCP access for the chat session (Allow for This Chat).
Claude will respon with balance ETH sepolia, MON, and wMON Sepolia.

monad-bridge-mcp-server