Monad MCP Magic Eden

Provides local MCP endpoints to query NFT holders, values, ownership, and top-selling collections on the Monad testnet.

javascript

1

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "sifu213-monad-mcp-magiceden": {
      "command": "node",
      "args": [
        "*absolutepath*\\\\dist\\\\top-selling-collections.js"
      ]
    }
  }
}

This MCP server for Monad on the Magic Eden testnet lets you query NFT data across multiple APIs. It provides tools to inspect NFT holders, compute value, list collections an address holds, and surface top collections by sales or volume over various timeframes. Use it with an MCP client to automate data retrieval and build dashboards or automations around NFT activity.

How to use

You interact with the MCP server through an MCP client. Each tool exposes a clear action you can run to get NFT data such as holders for a contract, an address’s NFT value, the collections owned by an address, or trending collections by sales or volume over chosen timeframes.

How to install

Follow these steps to set up the MCP server locally and integrate it with your MCP client.

# Prerequisites
node --version
npm --version
# Ensure Node.js v16+ and npm are installed

# 1) Clone the repository
git clone https://github.com/Sifu213/monad-mcp-magiceden.git

# 2) Install dependencies
npm install

# 3) Add your Thirdweb client key for NFT owners data
# Open nft-owners.ts and set your key on the line below
# const THIRDWEB_CLIENT_ID = "yourclientkey";

# 4) 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"]
        }
    }
}

Restart Claude Desktop with a hard restart to apply the new MCP servers.

## Additional notes

All MCP tools become available after the server is started. Ensure you point to the built JavaScript entry points using absolute paths in the config. There are no additional environment variables shown, so no extra configuration is required beyond providing the paths and keeping dependencies installed.

## Available tools

### Determine NFT holders

Retrieve the list of holder addresses for a specific NFT contract to understand ownership distribution.

### Calculate NFT value

Compute the total NFT value held by an address using current floor prices, helpful for quick portfolio assessments.

### List user collections

List all NFT collections owned by a given address to analyze holdings.

### Top selling by sales

Get the top-selling NFT collections by number of sales over multiple time windows (5 min, 10 min, 30 min, 1 h, 6 h, 24 h, 1 d, 7 d, 30 d).

### Top selling by volume

Get the top-selling NFT collections by trading volume over multiple time windows (5 min, 10 min, 30 min, 1 h, 6 h, 24 h, 1 d, 7 d, 30 d).