What is Monad Mcp Magiceden

Monad MCP Magic Eden is a project that enables the creation of an MCP server to interact with various APIs for retrieving NFT-related data on the Monad testnet.

Use cases

Use cases include developing NFT portfolio management tools, analyzing market trends, and providing insights into NFT collections for users and developers.

How to use

To use Monad MCP Magic Eden, clone the repository, install dependencies using npm, add a Thirdweb client key, build the project, and configure the MCP server in Claude Desktop settings.

Key features

Key features include retrieving holder addresses for NFT contracts, calculating total NFT value held by an address, listing NFT collections owned by an address, and obtaining top-selling collections by sales and volume over various time frames.

Where to use

Monad MCP Magic Eden can be used in the NFT ecosystem, particularly for developers and analysts interested in tracking NFT ownership and market trends on the Monad testnet.

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

1. Clone this repository

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

2. Install dependencies:

npm install

3. 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";

4. Build the project

npm run build

The server is now ready to use!

Adding the MCP server to Claude Desktop

1. Open “Claude Desktop”

2. Open Settings

Claude > Settings > Developer

3. Open claude_desktop_config.json

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

5. Restart “Claude Desktop” and make sure it’s a hard restart

All the MCP tools may be availables

Here’s the final result

Using the MCP server for holders adress for an Nft collection

Using the MCP server for User Nft value

Using the MCP server for User Nft collection

Using the MCP server for getting the trendng NFT collection by volume

Using the MCP server for getting the trendng NFT collection by number of sales