# Immutable X MCP > Immutable X lets you manage Web3 gaming assets and on-chain data directly from your AI agent. Query NFT details, list entire collections, monitor asset transactions, mint new NFTs, and handle full marketplace operations like placing bids or fulfilling orders—all without writing a single line of code. ## Overview - **Category:** developer-tools - **Price:** Free - **Tags:** nft, web3, immutable-x, blockchain-gaming, smart-contracts ## Description You can connect your Immutable developer account to any MCP-compatible client and manage complex Web3 assets through natural conversation. Instead of navigating multiple blockchain explorer dashboards or running custom scripts, you simply ask for what you need. Your agent handles the heavy lifting: it pulls on-chain events like mints and transfers, lets you check collection metadata, and even executes marketplace actions. If you're working with digital collectibles, this MCP provides access to everything from listing all current orders using `list_listings` to verifying an individual NFT’s details using `get_nft`. Because Vinkius hosts this catalog, your agent gets one place to manage assets across the entire ecosystem. You can query minting statuses via `list_mint_requests`, list every active collection with `list_collections`, or even create a brand new asset using `mint_nfts`—it’s all conversational. ## Tools ### create_bid Places a new bid on an item currently listed in the orderbook. ### create_listing Creates and posts a new listing for an asset into the marketplace's orderbook. ### fulfill_order Completes a transaction by fulfilling a confirmed order from the marketplace. ### get_activity Retrieves all details for a specific on-chain activity using its unique ID. ### get_collection Fetches the full details and metadata for an NFT collection based on its contract address. ### get_nft Gets detailed information about a single NFT using its unique token ID. ### get_passport_profile Retrieves the user's profile information from the Passport system, requiring an access token. ### get_token Looks up details for a specific ERC20 token using its contract address. ### list_activities Generates a list of all recent and historical activities that occurred on the Immutable chain. ### list_collections Retrieves a comprehensive list of all NFT collections available on the network. ### list_listings Lists every active orderbook listing currently posted by users in the marketplace. ### list_mint_requests Checks and reports on the status of pending or historical NFT minting requests for a specific collection. ### list_nfts Retrieves an exhaustive list of all existing NFTs associated with a given contract address. ### list_tokens Provides a full directory listing of ERC20 tokens available on the chain. ### mint_nfts Creates and mints new NFTs to a specified collection, requiring a secret API key. ### refresh_collection_metadata Updates the cached metadata for an entire NFT collection so you are viewing the most current details. ### update_passport_username Changes the username associated with a user's Passport profile, requiring an access token. ## Prompt Examples **Prompt:** ``` List all NFT collections on the imtbl-zkevm-mainnet chain. ``` **Response:** ``` I've retrieved the collections for imtbl-zkevm-mainnet. You have access to several active collections, including 'Guild of Guardians' and 'Gods Unchained'. Which one would you like to inspect? ``` **Prompt:** ``` Show me the details for NFT token ID 123 in collection 0xabc123... on imtbl-zkevm-mainnet. ``` **Response:** ``` Fetching NFT details... Token #123 is a 'Legendary Sword' with metadata including 'Damage: 50' and 'Rarity: Mythic'. It is currently owned by address 0x789... and is not listed for sale. ``` **Prompt:** ``` List the latest activities on the imtbl-zkevm-mainnet chain. ``` **Response:** ``` I've found 10 recent activities. These include 4 mints, 3 transfers, and 3 sale events. Would you like me to provide details for the most recent sale (ID: act_987...)? ``` ## Capabilities ### Query Web3 Asset Data Retrieve detailed information on NFT collections, specific assets, and all recent blockchain activities. ### Manage Marketplace Listings Create new listings for items, place bids on existing goods, or complete sales by fulfilling orders through the orderbook. ### Mint New Digital Assets Generate and mint brand-new NFTs directly to a collection using your agent's prompt. ### Monitor Blockchain Events List all activities on the Immutable chain, including sales, transfers, and initial asset creations. ## Use Cases ### A Game Studio needs to audit their latest asset dump. The studio manager asks, 'What NFTs were minted today and how are they doing?' The agent replies by running `list_activities` to find all recent mints, then uses `list_nfts` to provide a full inventory count. Finally, it runs `get_collection` to confirm the collection's contract address for reporting. ### A Crypto Analyst wants to research market liquidity. The analyst asks the agent to summarize current sales potential. The agent responds by calling `list_listings` and summarizing the total number of items available. They then use `get_token` to confirm if a specific ERC20 token is involved in those listings. ### A Developer needs to test a new asset minting feature. The developer asks, 'Can you create a placeholder NFT for testing?' The agent executes `mint_nfts` using the necessary API key. They then immediately run `get_nft` on that newly created token ID to verify all metadata passed correctly. ### An Operations Team needs to manage an inventory sale. The team member asks, 'List everything for sale in the Guild collection.' The agent uses `list_collections` to confirm the target contract, then runs `list_listings` to show all items. They can then use `create_listing` if more assets need adding. ## Benefits - Instant market visibility. You can instantly list all current orderbook listings using `list_listings` or track every recent sale using `list_activities`, giving you a complete picture of the asset economy. - Full lifecycle management. Don't just read data; act on it. You can create new assets with `mint_nfts` and immediately list them for sale using `create_listing` all in one conversational flow. - Deep asset inspection. Need to know what an NFT is? Use `get_nft` or `get_collection` to pull detailed metadata, ensuring you're analyzing the correct digital item before making a bid. - Streamlined transaction handling. When it’s time to close a deal, your agent handles the complex steps by allowing you to place bids with `create_bid` and finalize the sale using `fulfill_order`. - Comprehensive data overview. You can check all available tokens via `list_tokens`, or verify specific token details instantly by calling `get_token`. This saves time cross-referencing multiple smart contract pages. ## How It Works The bottom line is: you talk to your AI client, and it performs complex Web3 operations on the blockchain using Immutable's infrastructure. 1. Subscribe to this MCP and provide your Immutable Secret Key and Access Token. 2. Your AI client authenticates these credentials and establishes the connection to the blockchain network. 3. You speak naturally to your agent, asking it to perform an action, like 'list all NFTs' or 'create a new listing for this asset'. ## Frequently Asked Questions **How do I check if a collection is active using Immutable X?** You use `list_collections` to get an overview of all available collections. If you need details on one specific contract, run `get_collection`. This ensures the asset metadata is current by running `refresh_collection_metadata` first. **What should I do when a buyer places an order?** The agent handles this. After confirming a bid using `create_bid`, you complete the sale by calling `fulfill_order`. This manages the entire lifecycle from interest to final transfer. **Can I list all my NFTs at once with Immutable X?** Yes, running `list_nfts` provides an exhaustive inventory of every NFT associated with a given contract. For a general overview, you can start by checking the most recent activities using `list_activities`. **Is this MCP just for viewing data?** No, it's highly actionable. You don't just read; you write. You actively manage assets through functions like `create_listing`, `mint_nfts`, and `create_bid`. **What if I need to update my user profile details?** You can use the specialized tools for account management, such as calling `update_passport_username`. This handles changes directly through your connected Passport credentials.