Monad-MCP-Server
If you are the rightful owner of Monad-MCP-Server 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.
MCP (Monad Control Panel) server provides detailed information about wallets in the Monad Testnet network, allowing easy retrieval of data about balances and tokens via API.
๐ Monad MCP Server
MCP (Monad Control Panel) server for providing detailed information about wallets in the Monad Testnet network. This project allows you to easily retrieve data about balances and tokens via API.
๐ Features
The server provides access to the following information:
- ๐ฐ Native token balance (MONAD)
- ๐ช ERC-20 token balances
- ๐ General wallet information
- โ ๏ธ Token error analysis
๐ ๏ธ Technologies
- Node.js - Server platform
- Express - Web framework
- ethers.js - Blockchain interaction library
- Monad Testnet - Monad test network
โ๏ธ Installation and Running
Prerequisites
- Node.js v16 or newer
- npm or yarn
- Internet access for connecting to Monad Testnet
Installation Steps
# Clone the repository
git clone https://github.com/LOFT228/Monad-MCP-Server.git
cd Monad-MCP-Server
# Install dependencies
npm install
# Start the server
npm start
For development with auto-reload:
npm run dev
๐ API Endpoints
Home Page
GET /
Returns general information about the server and available endpoints.
Wallet Information
GET /wallet/:address
Returns complete information about the wallet, including the native token balance and all known ERC-20 tokens.
Native Token Balance
GET /wallet/:address/balance
Returns only the native token balance (MONAD).
Specific Token Balance
GET /wallet/:address/token/:tokenAddress
Returns information about a specific ERC-20 token in the specified wallet.
๐ Example Response
{
"address": "0x418bF6023b30c53072bcDcc653d6e14C20ba569F",
"nativeBalance": {
"symbol": "MONAD",
"name": "Monad",
"balance": "0.121916140766047236",
"rawBalance": "121916140766047236",
"decimals": 18
},
"tokens": [
// List of ERC-20 tokens if they exist in the wallet
],
"tokenErrors": [
// Information about errors when trying to retrieve token data
]
}
โ๏ธ Configuration
Server settings are located in the config.js file. There you can change:
- Server port
- RPC URL for connecting to Monad Testnet
- List of known tokens
module.exports = {
PORT: 8080,
MONAD_RPC_URL: 'https://testnet-rpc.monad.xyz/',
TOKENS: {
// Add real token contracts here
'TOKEN_NAME': 'TOKEN_CONTRACT_ADDRESS'
}
};
๐ Project Structure
mcp-monad/
โโโ config.js # Project configuration
โโโ index.js # Main server file
โโโ package.json # Dependencies and scripts
โโโ utils/ # Utilities
โ โโโ blockchain.js # Functions for working with blockchain
โโโ routes/ # API routes
โโโ wallet.js # Routes for wallet operations
๐ฎ Future Improvements
- Add NFT token support
- Implement request caching for improved performance
- Create a web interface for displaying information
- Add functionality for wallet transaction analysis
- Implement notifications for wallet changes
๐ค Contributing
Contributions to the project are always welcome! If you have ideas for improvements:
- Fork the project
- Create a branch for your feature (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push the changes (
git push origin feature/amazing-feature) - Open a Pull Request
๐ License
This project is distributed under the ISC license. See the LICENSE file for more information.
๐ฌ Contact
LOFT228 - @github
Project link: https://github.com/LOFT228/Monad-MCP-Server
Created with โค๏ธ for the Monad community
