Monad MCP Magic Eden

This project allows you to create an MCP server that interacts with various APIs to retrieve NFT-related data on the Monad testnet. The MCP server provides several tools:

Retrieve the list of holder addresses for an NFT contract -Calculate the total NFT value held by an address using floor prices
List all NFT collections that an address holds
Get the top-selling collections by number of sales (5 min, 10 min, 30 min, 1 h, 6 h, 24 h, 1 d, 7 d, 30 d)
Get the top-selling collections by volume (5 min, 10 min, 30 min, 1 h, 6 h, 24 h, 1 d, 7 d, 30 d)

Prerequisites

Node.js (v16 or later)
npm
Claude Desktop

Getting Started

Clone this repository

git clone https://github.com/Sifu213/monad-mcp-magiceden.git

Install dependencies:

npm install

Add a Thirdweb client key :

Get an Thirdweb client key to be able to use the list of holders for a NFT collection by creating a project and make the origin allowance to *. Add you api client key in the nft-owners.ts file on line :

const THIRDWEB_CLIENT_ID = "yourclientkey";

Build the project

npm run build

The 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. Use your machine absolute path to the js files resulting from the build

{
    "mcpServers": {
		"top-selling-collections": {
            "command": "node",
            "args": ["*absolutepath*\\dist\\top-selling-collections.js"]
        },
		"top-volume-collections": {
            "command": "node",
            "args": ["*absolutepath*\\dist\\top-volume-collections.js"]
        },
        "collections": {
            "command": "node",
            "args": ["*absolutepath*\\dist\\user-collection.js"]
        },
        "totalValue": {
            "command": "node",
            "args": ["*absolutepath*\\dist\\user-nft-value.js"]
        },
		"nft-owners": {
            "command": "node",
            "args": ["*absolutepath*\\dist\\nft-owners.js"]
        }
    }
}