# NMKR Cardano MCP > NMKR Cardano manages your entire NFT lifecycle on Cardano directly through your AI agent. It lets you track assets, check minting coupon balances, list payout wallets, and validate metadata—all from natural conversation. Connect to NMKR Studio via MCP to manage project metrics and financial oversight for any Cardano NFT collection. ## Overview - **Category:** ecommerce - **Price:** Free - **Tags:** nft-minting, cardano, digital-assets, web3-infrastructure, blockchain-payments, tokenization ## Description You connect your **NMKR Studio** account to your AI client—your agent does all the heavy lifting, so you don't gotta worry about running complex commands or digging through documentation. This server manages your entire Cardano NFT ecosystem from end-to-end; it lets you track assets, check minting coupon balances, list payout wallets, and validate metadata, all just by talking to your agent. You’re in complete control of every aspect of your project's financial health and asset lifecycle. **Managing Project Metrics and Assets** You can audit your entire collection using real-time figures. Your agent pulls live totals showing how many NFTs are sold, how many are reserved for future sales, and exactly how many remain available to the public by running `get_project_counts`. Need a snapshot of what's currently active? You can list every NFT associated with a specific project collection using `list_project_nfts` and check for any ongoing marketing promotions or discounts that apply to the whole batch via `get_project_discounts`. When you need granular detail on one specific asset, your agent runs `get_nft_details`, giving you the complete metadata, current state, and all the detailed info tied to a unique NFT ID. Furthermore, if you're worried about compliance or deployment issues, running `validate_nft_metadata` checks an NFT’s structure against current Cardano standards; it tells you right away if your metadata is legit. **Financial Oversight and Wallet Management** The server gives you full visibility into every dollar moving through your project. You can list all the registered payout addresses—the places where your collection gets paid out—using `list_payout_wallets`. For complex financial arrangements, it retrieves all addresses dedicated to revenue splitting via `list_split_addresses`, and if you're using staking or vesting schedules, it lists those specific addresses with `list_vesting_addresses`. You can also check your immediate operational funds by running `get_mint_coupon_balance` to see your current stash of minting coupons. Beyond just payouts, the system tracks all your associated people; you can list every sub-customer profile linked to your main account using `list_subcustomers`, keeping tabs on everyone involved in the ecosystem. **How It Works with Your Agent** It's simple: You talk to your agent. Because it’s connected through MCP, your AI client interprets natural language and executes these functions against your live NMKR Studio data. Whether you wanna know how many NFTs are left or where the payout money is going, your agent handles the API calls for you. You don't need to think in terms of JSON requests; you just ask what you want to know about your project. When you use this server, your agent coordinates all these data points—from checking `get_nft_details` on a single token to listing every payout wallet with `list_payout_wallets` and verifying compliance using `validate_nft_metadata`. It's one place that handles the entire lifecycle: from minting coupons and tracking sales metrics (`get_project_counts`) to managing complex, multi-address payouts. Your agent makes sure you see a clear picture of assets, revenue flow, and project health without you ever leaving your conversation window. ## Tools ### validate_nft_metadata Checks an NFT's metadata to confirm compliance with Cardano standards. ### get_mint_coupon_balance Checks your current balance of minting coupons. ### get_nft_details Fetches specific metadata and state for a given NFT ID. ### get_project_counts Retrieves real-time metrics on sold, reserved, and available project NFTs. ### get_project_discounts Lists any active discounts running for a project collection. ### list_payout_wallets Retrieves all registered addresses used for receiving payouts on the account. ### list_project_nfts Lists all NFTs belonging to a specific project collection. ### list_split_addresses Retrieves addresses used for revenue splitting arrangements. ### list_subcustomers Lists all sub-customer profiles associated with your primary account. ### list_vesting_addresses Retrieves addresses currently involved in staking or vesting schedules. ## Prompt Examples **Prompt:** ``` List all payout wallets registered in my NMKR account. ``` **Response:** ``` Retrieving wallets... I found 2 registered payout addresses: one primary wallet (addr1...) and one secondary wallet for royalties. Would you like to check the current balance of your minting coupons as well? ``` **Prompt:** ``` What is the sales status for NFT project UID 'prj_12345'? ``` **Response:** ``` Fetching project metrics... For project prj_12345, you have sold 150 NFTs, 25 are currently reserved, and 325 remain free for purchase. Shall I list the metadata for the most recently sold NFT? ``` **Prompt:** ``` Show me the metadata for the NFT with ID 'nft_98765'. ``` **Response:** ``` Inspecting NFT metadata... This asset is titled 'Space Traveler #42'. It is currently in the 'sold' state and its IPFS link is valid. All metadata fields follow the CIP-25 standard. Would you like to see the full JSON attributes? ``` ## Capabilities ### Retrieve NFT Details and Status Get complete metadata, current state, and detailed information for a specific NFT using its unique ID. ### Audit Project Sales Metrics Calculate real-time totals for sold, reserved, and available NFTs across your entire project collection. ### Manage Wallets and Finances List registered payout wallets, check minting coupon balances, and view revenue split or staking addresses. ### Validate NFT Compliance Verify if an NFT’s metadata structure meets current Cardano standards before deployment. ### Track Project Assets List all NFTs within a project and monitor active discounts associated with the collection. ## Use Cases ### Pre-Minting Compliance Check You're ready to mint a new collection, but you're worried about metadata errors. You ask your agent: 'Validate metadata for project X.' The agent runs `validate_nft_metadata`, confirming if the data meets Cardano standards before any deployment occurs. ### Quarterly Financial Audit It's time to check revenue flows. You prompt your agent: 'List all payout wallets and show me the vesting addresses.' The tool runs `list_payout_wallets` alongside `list_vesting_addresses`, giving you a clear picture of where money moves. ### Mid-Sale Performance Check You need to know how a project is doing right now. You ask: 'What are the current counts for my NFTs?' The agent calls `get_project_counts`, immediately telling you how many assets are sold, reserved, and still free. ### User Account Review You're onboarding a new team member. You ask your agent to check the user structure: 'List all sub-customers.' The tool uses `list_subcustomers` to map out every profile linked to the main account. ## Benefits - See your project's sales status instantly. Instead of manually running reports to check sold vs. available NFTs, use `get_project_counts` to get the numbers immediately. - Monitor all financial addresses from one prompt. You can list payout wallets (`list_payout_wallets`) and revenue split accounts (`list_split_addresses`) without switching tabs or reading multiple reports. - Validate assets before they go live. The `validate_nft_metadata` tool checks compliance against Cardano standards, stopping bad deployments before they happen. - Get deep data on any single NFT. If you only need to check the state of one asset, running `get_nft_details` bypasses needing project-wide reports. - Manage your user base directly. Use `list_subcustomers` to see all linked profiles and understand who is using the main account. ## How It Works The bottom line is, you manage complex Cardano NFT operations by talking to your AI client instead of navigating multiple dashboards. 1. Subscribe to the NMKR Cardano server on Vinkius, then enter your unique API Key. 2. Direct your AI client (like Claude or Cursor) to ask a question—for example: 'What is my coupon balance?' 3. The agent invokes the appropriate tool and returns structured data about your assets and finances. ## Frequently Asked Questions **How do I check my current coupon balance with get_mint_coupon_balance?** You simply ask the agent: 'What is my minting coupon balance?' The tool calls `get_mint_coupon_balance` and returns your exact, up-to-date count. **Can I check if an NFT passes Cardano standards using validate_nft_metadata?** Yes. Just give the agent the ID and ask it to 'Validate this NFT metadata.' The tool uses `validate_nft_metadata` to confirm compliance. **How many tools are available for listing assets? (list_project_nfts)** The server has several listing functions. To list all NFTs in a project, use `list_project_nfts`. For financial addresses, run `list_split_addresses`. **Which tool shows the total sold count? (get_project_counts)** The `get_project_counts` tool provides project asset metrics. It gives you real-time counts for sold, reserved, and available NFTs in one call. **What credentials do I need to use the `list_payout_wallets` tool?** You must connect with a valid NMKR Studio API Key. This key authenticates your agent and gives it read access to all payout wallets registered under your main account. **When I run `get_nft_details`, what information does the metadata return?** The tool returns comprehensive JSON attributes for that specific NFT ID. You get details like its title, current state (free/sold), and confirmation of IPFS link validity. **How are revenue distributions shown using `list_split_addresses`?** It lists all addresses set up for automated revenue splits. These aren't your primary spending wallets; they track specific percentage distributions across various parties or royalty holders. **What kind of data can I fetch when I run `list_subcustomers`?** This tool provides a list of sub-customer profiles linked to your main account. You retrieve their unique IDs and associated statuses, which helps you manage project oversight. **How do I get an NMKR Studio API Key?** Log in to your NMKR Studio account and go to the API section in your profile settings to generate or copy your key. **Can I see the sales progress of my NFT collection?** Yes! Use the `get_project_counts` tool with your Project UID to see how many NFTs have been sold, reserved, or remain free. **What does the metadata validation tool do?** The `validate_nft_metadata` tool checks if your NFT metadata follows the CIP-25 standard for Cardano, ensuring it will display correctly on marketplaces and wallets.