{"name":"GinsengSwap Gift Cards","version":"1.0.0","protocol":"mcp","protocolVersion":"2024-11-05","transport":["streamable-http","sse"],"description":"Search, browse, and purchase gift cards from 600+ brands worldwide. Accepts USDC payments on Ethereum Mainnet via x402 protocol.","endpoint":"https://www.ginsengswap.org/api/mcp/cards-mainnet","capabilities":{"tools":{},"resources":{}},"mastercard_tools":[{"name":"search_mastercard","description":"Search available Mastercard Prepaid cards. Returns Mastercard Prepaid products in USD and GBP.","inputSchema":{"type":"object","properties":{"currency":{"type":"string","enum":["USD","GBP"],"description":"Filter by currency (USD or GBP)"},"limit":{"type":"number","description":"Maximum results to return (default: 10)","default":10}}},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/cards-mainnet"},{"name":"get_mastercard_details","description":"Get detailed information about a specific Mastercard Prepaid product including value ranges, terms, and redemption instructions.","inputSchema":{"type":"object","properties":{"product_id":{"type":"number","description":"The product ID of the Mastercard Prepaid card"}},"required":["product_id"]},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/cards-mainnet"},{"name":"list_mastercard_countries","description":"List countries where Mastercard Prepaid cards are available.","inputSchema":{"type":"object","properties":{}},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/cards-mainnet"},{"name":"list_mastercard_currencies","description":"List supported currencies for Mastercard Prepaid cards (USD, GBP).","inputSchema":{"type":"object","properties":{}},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/cards-mainnet"},{"name":"purchase_mastercard","description":"Purchase a Mastercard Prepaid card with USDC on Ethereum Mainnet. Supports USD and GBP. A 1.5% service fee is applied to all purchases to cover USDC/fiat settlement and FX conversion. Requires x402 payment. Voucher sent to provided email.","inputSchema":{"type":"object","properties":{"product_id":{"type":"number","description":"Mastercard Prepaid product ID"},"price":{"type":"number","description":"Card value in its native currency"},"currency":{"type":"string","enum":["USD","GBP"],"description":"Currency (USD or GBP)"},"user_email":{"type":"string","description":"Email for voucher delivery"},"user_id":{"type":"string","description":"User wallet address or identifier"},"user_first_name":{"type":"string","description":"Recipient first name (optional)"},"user_last_name":{"type":"string","description":"Recipient last name (optional)"}},"required":["product_id","price","currency","user_email","user_id"]},"cost":"card_value_in_usdc","costDescription":"Card value in USDC + 1.5% service fee on all currencies (covers USDC/fiat settlement and FX conversion).","endpoint":"https://www.ginsengswap.org/api/mcp/cards-mainnet"},{"name":"check_mastercard_order","description":"Check the status of a Mastercard Prepaid card order.","inputSchema":{"type":"object","properties":{"order_id":{"type":"string","description":"Order ID from purchase_mastercard"},"user_id":{"type":"string","description":"User identifier for authentication"},"user_email":{"type":"string","description":"Email used for order (alternative auth)"}},"required":["order_id"]},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/cards-mainnet"}],"tools":[{"name":"search_giftcards","description":"Search available gift cards by brand, country, or currency. Returns a list of matching gift card products with pricing and availability.","inputSchema":{"type":"object","properties":{"brand":{"type":"string","description":"Brand name to filter (e.g., \"Amazon\", \"Starbucks\")"},"country":{"type":"string","description":"Country name or code to filter (e.g., \"Hong Kong\", \"HK\", \"United States\", \"US\", \"Canada\", \"CA\")"},"currency":{"type":"string","description":"Currency to filter. Currently supported: \"USD\", \"CAD\", \"HKD\""},"limit":{"type":"number","description":"Maximum results to return (default: 10, max: 50)","default":10}}},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/tools/search-giftcards"},{"name":"get_brand_details","description":"Get detailed information about a specific gift card brand including denominations, restrictions, terms of use, and redemption instructions.","inputSchema":{"type":"object","properties":{"product_id":{"type":"number","description":"The unique product ID of the gift card brand"}},"required":["product_id"]},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/tools/get-brand-details"},{"name":"list_countries","description":"Get all countries that have gift cards available in the catalog.","inputSchema":{"type":"object","properties":{}},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/tools/list-countries"},{"name":"list_currencies","description":"Get all currencies available for gift cards in the catalog.","inputSchema":{"type":"object","properties":{}},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/tools/list-currencies"},{"name":"purchase_giftcard","description":"Purchase a gift card. The voucher details will be sent to the provided email. Requires x402 payment in USDC on Ethereum Mainnet. Currently supports USD, CAD, HKD, and GBP gift cards. A 1.5% service fee is applied to all purchases to cover USDC/fiat settlement costs and FX conversion.","inputSchema":{"type":"object","properties":{"product_id":{"type":"number","description":"Product ID of the gift card to purchase"},"price":{"type":"number","description":"Gift card amount in the card's native currency (must match available denominations)"},"currency":{"type":"string","enum":["USD","CAD","HKD","GBP"],"description":"Currency code of the gift card. Currently supported: USD, CAD, HKD, GBP."},"user_email":{"type":"string","description":"Email where voucher will be sent"},"user_id":{"type":"string","description":"User identifier (wallet address or user ID)"},"user_first_name":{"type":"string","description":"Customer first name (optional)"},"user_last_name":{"type":"string","description":"Customer last name (optional)"},"brand_name":{"type":"string","description":"Brand name for order record (optional)"},"country_name":{"type":"string","description":"Country name for order record (optional)"}},"required":["product_id","price","user_email","user_id"]},"cost":"card_value_in_usdc","costDescription":"Card value in USDC on Ethereum Mainnet + 1.5% service fee on all currencies (covers USDC/fiat settlement and FX conversion).","endpoint":"https://www.ginsengswap.org/api/mcp/tools/purchase-giftcard-mainnet"},{"name":"check_order_status","description":"Check the status of a gift card order and retrieve voucher details if available.","inputSchema":{"type":"object","properties":{"order_id":{"type":"string","description":"Order ID returned from purchase"},"user_id":{"type":"string","description":"User identifier for authentication"},"user_email":{"type":"string","description":"Email used for order (alternative auth)"}},"required":["order_id"]},"cost":0,"endpoint":"https://www.ginsengswap.org/api/mcp/tools/check-order-status"}],"tools_count":12,"ui_resources":[{"uri":"ui://ginsengswap/gift-card-catalog","name":"gift_card_catalog","mimeType":"text/html;profile=mcp-app","description":"Interactive gift card catalog — browse cards, view denominations, and see estimated USDC cost with FX conversion. Redirects to checkout for wallet payment.","csp":{"connectDomains":["https://www.ginsengswap.org"],"resourceDomains":["https://www.ginsengswap.org","https://nclivestorageacct.blob.core.windows.net"]},"linkedTools":["search_giftcards","get_brand_details"]}],"payment":{"supported":true,"required":true,"protocol":"x402","description":"Purchase tool requires USDC payment via x402 protocol on Ethereum Mainnet","asset":{"symbol":"USDC","name":"USD Coin","address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","decimals":6,"network":"ethereum","chainId":1},"facilitator":"0xc10561C1c0d718B3D362df9d510A1b4e4331a4Ee"},"registration":{"standard":"ERC-8004","agentId":22628,"registry":"0x8004A169FB4a3325136EB29fA0ceB6D2e539a432","network":"ethereum","chainId":1,"agentCard":"https://www.ginsengswap.org/.well-known/gift-cards/agent-card.json","agentRegistration":"https://www.ginsengswap.org/.well-known/gift-cards/agent-registration.json"},"endpoints":{"mcp":"https://www.ginsengswap.org/api/mcp/cards-mainnet","manifest":"https://www.ginsengswap.org/api/mcp/manifest/cards-mainnet","manifest_testnet":"https://www.ginsengswap.org/api/mcp/manifest/cards","checkout":"https://www.ginsengswap.org/checkout"},"metadata":{"timestamp":"2026-04-11T16:50:06.301Z","source":"ginsengswap","category":"gift_cards","environment":"production","supportedCurrencies":["USD","CAD","HKD","GBP"]}}