# Monad MCP Server

# Monad MCP Server

This project is a Node.js application that listens for new blocks on the Monad blockchain testnet.

---

📖 About

The Monad MCP Server is a lightweight blockchain listener that:

• Connects to Monad testnet via Alchemy's RPC endpoint
• Monitors new blocks in real-time
• Provides a simple REST API to query the latest block data
• Logs block numbers and transaction counts

---

Built with Node.js, it serves as both a blockchain monitor and API service for accessing basic chain information.

🚀 Features

• Connects to Monad Testnet via Alchemy RPC.
• Listens for new blocks in real-time.
• Logs block numbers and transaction counts.
• Serves a basic HTTP API with block information.

---

📦 Prerequisites

Make sure you have the following installed on your system:

• Node.js (v18 or higher)
• npm
• Git

---

⚙️ Setup Instructions

1. Clone this repository

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

2. Install dependencies

npm install

3. Create a .env file

Create a .env file in the root folder with the following content:

MONAD_RPC=https://monad-testnet.g.alchemy.com/v2/your-alchemy-key
PORT=3000

📝 Replace your-alchemy-key with your actual API key from Alchemy.

4. Start the server

npm start

5. Open in your browser

• Go to http://localhost:3000 → See the welcome message
• Go to http://localhost:3000/latestblock → Get latest block number and transaction count

🧪 Example Response from /latestblock

{
  "blockNumber": 123456,
  "transactionCount": 42
}

🛠 Notes

• The listener runs in real-time using provider.on('block').
• The /latestblock API returns the most recent block number and how many transactions it had.

👤 Author

GitHub: adekunlebamz

📝 License

MIT – Do whatever you want with it 🚀