Monad MCP
The Monad MCP server allows you to interact with the Monad testnet to query account information:
Check MON token balance: Query the MON token balance for a specific address using the
get-mon-balancetool (requiresaddressparameter)Query NFT holdings: Retrieve the number of NFTs held by an address for a given NFT contract using the
get-nft-counttool (requiresaddressandnftContractparameters)
Enables querying Monad testnet for token balances and NFT holdings, allowing users to check MON balances for specific addresses and count NFTs held by an address in a specified contract.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Monad MCP check MON balance for 0x742d35Cc6634C0532925a3b844Bc9e90F1f04ee1"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Monad MCP Tutorial
This project demonstrates how to create a MCP server that interacts with the Monad testnet. The MCP server provides a tool for checking MON token balances on the Monad testnet.
What is MCP?
The Model Context Protocol (MCP) is a standard that allows AI models to interact with external tools and services.
In this tutorial, we're creating an MCP server that allows MCP Client (Claude Desktop) to query Monad testnet to check MON balance of an account.
Related MCP server: KaiaFun MCP
Prerequisites
Node.js (v16 or later)
npmoryarnClaude Desktop
Getting Started
Clone this repository
git clone https://github.com/bble/monad-mcp.gitInstall dependencies:
npm installBuilding the MCP server
Monad Testnet related configuration is already added to index.ts in the src folder.
Define the server instance
// Create a new MCP server instance
const server = new McpServer({
name: "monad-testnet",
version: "0.0.1",
// Array of supported tool names that clients can call
capabilities: ["get-mon-balance"]
});Defining the MON balance tool
server.tool(
// Tool ID
"get-mon-balance",
// Description of what the tool does
"Get MON balance for an address on Monad testnet",
// Input schema
{
address: z.string().describe("Monad testnet address to check balance for"),
},
// Tool implementation
async ({ address }) => {
try {
// Check MON balance for the input address
const balance = await publicClient.getBalance({
address: address as `0x${string}`,
});
// Return a human friendly message indicating the balance.
return {
content: [
{
type: "text",
text: `Balance for ${address}: ${formatUnits(balance, 18)} MON`,
},
],
};
} catch (error) {
// If the balance check process fails, return a graceful message back to the MCP client indicating a failure.
return {
content: [
{
type: "text",
text: `Failed to retrieve balance for address: ${address}. Error: ${
error instanceof Error ? error.message : String(error)
}`,
},
],
};
}
}
);Add functionality to query NFT count
### Add functionality to query NFT count
server.tool(
// Function identifier
"get-nft-count",
// Function description
"Query the number of NFTs held by an address on the Monad testnet",
// Parameter definition
{
address: z.string().describe("The Monad testnet address to query"),
nftContract: z.string().describe("NFT contract address")
},
// Function implementation
async ({ address, nftContract }) => {
try {
// Call the contract's balanceOf method to get the NFT count
const balance = await publicClient.readContract({
address: nftContract as `0x${string}`,
abi: [
{
inputs: [{ name: "owner", type: "address" }],
name: "balanceOf",
outputs: [{ name: "", type: "uint256" }],
stateMutability: "view",
type: "function"
}
],
functionName: "balanceOf",
args: [address as `0x${string}`]
});
// Return the formatted query result
return {
content: [
{
type: "text",
text: `The address ${address} holds ${balance.toString()} NFTs in contract ${nftContract}.`,
},
],
};
} catch (error) {
// Error handling
return {
content: [
{
type: "text",
text: `Failed to query NFT count for address ${address}: ${
error instanceof Error ? error.message : String(error)
}`,
},
],
};
}
}
);Initialize the transport and server from the main function
async function main() {
// Create a transport layer using standard input/output
const transport = new StdioServerTransport();
// Connect the server to the transport
await server.connect(transport);
console.error("Monad testnet MCP Server running on stdio");
}Build the project
npm run buildThe server is now ready to use!
Adding the MCP server to Claude Desktop
Open "Claude Desktop"

Open Settings
Claude > Settings > Developer

Open
claude_desktop_config.json

Add details about the MCP server and save the file.
{
"mcpServers": {
...
"monad-mcp": {
"command": "node",
"args": [
"/<path-to-project>/build/index.js"
]
}
}
}Restart "Claude Desktop"
Using the MCP server
Here's the final result

Further Resources
Available Tools
2 toolsget-mon-balanceB
查询 Monad 测试网地址的 MON 代币余额
Inputs: address (required).
get-nft-countC
查询 Monad 测试网地址持有的 NFT 数量
Inputs: address (required), nftContract (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: one queries token balances, while the other queries NFT counts. There is no overlap in functionality, and an agent can easily differentiate between them based on their clear, specific descriptions.
Both tools follow a consistent verb_noun pattern with 'get' as the verb and hyphen-separated nouns ('mon-balance', 'nft-count'). The naming is uniform and predictable across the set.
With only two tools, the server feels thin for a blockchain domain like Monad, which typically involves more operations such as transaction queries, contract interactions, or token transfers. The scope is too limited for practical agent workflows.
The toolset is severely incomplete for a blockchain server; it lacks essential operations like sending transactions, checking transaction status, querying contract data, or interacting with tokens beyond balances. This will cause significant agent failures in handling typical blockchain tasks.
Maintenance
Related MCP Connectors
MCP server connecting AI agents to non-custodial staking data across 130+ networks.
MCP server for Klever blockchain smart contract development.
Tenzro Network MCP server: wallet, identity, payments, inference, staking, bridges, verification.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn MCP server that connects Claude for Desktop with blockchain functionality, allowing users to check balances and send tokens on EVM and Solana chains through natural language interactions.MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables token listing, trading, and interaction with the Kaia blockchain via Claude Desktop.1Apache 2.0
- AlicenseAqualityDmaintenanceA Model Context Protocol server that enables AI models to interact with the Monad testnet for checking token balances, sending transactions, and deploying smart contracts.7Apache 2.0
- -licenseNot gradedqualityNot gradedmaintenanceAn MCP server that allows Claude Desktop to query Monad testnet for MON token balances of accounts.-