Monad

This MCP server gives you programmatic access to Monad testnet data and interactions, including balances, transactions, gas prices, blocks, and gameplay with the CoinflipGame contract. It also integrates with Claude Desktop so you can drive actions with natural language commands. Use it to query, manage assets, stake, swap, and participate in coinflip games directly from your MCP-enabled client.

How to use

You interact with the Monad MCP Server through an MCP client. You can check balances, fetch transaction details, view the latest block, and perform actions like sending MON or tokens, playing coinflip, staking, unstaking, claiming rewards, and swapping tokens. Typical workflows include checking an address balance before a transfer, querying gas prices before a transaction, and reviewing coinflip history to track your results.

How to install

Prerequisites you need before installing: Node.js version 16 or newer, npm or yarn, Claude Desktop for MCP client integration, and a Monad testnet wallet with enough MON to cover transactions and gas fees.

Step-by-step commands to set up the server locally:

# Clone the MCP Monad project repository
git clone https://github.com/Semutireng22/mcp-monad.git
cd mcp-monad

# Install dependencies
npm install

# Create and configure environment file
cp .env.example .env

# Open and edit .env to include your private key and addresses
nano .env

# Build and run the server
npm run build
node build/index.js

Configuration and usage notes

Configure the MCP server to expose the supported features and run it in a production-like environment. The server is designed to work with Claude Desktop for natural language command execution and includes a ready-to-run setup for local development.

Claude Desktop integration enables you to start the MCP server from your desktop app with a specified path to the built index. See the example configuration below.

{
  "mcpServers": {
    "monad-mcp": {
      "command": "node",
      "args": [
        "/path/to/mcp-monad/build/index.js"
      ],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Security and maintenance

Keep your private key secure. Do not commit the .env file to version control. Use a strong wallet and consider rotating keys if needed. Regularly update dependencies and rebuild the server to incorporate security fixes and new features.

Troubleshooting

If the server fails to start, verify that the .env file exists at the project root and contains a valid PRIVATE_KEY. Check logs in Claude Desktop under Settings > Developer for runtime errors. If commands from Claude Desktop do not execute, ensure the claud_desktop_config.json path points to your built index and restart Claude Desktop.

TypeScript or dependency errors can be diagnosed with TypeScript tooling. Run npx tsc to check for type errors and npm install to refresh dependencies.

Available tools

get-mon-balance

Query the MON balance for a Monad testnet address to determine available funds.

get-token-balance

Query the balance of a specific ERC-20 token for an address using a token contract.

get-transaction-details

Retrieve detailed information about a transaction by its hash.

get-gas-price

Fetch the current gas price on the Monad testnet.

get-latest-block

Fetch information about the latest block on the Monad testnet.

get-multiple-balances

Check balances for multiple tokens for an address across multiple contracts.

send-mon

Send MON tokens from your wallet to another Monad testnet address.

send-token

Send ERC-20 tokens to a recipient from a token contract.

play-coinflip

Place a MON bet on Heads or Tails in the CoinflipGame and participate in the game.

get-coinflip-history

View the history of coinflip games for an address, including wins and losses.

stake-aprmon

Stake MON tokens in the Apriori staking platform.

unstake-aprmon

Unstake MON tokens from Apriori and prepare to claim rewards.

claim-aprmon

Claim pending unstaked MON tokens after the required waiting period.

swap

Perform a token swap on the integrated Uniswap V2 swap feature for the Monad Testnet.