# Rarible Multi-chain NFT Protocol MCP > Rarible Multi-chain NFT Protocol connects your AI agent directly to decentralized NFT data across multiple blockchains—Ethereum, Polygon, and more. It lets you query item metadata, track collection ownership, monitor real-time market activity (mints, sales, transfers), and check order book depth using specific tools like `get_item` or `get_all_activities`. Get all your multi-chain NFT data in one place. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** nft, web3, ethereum, polygon, market-data ## Description Rarible's multi-chain protocol hooks your AI agent straight into decentralized NFT data across every major blockchain—Ethereum, Polygon, and more. You don't gotta write custom API calls or juggle multiple keys; you just tell your agent what it needs to know about the market. **You Get Metadata and History:** You can get full metadata and current status for any NFT item using `get_item`. If you need to find items, use `search_items`—it runs complex queries across all NFTs based on multiple traits, owners, or collections. Need to see what's in a specific group? Run `get_items_by_collection` to list every individual NFT within that collection ID, or track down everything owned by one address with `get_items_by_owner`. For deep dives into ownership, you can run `get_collections_by_owner` to see all the collections a specific wallet owns. You'll also get basic details for any single collection using `get_collection`, or fetch metadata and IDs for every available NFT group with `get_all_collections`. **You Track Every Movement on Every Chain:** To track market activity, you can monitor everything happening across the whole protocol using `get_all_activities`. You don't gotta sift through mountains of data; you can narrow that down by viewing all recorded events—mints, transfers, or sales—for a specific user address with `get_activities_by_user`, for one particular collection ID via `get_activities_by_collection`, or just check the complete action history on one single NFT item using `get_activities_by_item`. **You Analyze Active Market Orders:** Want to know what's moving right now? You can look at the current order book for any given piece. Use `get_sell_orders_by_item` to see all active sell listings against an NFT ID, or use `get_bid_orders_by_item` to find out who's currently bidding on it. For tracking user intent, you can list every bid placed by a specific wallet address using `get_bid_orders_by_maker`, or check everything an address has listed for sale with `get_sell_orders_by_maker`. If you need the specifics of any buy or sell transaction, run `get_order` to retrieve details using its unique ID. **You Run Deep Analytics and Stats:** This is where it gets good. You can figure out who's making the money by accessing buyer statistics for a collection with `get_buyers_stats`, or see what the sellers are doing with `get_sellers_stats`. To find out which collections are moving serious volume, use `get_volume_ranking`. Want to know which wallets are playing the hardest? Use `get_user_ranking` to calculate top-performing users based on transaction volume across all chains. You can also get a complete list of every available NFT collection's metadata and ID using `get_all_collections`. ## Tools ### get_activities_by_collection Retrieves all recorded activity (sales, transfers, etc.) for a specific NFT collection ID. ### get_activities_by_item Shows the complete history of actions performed on one single NFT item. ### get_activities_by_user Lists all activities associated with a specific wallet address or user ID. ### get_all_activities Retrieves a comprehensive list of recent activity across the entire protocol scope. ### get_all_collections Fetches metadata and IDs for every available NFT collection on the protocol. ### get_bid_orders_by_item Lists all current bids placed against a specific NFT item ID. ### get_bid_orders_by_maker Shows all active bid orders created by a specific user wallet address. ### get_buyers_stats Generates statistics detailing who buys items and how often within a given NFT collection. ### get_collection Retrieves detailed information for a single, known NFT collection ID. ### get_collections_by_owner Lists all the NFT collections that are currently owned by a specific wallet address. ### get_item Gets full metadata and current status for an NFT item using its unique ID. ### get_items_by_collection Retrieves a list of all individual NFTs belonging to a specific collection. ### get_items_by_owner Lists every NFT owned by a user address across the tracked blockchains. ### get_order Retrieves specific details for an order (buy or sell) using its unique ID. ### get_sell_orders_by_item Lists all active sell orders placed against a specific NFT item ID. ### get_sell_orders_by_maker Shows all items that a user has listed for sale by their wallet address. ### get_sellers_stats Provides statistics on selling activity and volume within a specific NFT collection. ### get_user_ranking Calculates the top-performing users based on their transaction volume across multiple chains. ### get_volume_ranking Determines which NFT collections are leading in overall trading volume. ### search_items Runs a complex, read-only search query across all NFTs based on multiple attributes (e.g., trait, owner, collection). ## Prompt Examples **Prompt:** ``` Get details for the NFT ETHEREUM:0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d:1 ``` **Response:** ``` I've retrieved the details for Bored Ape #1. It is part of the Bored Ape Yacht Club collection, currently owned by address 0x..., and features traits like 'Golden Fur' and 'Laser Eyes'. ``` **Prompt:** ``` Show me the top 5 NFT collections by volume on Ethereum. ``` **Response:** ``` Based on the latest volume rankings, the top 5 collections are: 1. Bored Ape Yacht Club, 2. Mutant Ape Yacht Club, 3. Azuki, 4. DeGods, and 5. Captainz. ``` **Prompt:** ``` List all NFTs owned by ETHEREUM:0x1234567890abcdef1234567890abcdef12345678 ``` **Response:** ``` I found 12 NFTs in this wallet across Ethereum and Polygon, including 2 items from the 'Pudgy Penguins' collection and 1 'Art Blocks' piece. ``` ## Capabilities ### Fetch NFT metadata and history Retrieves full details, including ownership records and media links, for a specific NFT item. ### Track all market activity across chains Aggregates and reports on every recorded event—mints, transfers, or sales—for an entire collection, user, or item. ### Analyze active sell/bid orders Reads the current order book for any NFT, showing who is bidding on it or which users have listed it for sale. ### Search and filter entire item pools Runs complex queries across all available NFTs based on multiple attributes, going beyond simple ID lookups. ### Get collection owner lists and stats Provides data detailing who owns items within a given collection or tracks the overall performance metrics of that group. ## Use Cases ### Analyzing a Competitor’s Portfolio A competitor is suddenly active. Instead of waiting for news reports, your agent runs `get_activities_by_user` on their wallet address. You instantly see every purchase or sale they made in the last 24 hours and track which collections they are targeting. ### Validating a Collection's Health You suspect a collection is losing momentum. Your agent runs `get_volume_ranking` to see if its position has dropped, then uses `get_sellers_stats` to check the seller activity. If both are low, you know the problem before anyone else does. ### Building a Valuation Report You need a report on asset liquidity for a client. Your agent runs `get_items_by_collection` to get all NFTs, then executes `get_bid_orders_by_item` and `get_sell_orders_by_item` on key items. This gives the client an accurate, real-time market depth report. ### Tracking a Wallet's Assets You need to know everything a specific wallet holds across chains. Your agent runs `get_items_by_owner` and then uses `get_collection` on the results to categorize assets, giving you a clean inventory list. ## Benefits - **Track Market Depth Instantly:** Instead of checking multiple exchange dashboards, use `get_bid_orders_by_item` and `get_sell_orders_by_item`. You see the full order book for an NFT item immediately. - **Consolidated Activity Logs:** Forget manually sifting through transaction tabs. Use `get_all_activities` to pull a single, chronological feed of every sale or transfer across collections, users, and items. - **Deep Ownership Analysis:** Need to know what a user owns? Run `get_items_by_owner` for a complete list of their NFTs, or use `get_collections_by_owner` to see the groups they belong to. - **Benchmark Performance:** Compare top assets and users quickly. Running `get_volume_ranking` shows you which collections are moving money right now—no guessing required. - **Powerful Search:** Don't just search by ID. Use `search_items` to run complex queries, filtering NFTs based on traits or multiple attributes in one go. ## How It Works The bottom line is: it translates complex blockchain queries into simple instructions that your AI client can execute in conversation. 1. First, you subscribe to this server on Vinkius and provide your API key. 2. Second, you prompt your AI client (Claude, Cursor, etc.) with a specific request—like 'What is the volume ranking for Azuki?' 3. Third, your agent recognizes the need for data, calls the relevant tool (`get_volume_ranking`), and returns the structured results to you. ## Frequently Asked Questions **How do I list everything an owner possesses? Use get_items_by_owner.** You use `get_items_by_owner` and pass the wallet address. It returns a list of every NFT that specific user owns, across all tracked chains. **Can I see who is bidding on an item? Use get_bid_orders_by_item.** Yes. `get_bid_orders_by_item` takes the NFT ID and shows you every current bid, including which user set it and for what amount. **What is the best way to check market value? Use get_volume_ranking.** To see the overall health of a sector, use `get_volume_ranking`. This tool pulls aggregate sales data across many collections to show you which ones are currently generating the most trade volume. **How do I get all collections? Use get_all_collections.** You just call `get_all_collections` with no arguments. It returns a complete list of every collection ID, which you can then use in other tools like `get_collection`. **If I use `get_all_activities`, what kind of historical data can I track?** It pulls a comprehensive activity stream. You get records for every major event—mints, transfers, and sales—across the connected blockchains. This lets you see the full lifecycle history of an NFT. **How do I check active sell orders on a specific NFT using `get_sell_orders_by_item`?** This function returns all current listings to sell that item. It shows the asking price, duration, and seller wallet address for immediate market depth analysis. **What should I know when using `search_items` for complex filtering?** `search_items` handles advanced queries beyond simple IDs. You pass a structured object to filter by traits, time frames, or specific collections, letting you pinpoint hard-to-find assets. **When I call `get_item`, how do I ensure the data includes Polygon and other chains?** You must pass the explicit chain ID in your request parameters for `get_item`. Don't assume the tool checks every network; specify exactly which blockchain you are querying. **How can I get the metadata and current owner of a specific NFT?** Use the `get_item` tool with the Item ID in the format `CHAIN:address:tokenId`. The agent will return full metadata, current supply, and ownership details. **Can I see which NFT collections are trending by volume?** Yes! The `get_volume_ranking` tool allows you to retrieve a list of collections ranked by trading volume over a specific period. **Is it possible to list all NFTs owned by a specific wallet address?** Absolutely. Use the `get_items_by_owner` tool and provide the owner's address (e.g., `ETHEREUM:0x...`) to see their entire multi-chain portfolio.