NFT Analytics

An MCP server that delivers NFT collection analytics powered by data from Dune Analytics.

python

1

GitHub Stars

python

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": {
    "kukapay-nft-analytics-mcp": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/nft-analytics-mcp",
        "run",
        "main.py"
      ],
      "env": {
        "DUNE_API_KEY": "DUNE_API_KEY_PLACEHOLDER"
      }
    }
  }
}

NFT Analytics MCP delivers NFT collection analytics powered by data from Dune Analytics. It provides formatted markdown tables for daily volumes, sales, average prices, and ownership activity across top Ethereum NFT collections, helping you monitor market trends quickly within an MCP client.

How to use

You access this MCP server through your MCP client and call the available tools to fetch analytics data. Each tool returns results as a readable Markdown table (except for the new-owners count, which is a plain number). Use the tools to answer specific questions like which NFT collections have the highest daily trading volume, how many daily sales occurred per collection, and what the current average selling prices look like.

How to install

Prerequisites: Python 3.10+, uv (recommended package manager), and a valid Dune Analytics API key.

# 1. Clone the repository and enter the project directory
git clone https://github.com/kukapay/nft-analytics-mcp.git
cd nft-analytics-mcp

# 2. Install dependencies (use uv as your MCP runtime)
uv sync

# 3. Install as an MCP on Claude Desktop
uv run mcp install main.py --name "NFT Analytics"

# Configuration example (reference)
{
  "mcpServers": {
    "NFT Analytics": {
      "command": "uv",
      "args": [ "--directory", "/path/to/nft-analytics-mcp", "run", "main.py" ],
      "env": { "DUNE_API_KEY": "dune_api_key" }
    }
  }
}

Notes and configuration

Configuration is provided so you can register the NFT Analytics MCP with your client. Replace "/path/to/nft-analytics-mcp" with your actual installation path and set your Dune Analytics API key in the env block.

Available tools

get_daily_trading_volume_by_collection

Retrieves daily trading volume for top Ethereum NFT collections and returns the data in a Markdown-formatted table.

get_daily_sales_by_collection

Fetches the number of daily sales per NFT collection and presents it as a Markdown table.

get_average_price_by_collection

Gets the average selling price for each NFT collection and formats the results as a Markdown table.

get_unique_traders_by_collection

Tracks unique buyers and sellers by collection and outputs a Markdown table.

get_new_owners

Returns the count of new NFT wallet owners as a plain number.