# Immutable X MCP for AI Agents AI Agent Connect > Immutable X lets you manage Web3 gaming assets and on-chain data through your AI agent. You can list items on orderbooks, mint new NFTs, and track sales or transfers across the Immutable blockchain. It puts blockchain operations directly into your chat interface. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_OTPalqNQKNrWon6wkWEuu8dsUJH3Ot5YgORGrnoq/ai-agent-connect - **Tags:** nft, web3, immutable-x, blockchain-gaming, smart-contracts ## Description Immutable X lets you manage Web3 gaming assets and on-chain data through natural conversation with your AI agent. Instead of jumping between different blockchain explorers and marketplace dashboards, you can handle the heavy lifting of asset management right where you already work. If you need to see what's happening on the chain, you can pull activity logs or check the status of specific minting requests without manually refreshing pages. For those running game studios or NFT projects, this Connector makes it easy to keep your collections updated or to see how your assets are performing in the marketplace. You can even handle the transactional side of things, like creating new listings or fulfilling orders, just by telling your agent what to do. It's a huge time saver for anyone who spends their day looking at blockchain data or managing large sets of digital collectibles. You'll find this is one of the most practical ways to interact with the Immutable ecosystem, and it's easily accessible through the Vinkius catalog. ## Tools ### list_listings Shows all current items listed on the orderbook. This helps you see what's currently for sale. ### list_mint_requests Shows all the mint requests for a specific collection. Use this to see what's pending. ### list_nfts Lists all the NFTs on the chain. This is your go-to for a broad overview of assets. ### fulfill_order Fulfills a specific order from the marketplace orderbook. This lets you complete sales quickly. ### get_activity Retrieves details for a single on-chain event. Use this to see what happened in a specific transaction. ### list_activities Shows a list of all activities on an Immutable chain. It's great for seeing a history of moves. ### list_collections Lists every NFT collection on the blockchain. Use this to browse what's available. ### get_collection Pulls all the data for a specific NFT collection. It's the easiest way to see what's in a contract. ### get_nft Fetches the details for a single NFT token. You'll get the metadata and ownership info in one go. ### get_passport_profile Grabs the profile information for a Passport user. You'll need an access token for this one. ### get_token Gets the details for an ERC20 token. Use this to check token contract information. ### list_tokens Lists all the ERC20 tokens. Use this to see the available tokens. ### mint_nfts Mints new NFTs to the blockchain. This requires your secret API key to work. ### refresh_collection_metadata Updates the metadata for an existing collection. This keeps your assets looking fresh. ### update_passport_username Changes the username for a Passport profile. Use this to manage user identities. ### create_bid Places a new bid on an item in the marketplace. This helps you secure assets you want. ### create_listing Creates a new listing on the orderbook. Use this to put your items up for sale. ## Prompt Examples **Prompt:** ``` Can you show me the latest sales on the mainnet? ``` **Response:** ``` I've pulled the latest activity from the mainnet. Here are the last 5 sales: | Activity ID | Type | Price | Status | | :--- | :--- | :--- | :--- | | act_987... | Sale | 1,200 IMX | Completed | | act_986... | Sale | 850 IMX | Completed | | act_985... | Sale | 2,100 IMX | Completed | | act_984... | Sale | 400 IMX | Completed | | act_983... | Sale | 1,500 IMX | Completed | Would you like to see more details on any of these? ``` **Prompt:** ``` List my current NFT collections. ``` **Response:** ``` Here are the NFT collections associated with your account: * **Guild of Guardians** (Contract: 0x123...abc) * **Gods Unchained** (Contract: 0x456...def) * **Mythic Realms** (Contract: 0x789...ghi) Which one would you like to inspect? ``` **Prompt:** ``` How do I put my item up for sale? ``` **Response:** ``` To put an item up for sale, I can use the `create_listing` tool. I'll just need a few details from you first: 1. The **Token ID** of the NFT you want to sell. 2. Your desired **Listing Price**. 3. Any specific **notes** you want to include for the buyer. Once you give me those, I'll handle the rest for you. ``` ## Capabilities ### Mint new NFTs Trigger the creation of new assets on the blockchain. ### List marketplace items Put your assets up for sale on the orderbook. ### Track minting status Check the progress of pending mint requests. ### Query NFT details Get specific metadata and ownership info for any token. ### Manage orderbook bids Create new bids or fulfill existing orders on the marketplace. ### Update collection data Refresh the metadata for your NFT collections. ### Fetch activity logs See a history of sales, transfers, and mints on the chain. ## Use Cases ### Checking a mint status A developer needs to see if a specific mint went through. They ask the agent to check the status of mint request X using list_mint_requests. ### Auditing sales history A studio owner wants to see what's selling best. They ask the agent to list the latest activities and use list_activities to get a summary of recent sales. ### Listing an item for sale A user wants to put a rare item on sale. They tell the agent to list their Sword NFT for 500 tokens and the agent uses create_listing. ### Gathering collection data An analyst needs to gather data on a new collection. They ask for a list of all collections and then use get_collection to pull specific metadata for a report. ## Benefits - Stop switching tabs between your code editor and the blockchain explorer by using list_activities to see on-chain data. - Manage your entire NFT inventory faster by using list_nfts and get_nft to query specific assets. - Handle marketplace transactions directly through your agent using create_listing and create_bid. - Keep your project data current by using refresh_collection_metadata to update NFT info instantly. - Monitor your project's growth in real time with list_mint_requests to see what's coming next. - Simplify user management by using update_passport_username and get_passport_profile to handle identities. ## How It Works The bottom line is that you get a direct conversational interface for your entire Immutable blockchain workflow. 1. Connect your Immutable developer account to your AI client via Vinkius. 2. Provide your Secret Key and Access Token in the configuration. 3. Ask your agent to perform tasks like 'list my NFTs' or 'check recent sales'. ## Frequently Asked Questions **What can the Immutable X MCP do for my NFT project?** It lets you manage assets, mint new ones, and handle marketplace listings through an AI agent. You can check your inventory and see what's happening on the chain without leaving your workspace. **Can I use the Immutable X MCP to see my sales history?** Yes, you can use it to pull activity logs and see every sale or transfer on the chain. It makes auditing your project's performance much faster. **Does the Immutable X MCP support minting new NFTs?** Yes, it has a tool to trigger new mints directly from your AI client. This is great for developers who need to move quickly on new asset releases. **How does the Immutable X MCP help with marketplace listings?** It allows your agent to create new listings and fulfill orders on the orderbook automatically. You can manage your marketplace presence using simple natural language commands. **Can I use the Immutable X MCP to update my NFT metadata?** Yes, you can refresh the metadata for your collections to keep your assets up to date. This ensures your buyers always see the latest information. **Is the Immutable X MCP good for tracking minting progress?** It's great for that because it can list all pending mint requests for a collection. You can stay on top of your project's rollout status easily. **Can I mint NFTs using this server?** Yes, you can use the `mint_nfts` tool. Note that this requires your Immutable Secret API Key to be configured in the environment variables. **How do I check the status of a specific on-chain event?** Use the `get_activity` tool with the specific Activity ID and chain name to retrieve detailed event metadata and status. **Is it possible to list items on the marketplace?** Absolutely. The `create_listing` tool allows you to create new orderbook listings for your assets on the specified chain.