• DATA
  • RANKING
  • ANALYSIS
  • HUMAN

How to analyze NFT portfolio rarity with your AI

Connect Reservoir to your AI client to turn a raw wallet address into a sorted list of high-value assets.

Ask AI about this page

Short answer

How can I check my NFT rarity using AI?

Your AI uses Reservoir to pull every token from a specific wallet and then sorts them by their rarity score. You get a ranked list of your most unique assets immediately. This breakdown shows how the data flows from the blockchain to your chat window.

Your rarity insights.

Where your data lands.

Once connected, your AI organizes your collection into these specific views.

DATA

Token inventory

The AI pulls a full list of every NFT held in the target wallet. You see exactly what is in the collection.

RANKING

Rarity sorting

The AI compares the traits of each token against the collection average. It organizes the list from rarest to most common.

ANALYSIS

Trait breakdown

Your agent identifies which specific traits are driving the high rarity scores. This helps you understand why a piece is valuable.

HUMAN

Manual review

You decide which assets to move or sell based on the AI's findings. The AI provides the data, but you make the final call.

The workflow

What your AI does when the address is provided.

The AI handles the heavy lifting of querying the blockchain and calculating scores.

  1. Fetch the collection

    The AI identifies all NFTs held by the provided wallet address.

    list_tokens
  2. Inspect individual traits

    The AI looks at the specific metadata and attributes for each token in the list.

    get_token
  3. Calculate rarity

    The AI compares these attributes to the rest of the collection to find the outliers.

    get_token
  4. Generate report

    The AI presents a clean, sorted list of your assets based on their uniqueness.

    list_tokens

Try it

Copy these to start.

Use these prompts to kick off your analysis.

Starting points

Replace the wallet addresses with the ones you want to scan.

Reservoir Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_f8oRngSRqD3FZxykMhupyTGLHMx62tTE8zLE8WBy/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Reservoir capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "reservoir-nft-liquidity-api-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_f8oRngSRqD3FZxykMhupyTGLHMx62tTE8zLE8WBy/mcp"
    }
  }
}
Copy into chat04
  • List all the NFTs in wallet 0x123... and sort them by rarity.

  • Which is the rarest token in this wallet: 0xabc...?

  • Analyze the rarity of the tokens in 0x789... and tell me which ones have the most unique traits.

  • Show me a list of tokens from 0xdef... and rank them from highest to lowest rarity score.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Reservoir once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start asking questions immediately.

Connect Reservoir to your AI

FAQ

How this task behaves.

  • 01

    Can the AI sell my NFTs for me?

    No. The AI can only read data from the blockchain. It cannot execute transactions or move assets.

  • 02

    Does the AI calculate rarity itself?

    No. The AI uses the rarity data provided by the Reservoir tools to perform the sorting and analysis.

  • 03

    Can I analyze any wallet address?

    Yes, as long as the address has NFTs that the Reservoir tools can identify.

  • 04

    Will the AI change my NFT metadata?

    No. The tools are read-only. Your tokens and their metadata remain untouched.

  • 05

    Can the AI see my private keys?

    No. The AI only accesses public blockchain data through the Reservoir tools.

  • More questions about Reservoir? The Connector page answers them. See everything the Reservoir Connector can do

Connect Reservoir to Claude, Cursor, ChatGPT & more