Monad MCP Server
About
Interact with the Monad testnet, query blockchain data, and engage with the CoinflipGame smart contract.
Details
- Author
- semutireng22
- Categories
- Developer Tools, Other, Finance
Jump to
Setup
Install Monad MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/semutireng22/mcp-monad
Follow the installation instructions in the repository README, then restart your MCP client.
This project provides an MCP server for seamless interaction with the Monad testnet. It supports querying blockchain data (balances, transactions, gas prices, blocks) and interacting with the CoinflipGame smart contract for playing a coinflip game. The server integrates with Claude Desktop, allowing users to execute commands in natural language.
git clone https://github.com/Semutireng22/mcp-monad.git cd mcp-monad npm install
- Copy.env.example to.env and configure it
- Node.js (v16 or newer)
- npm or yarn
- Claude Desktop (for MCP Client integration)
- A Monad testnet wallet with sufficient MON for transactions and gas fees (required for play-coinflip, send-mon, and send-token)
- A.envfile configured with:PRIVATE_KEYfor the Monad testnet walletUniswap V2contract addresses (UNISWAP_ROUTER_ADDRESS,UNISWAP_FACTORY_ADDRESS) andWMONcontract address(WMON_ADDRESS)
In thesrc/index.tsfile, the server is initialized with the list of supported features:
const server = new McpServer({ name: "monad-testnet", version: "0.0.1", capabilities: [ "get-mon-balance", "get-token-balance", "get-transaction-details", "get-gas-price", "get-latest-block", "get-multiple-balances", "send-mon", "send-token", "play-coinflip", "get-coinflip-history", "stake-aprmon", "unstake-aprmon", "claim-aprmon", "get-aprmon-balance", "get-aprmon-rate", "get-aprmon-requests", "swap" ] });
To configure the server, copy the example environment file and edit it:
Edit the.envfile with a text editor (e.g.,nano,vim, orVS Code) to include the following:
PRIVATE_KEY=0xyourprivatekeyhere UNISWAP_ROUTER_ADDRESS=0xfb8e1c3b833f9e67a71c859a132cf783b645e436 UNISWAP_FACTORY_ADDRESS=0x733e88f248b742db6c14c0b1713af5ad7fdd59d0 WMON_ADDRESS=0x760AfE86e5de5fa0Ee542fc7B7B713e1c5425701
Replace0xyourprivatekeyherewith your Monad testnet wallet's private key (64 hexadecimal characters starting with0x).
Ensure the.envfile is secure and not committed to version control. Add it to.gitignore:
- Open Claude Desktop.
- Go toSettings > Developer.
- Editclaude_desktop_config.json(typically located in~/.config/Claude/or%APPDATA%\Claude\) and add the following configuration:
{ "mcpServers": { "monad-mcp": { "command": "node", "args": [ "/path/to/mcp-monad/build/index.js" ], "env": { "NODE_ENV": "production" } } } }
Replace/path/to/mcp-monad/with the actual path to your project directory (e.g.,E:\proyek\mcp-monadon Windows or/home/user/mcp-monadon Linux).
- Restart Claude Desktop.
- When prompted, allow MCP access for the chat session (Allow for This Chat).
- Fork the Project
- Create your Feature Branch (git checkout -b feature/AmazingFeature)
- Commit your Changes (git commit -m 'Add some AmazingFeature')
- Push to the Branch (git push origin feature/AmazingFeature)
- Open a Pull Request
Distributed under the MIT License. SeeLICENSEfor more information.
Project Link:https://github.com/Semutireng22/mcp-monad
- Ensure the CoinflipGame contract (0x664e248c39cd70Fa333E9b2544beEd6A7a2De09b) has sufficient funds in its pool to cover potential winnings forplay-coinflip. You can check this using a Monad testnet block explorer.
- For users on different systems, adjust the project path inclaude_desktop_config.jsonaccordingly.
- Server fails to start: Check logs in Claude Desktop (Settings > Developer) or terminal for errors like "File.envdoes not exist." Ensure.envis in the project root with a validPRIVATE_KEY.
- Insufficient contract funds: Verify the CoinflipGame contract balance using a block explorer. The contract owner can fund it via thefundGamePoolfunction.
- Claude commands not working: Ensureclaude_desktop_config.jsonhas the correct project path and restart Claude Desktop.
- TypeScript errors: Runnpx tscto check for errors. Update dependencies with:
git clone https://github.com/modelcontextprotocol/inspector cd inspector npm install npm start
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
MCP server for Klever blockchain smart contract development, on-chain data exploration, and VM interaction. Public remote server available at https://mcp.klever.org/mcp.
Read/write to over 2k blockchains, enabling data querying, contract analysis/deployment, and transaction execution, powered by Thirdweb.
A comprehensive toolkit for Ethereum blockchain analysis directly within Claude AI.
An MCP server that provides complete access to Ethereum Virtual Machine (EVM) JSON-RPC methods. Works with any EVM-compatible node provider including Infura, Alchemy, QuickNode, local nodes, and more.
Provides blockchain services for over 30 EVM-compatible networks through a unified interface.
A lightweight MCP server for Solidity development using the Foundry toolchain (Forge, Cast, and Anvil).
Interact with Ethereum-compatible smart contracts using their ABI.
An MCP server for Solana development providing basic RPC methods and helpful prompts.
An MCP server providing access to various Starknet RPC methods.
An MCP server for interacting with the Tatara blockchain ecosystem. Requires configuration for the Tatara RPC endpoint and a wallet private key.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.





