monad-mcp-server

git clone https://github.com/veenoway/monad-mcp-server.git
cd monad-mcp-server

npm install
# or
yarn install

cp .env.example .env
# Edit the .env file with your configurations

PINATA_JWT=PINATA_JWT
OPENAI_API_KEY=OPENIA_KEY
PRIVATE_KEY=YOUR_PRIVATE_KEY
NFT_FACTORY_ADDRESS=NFT_FACTORY_ADDRESS=

{
  "mcpServers": {
    "generate-image-mint-nft": {
      "command": "node",
      "args": ["/path/to/build/generate-image.js"]
    },
    "deploy-solidity": {
      "command": "node",
      "args": ["/path/to/build/deploy-solidity.js"]
    },
    "swap": {
      "command": "node",
      "args": ["/path/to/build/swap.js"]
    },
    "monad-faucet": {
      "command": "node",
      "args": ["/path/to/build/faucet.js"]
    },
    "analyse-smart-contract": {
      "command": "node",
      "args": ["/path/to/build/analyse-smart-contract.js"]
    },
    "user-portfolio": {
      "command": "node",
      "args": ["/path/to/build/portfolio.js"]
    },
    "nft-top-holders": {
      "command": "node",
      "args": ["/path/to/build/nft-holder.js"]
    },
    "monad-ai-trader": {
      "command": "node",
      "args": ["/path/to/build/ai-agent.js"]
    },
    "defi-challenges": {
      "command": "node",
      "args": ["/path/to/build/defi-challenge.js"]
    },
    "monad-staking": {
      "command": "node",
      "args": ["/path/to/build/staking.js"]
    },
    "send-token": {
      "command": "node",
      "args": ["/path/to/build/send-token.js"]
    }
  }
}

npm run dev
# or
yarn dev

npm run build
npm start
# or
yarn build
yarn start

{
  "tool": "monad-faucet",
  "parameters": {
    "walletAddress": "0xYourWalletAddress"
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "✅ 0.2 MON successfully sent to 0xYourWalletAddress\nTransaction: 0xTransactionHash\nSent from: 0xFaucetAddress"
    }
  ]
}

{
  "tool": "deploy-solidity",
  "parameters": {
    "privateKey": "0xYourPrivateKey",
    "sourceCode": "// Your Solidity contract code here",
    "constructorArgs": ["arg1", "arg2"]
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Contract deployed and verified successfully!

Contract address: 0xContractAddress
Transaction hash: 0xTransactionHash
Block: 123456
Gas used: 123456

Your contract is deployed and verified on Monad testnet.
You can view your verified contract here: https://testnet.monadexplorer.com/address/0xContractAddress

Deployment arguments used:
- Argument 1: 1000000"
    }
  ]
}

{
  "tool": "image-nft-generation",
  "parameters": {
    "prompt": "Description of the image to generate",
    "userAddress": "0xYourWalletAddress"
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "✅ Image generated and minted as NFT for **0xYourWalletAddress**!

- **Prompt**: \"Your image description\"
- **IPFS Image**: [View image](https://gateway.pinata.cloud/ipfs/YourImageHash)
- **Token URI**: ipfs://YourMetadataHash
- **Transaction**: [View on Monad Explorer](https://testnet.monadexplorer.com/tx/YourTransactionHash)"
    }
  ]
}

{
  "tool": "swap",
  "parameters": {
    "privateKey": "0xYourPrivateKey",
    "routerType": "uniswap", // or "sushiswap"
    "tokenInAddress": "0xTokenInAddress", // Optional for native MON swaps
    "tokenOutAddress": "0xTokenOutAddress",
    "amountIn": "1.0", // Amount in full units
    "slippagePercentage": 0.5, // Optional, default 0.5%
    "deadline": 1234567890, // Optional, Unix timestamp
    "useNativeMON": false, // Optional, default false
    "checkLiquidityOnly": false // Optional, default false
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Token swap successful!

From: 1.0 MON
To: 100.0 TCHOG (estimated)

Transaction: 0xTransactionHash
Block: 123456
DEX used: uniswap
Swap path: MON -> Token(0x1234...5678)

You can view your transaction here:
https://testnet.monadexplorer.com/tx/0xTransactionHash"
    }
  ]
}

{
  "content": [
    {
      "type": "text",
      "text": "Liquidity check for pools on uniswap:

Direct pool MON -> TCHOG: Exists
Liquidity: 1000 MON <-> 100000 TCHOG
Pool address: 0xPoolAddress

Recommended path: Direct

Popular tokens available on uniswap:
1. TCHOG (0xTokenAddress)
2. WMON (0xTokenAddress)

If you want to create liquidity, you'll need to add tokens to the pools via the DEX interface."
    }
  ]
}

{
  "tool": "monad-ai-trader",
  "parameters": {
    "privateKey": "0xYourPrivateKey",
    "initialInvestment": 0.1, // Optional, default 0.1 MON
    "riskLevel": "moderate", // Optional, "conservative" | "moderate" | "aggressive"
    "learningRate": 0.1, // Optional, default 0.1
    "maxSlippage": 1.5, // Optional, default 1.5%
    "action": "create" // "create" | "start" | "stop" | "status" | "improve"
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "🤖 AUTONOMOUS AI TRADING AGENT CREATED

ID: ai-trader-123456
Address: 0xAgentAddress
Balance: 0.5 MON
Status: active
Risk Level: MODERATE

✅ AI Agent created successfully
Initial capital: 0.5 MON
✅ Initial purchase: 0.25 WMON → TCHOG
Hash: 0xTransactionHash

To start the agent: monad-ai-trader-autonomous --action=start --privateKey=0x123..."
    }
  ]
}

{
  "content": [
    {
      "type": "text",
      "text": "🤖 AUTONOMOUS AI TRADING AGENT STARTED

ID: ai-trader-123456
Address: 0xAgentAddress
Balance: 0.45 MON
Status: active
Risk Level: MODERATE

✅ Transaction executed: BUY 10 TCHOG
Confidence: 75.50%
Hash: 0xTransactionHash"
    }
  ]
}

{
  "content": [
    {
      "type": "text",
      "text": "🤖 AUTONOMOUS AI TRADING AGENT STATUS

ID: ai-trader-123456
Address: 0xAgentAddress
Balance: 0.45 MON
Status: active
Risk Level: MODERATE

📊 AI AGENT STATUS
Total transactions: 5
Learning rate: 0.1
Exploration rate: 0.200
Last improvement: 2024-03-20T12:00:00Z

STRATEGY PARAMETERS:
- Position size: 25.00%
- Entry threshold: 0.60
- Stop loss: 10.00%
- Take profit: 15.00%"
    }
  ]
}

{
  "content": [
    {
      "type": "text",
      "text": "❌ Error executing autonomous AI agent: [Detailed error message]

Suggestions:
1. Verify that your private key is correct
2. Ensure you have sufficient MON for the initial investment
3. Verify that the agent exists if you're using an action other than 'create'
4. If the agent is already active, use 'status' to check its state"
    }
  ]
}

{
  "tool": "analyze-smart-contract",
  "parameters": {
    "contractAddress": "0xContractAddress",
    "startBlock": 1000000, // Optional
    "privateKey": "0xYourPrivateKey", // Optional, required for simulation
    "simulateLoad": false, // Optional, default false
    "traceFunctions": true, // Optional, default true
    "visualizeActivity": true, // Optional, default true
    "gasAnalysis": true, // Optional, default true
    "securityScan": true, // Optional, default true
    "monitorDuration": 10 // Optional, monitoring duration in blocks
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "## Smart Contract Analysis Report

**Contract Address**: 0xContractAddress
**Code Size**: 12345 bytes
**Balance**: 1.5 MON
**Transaction Count**: 1000
**Detected Standards**: ERC20, OpenZeppelin

### Contract Functions
1. `transfer(address,uint256)`
2. `approve(address,uint256)`
3. `balanceOf(address)`

### Activity Analysis
**Total Transactions**: 1000
**Unique Callers**: 50
**Average Gas Used**: 45000

**Temporal Distribution**:
- Last 24h: 100 transactions
- Last Week: 500 transactions
- Last Month: 1000 transactions

### Gas Analysis
**Total Gas Used**: 45000000
**Average Gas per Call**: 45000
**Estimated Cost**: 0.045 MON
**Gas Efficiency**: Good

### Security Analysis
**Security Score**: 85/100
**Risk Level**: Low

**Security Recommendations**:
1. Implement reentrancy protection
2. Use SafeMath for arithmetic operations
3. Add appropriate access controls"
    }
  ]
}

{
  "content": [
    {
      "type": "text",
      "text": "## Load Simulation Results

**Sent Transactions**: 100
**Success Rate**: 95%
**Average Gas Used**: 45000

**Performance Metrics**:
- Transactions per Second: 10.5
- Average Confirmation Time: 2.5 seconds
- Average Gas Price: 1.2 gwei"
    }
  ]
}

{
  "content": [
    {
      "type": "text",
      "text": "❌ Error analyzing contract: [Detailed error message]

Suggestions:
1. Verify that the contract address is correct
2. Ensure the contract exists on Monad Testnet
3. Verify your private key is correct if performing simulation
4. If the contract is a proxy, ensure you're using the implementation address"
    }
  ]
}

{
  "tool": "nft-top-holders",
  "parameters": {
    "contractAddress": "0xContractAddress",
    "tokenId": "123", // Optional
    "standard": "ERC721", // "ERC721" | "ERC1155"
    "limit": 100 // Optional, default 100
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "NFT Holders for Monad Collection (MON) at address 0xContractAddress:

1. 0xHolder1: 5 token(s) - IDs: [1, 2, 3, 4, 5]
2. 0xHolder2: 3 token(s) - IDs: [6, 7, 8]
3. 0xHolder3: 1 token(s) - IDs: [9]"
    }
  ],
  "contractAddress": "0xContractAddress",
  "standard": "ERC721",
  "name": "Monad Collection",
  "symbol": "MON",
  "tokenId": "all",
  "holderCount": 3,
  "holders": [
    {
      "address": "0xHolder1",
      "tokens": [1, 2, 3, 4, 5],
      "tokenCount": 5
    },
    {
      "address": "0xHolder2",
      "tokens": [6, 7, 8],
      "tokenCount": 3
    },
    {
      "address": "0xHolder3",
      "tokens": [9],
      "tokenCount": 1
    }
  ]
}

{
  "content": [
    {
      "type": "text",
      "text": "❌ Error retrieving NFT holders: [Detailed error message]

Suggestions:
1. Verify that the contract address is correct
2. Ensure the contract implements the specified NFT standard
3. For ERC1155 contracts, you must specify a tokenId
4. Verify that the contract exists on Monad Testnet"
    }
  ]
}

{
  "tool": "portfolio",
  "parameters": {
    "address": "0xWalletAddress",
    "includeErc20": true, // Optional, default true
    "includeNfts": true, // Optional, default true
    "includeLiquidityPositions": true, // Optional, default true
    "includeTransactionHistory": true, // Optional, default true
    "transactionLimit": 10, // Optional, default 10
    "erc20TokensLimit": 50, // Optional, default 50
    "nftsLimit": 20 // Optional, default 20
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Portfolio analysis for address 0xWalletAddress"
    },
    {
      "type": "text",
      "text": {
        "nativeBalance": "1.5 MON",
        "erc20Tokens": [
          {
            "address": "0xToken1",
            "name": "Token One",
            "symbol": "TKN1",
            "balance": "100.0"
          },
          {
            "address": "0xToken2",
            "name": "Token Two",
            "symbol": "TKN2",
            "balance": "50.0"
          }
        ],
        "nfts": {
          "erc721": [
            {
              "contractAddress": "0xNFT1",
              "collectionName": "Monad Collection",
              "symbol": "MON",
              "tokenId": "1",
              "tokenURI": "ipfs://..."
            }
          ],
          "erc1155": [
            {
              "contractAddress": "0xNFT2",
              "tokenId": "2",
              "balance": "5",
              "uri": "ipfs://..."
            }
          ]
        },
        "liquidityPositions": [
          {
            "pairAddress": "0xPair1",
            "token0": {
              "address": "0xToken1",
              "symbol": "TKN1",
              "amount": "10.0"
            },
            "token1": {
              "address": "0xToken2",
              "symbol": "TKN2",
              "amount": "20.0"
            },
            "lpBalance": "15.0",
            "shareOfPool": "0.5%"
          }
        ],
        "transactions": [
          {
            "hash": "0xTx1",
            "from": "0xWalletAddress",
            "to": "0xRecipient",
            "value": "0.1 MON",
            "timestamp": "2024-03-20T12:00:00Z",
            "status": "Success",
            "gasUsed": "21000"
          }
        ]
      }
    }
  ]
}

{
  "content": [
    {
      "type": "text",
      "text": "❌ Error analyzing portfolio: [Detailed error message]

Suggestions:
1. Verify that the wallet address is correct
2. Ensure the address exists on Monad Testnet
3. Verify that the limit parameters are valid
4. If the error persists, try analyzing specific portfolio sections"
    }
  ]
}

{
  "tool": "defi-challenges",
  "parameters": {
    "privateKey": "0xYourPrivateKey",
    "challengeType": "yield-farming",
    "duration": "weekly",
    "publicUsername": "optional_username",
    "initialInvestment": "1.0",
    "riskLevel": "medium",
    "joinPool": true,
    "teamName": "optional_team_name",
    "specificStrategies": ["strategy1", "strategy2"],
    "autoRebalance": true,
    "notificationsEnabled": true
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "Challenge details and results"
    }
  ],
  "challengeSummary": {
    "challengeId": "unique_id",
    "participant": {
      "username": "user_name",
      "wallet": "wallet_address",
      "team": "team_name"
    },
    "challenge": {
      "type": "challenge_type",
      "duration": "challenge_duration",
      "riskLevel": "risk_level",
      "startedAt": "timestamp",
      "endsAt": "timestamp",
      "initialInvestment": "amount",
      "joinedRewardsPool": true,
      "entryFee": "fee_amount",
      "autoRebalancing": true
    },
    "strategy": {
      "selectedStrategies": ["strategy1", "strategy2"],
      "initialAllocation": [
        {
          "asset": "asset_name",
          "percentage": 50,
          "amount": "amount"
        }
      ],
      "projectedAPY": "percentage",
      "projectedROI": "percentage"
    },
    "ranking": {
      "currentParticipants": 100,
      "yourEstimatedRank": 25,
      "topPerformers": [
        {
          "rank": 1,
          "username": "top_user",
          "performance": 15.5,
          "strategy": "winning_strategy"
        }
      ]
    },
    "rewards": {
      "totalPoolSize": "pool_size",
      "estimatedRewards": "reward_amount",
      "rewardsBreakdown": [
        {
          "position": "1st Place",
          "amount": "reward_amount",
          "chance": "percentage"
        }
      ]
    }
  }
}

{
  "tool": "monad-staking",
  "parameters": {
    "privateKey": "0xYourPrivateKey",
    "amount": "0.2"
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "✅ 0.2 MON successfully staked from 0xYourWalletAddress\nTransaction: 0xTransactionHash\nBalance after: 0.2 aprMON"
    }
  ]
}

{
  "tool": "monad-unstaking",
  "parameters": {
    "privateKey": "0xYourPrivateKey",
    "amount": "0.2"
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "✅ 0.2 aprMON successfully unstaked from 0xYourWalletAddress\nTransaction: 0xTransactionHash\nBalance after: 0.2 MON"
    }
  ]
}

{
  "tool": "send-token",
  "parameters": {
    "privateKey": "0xYourPrivateKey",
    "toAddress": "0xRecipientAddress",
    "amount": "0.2",
    "tokenAddress": "0xTokenAddress" // Optional, defaults to native MON
  }
}

{
  "content": [
    {
      "type": "text",
      "text": "✅ 0.2 MON successfully sent to 0xRecipientAddress\nTransaction: 0xTransactionHash\nGas used: 21000"
    }
  ]
}