magma-mcp

magma-mcp

3.1

If you are the rightful owner of magma-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

Monad Magma MCP is a protocol server designed for staking and withdrawing MON tokens using the Model Context Protocol (MCP).

Monad Magma MCP

Features

  • Stake MON: Stake MON tokens to receive gMON.
  • Withdraw MON: Burn gMON to withdraw MON.

Prerequisites

  • Node.js (18.x or later)
  • Git
  • Monad Testnet wallet with MON tokens
  • MCP-compatible client (e.g., Claude)

Setup Commands

Clone Repository

git clone https://github.com/0xjaywins/magma-mcp.git
cd monad-mcp-staking

Install Dependencies

npm install
npm install --save-dev @types/node

Configure .env

  1. Create .env:
    code .env
    
  2. Add:
    PRIVATE_KEY=0xYourPrivateKey
    
    Replace 0xYourPrivateKey with your Monad Testnet private key.
  3. Update src/index.ts with .env path (e.g., /home/yourusername/monad-mcp-staking/.env for Unix, C:\Users\windows\Desktop\monad-mcp-staking\.env for Windows).

Build Project

npm run build

Run Script

node dist/index.js

Windows Setup Tips

  • Use Windows paths (e.g., C:\Program Files\nodejs\node.exe, C:\Users\lenovo\Desktop\magma-mcp\dist\index.js).
  • Claude config for Windows:
    {
      "mcpServers": {
        "monad-mcp": {
          "command": "C:\\Program Files\\nodejs\\node.exe",
          "args": ["C:\\Users\\lenovo\\Desktop\\magma-mcp\\dist\\index.js"]
        }
      }
    }
    

Testing with MCP Inspector

  1. Install:
    npm install @modelcontextprotocol/inspector@0.10.2
    
  2. Get paths:
    which node  # /home/yourUsername/.nvm/versions/node/v23.11.0/bin/node
    pwd  # /home/yourUsername/monad-mcp-staking
    
    Windows: Use C:\Program Files\nodejs\node.exe, C:\Users\lenovo\Desktop\monad-mcp-staking\dist\index.js.
  3. Run:
    npx @modelcontextprotocol/inspector /home/yourUsername/.nvm/versions/node/v23.11.0/bin/node /home/yourUsername/monad-mcp-staking/dist/index.js
    

Configuring Claude

  • Use paths from above.
  • Example claude.json:
    {
      "mcpServers": {
        "monad-mcp": {
          "command": "node",
          "args": ["/home/yourUsername/.nvm/versions/node/v23.11.0/bin/node", "/home/yourUsername/monad-mcp-staking/dist/index.js"]
        }
      }
    }
    

Expected Output

  • Successful Stake:
    Successfully staked 0.2 MON on Magma.
    gMON minted: 0.2 gMON
    Your gMON balance: 0.2 gMON
    Transaction: 0x...
    Explorer: https://testnet.monadexplorer.com/tx/0x...
    
  • MCP Inspector: Displays tool status and transaction logs.
  • Claude: Shows JSON responses with transaction details.

Troubleshooting

  • Invalid .env: Ensure PRIVATE_KEY is correct.
  • Insufficient Funds: Fund wallet with MON/gMON on Monad Testnet.
  • Network Error: Verify RPC (https://testnet-rpc.monad.xyz).
  • Path Issues: Update paths in src/index.ts and Claude config.