br0ski777 avatar

NFT Floor Price & Rarity API

br0ski777/nft-floor-x402

Pulls NFT collection metrics from Reservoir's APIs across Ethereum and Base networks. You get floor prices, trading volume, holder counts, and rarity rankings through a straightforward MCP interface. Runs as a hosted service at nft-floor.api.klymax402.com with SSE transport, so no local setup required. The x402 designation suggests this is part of a paid API tier, likely requiring USDC payment for access. Reach for this when you need real-time NFT market data in your agent workflows without building your own Reservoir integration. The server exposes collection analytics that would otherwise require direct API calls and key management.

tools
2
transport
SSE
last updated
May 16, 2026

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

nft_get_collection_dataUse this when you need NFT collection floor price, volume, or holder data. Returns comprehensive collection stats from Reservoir for Ethereum and Base NFTs. 1. floorPrice: current floor price in ETH2 params

Use this when you need NFT collection floor price, volume, or holder data. Returns comprehensive collection stats from Reservoir for Ethereum and Base NFTs. 1. floorPrice: current floor price in ETH

Parameters* required
addressstring
NFT collection contract address. e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D (BAYC)
chainstring
Blockchain: ethereum or base. Default: ethereum
nft_get_token_rarityUse this when you need rarity data for a specific NFT token. Returns rarity rank, score, attributes, and trait-level floor prices for valuation. 1. rarityRank: token's rarity rank within the collecti3 params

Use this when you need rarity data for a specific NFT token. Returns rarity rank, score, attributes, and trait-level floor prices for valuation. 1. rarityRank: token's rarity rank within the collecti

Parameters* required
addressstring
NFT collection contract address
chainstring
Blockchain: ethereum or base. Default: ethereum
tokenIdstring
Token ID within the collection. e.g. 1234

Sponsors

Readme

NFT Floor Price & Rarity API

MCP Server x402 License: MIT

NFT collection floor price, volume, holders, rarity data. Ethereum and Base via Alchemy. Pay-per-call via x402 (USDC on Base L2) -- no API key, no signup, no rate-limit wall.

Part of the klymax402 marketplace -- 100 x402 micropayment APIs for AI agents, one wallet, USDC on Base.

Quickstart -- MCP

Add to your MCP client config (Claude Desktop, Cursor, ElizaOS, etc.):

{
  "mcpServers": {
    "nft-floor": {
      "url": "https://nft-floor.api.klymax402.com/mcp"
    }
  }
}

Quickstart -- HTTP (x402)

curl "https://nft-floor.api.klymax402.com/api/collection?address=0x0000000000000000000000000000000000dEaD"
# -> 402 Payment Required, with an x402 payment challenge in the response body

View the full README on GitHub

Details

Repository
github.com/br0ski777/nft-floor-x402
Website
github.com/Br0ski777/nft-floor-x402
Transport
SSE
Registry
MCP registry, active

More from br0ski777