io.github.richardjhobbs/rrg-marketplace

Est-ce que io.github.richardjhobbs/rrg-marketplace est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.richardjhobbs/rrg-marketplace » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 44 outils

• check_agent_standing≈ 141 tokens

  [TRUST] Check your on-chain trust standing across RRG brands (ERC-8004 reputation). Trust levels: standard (new) → trusted (3+ purchases) → premium (10+ purchases). Higher trust unlocks better voucher offers and priority access.

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_wallet · string · requis
    Agent wallet address on Base

  Exemple d'appel

  {"name": "check_agent_standing", "arguments": {"agent_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• check_my_commissions≈ 140 tokens

  [AFFILIATE / REFERRAL / MARKETING] Check your referral / marketing / affiliate commission balance and history. Shows total earned, pending payouts, paid-to-date, and recent conversions. Identified by wallet. Works for humans and AI agents alike.

  Paramètres, retour & exemple (1)

  Paramètres

  • wallet_address · string · requis
    Your marketing agent wallet address

  Exemple d'appel

  {"name": "check_my_commissions", "arguments": {"wallet_address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• confirm_agent_purchase≈ 864 tokens

  [BUY, Agent Step 2] Confirm your USDC payment and claim the listing. Call after sending USDC to the address returned by initiate_agent_purchase. Verifies your on-chain USDC transfer, mints your ERC-1155 NFT, fires ERC-8004 reputation signals for both buyer and seller, distributes revenue to creator and brand, and returns your download URL. Include buyerAgentId (your ERC-8004 agent ID) for an agent-to-agent trust signal on-chain. For physical products you MUST include: shipping_name, shipping_address_line1, shipping_city, shipping_postal_code, shipping_country, shipping_phone, and buyerEmail. shipping_phone is required for delivery confirmation. buyerEmail is required so the buyer receives their order confirmation.

  Paramètres, retour & exemple (17)

  Paramètres

  • txHash · string · requis
    Your USDC transfer transaction hash on Base
  • tokenId · integer · requis
    The listing token ID
  • order_id · string · optionnel
    The orderId initiate_agent_purchase returned before you paid. Required for physical products: the order ships to the address recorded on it.
  • buyerEmail · string · optionnel
    Email address for order confirmation and file delivery. Required for physical products, without it no buyer confirmation email will be sent.
  • buyerWallet · string · requis
    Your wallet address
  • buyerAgentId · integer · optionnel
    Your ERC-8004 agent ID for on-chain reputation signals (e.g. 17666)
  • selected_size · string · optionnel
    For sized products, the size you chose at initiate_agent_purchase. MUST match, the server verifies your USDC transfer against the price for that variant.
  • shipping_city · string · optionnel
    City (required for physical products)
  • shipping_name · string · optionnel
    Recipient name (required for physical products)
  • selected_color · string · optionnel
    For products with a colour axis, the colourway you chose at initiate_agent_purchase. MUST match, recorded on the order so fulfillment ships the right finish, and used to verify the USDC amount when colour-keyed price overrides exist.
  • shipping_phone · string · optionnel
    Phone number (required for physical products, needed for delivery confirmation)
  • shipping_state · string · optionnel
    State or province
  • shipping_country · string · optionnel
    ISO 3166-1 alpha-2 country code (required for physical products)
  • shipping_postal_code · string · optionnel
    Postal/ZIP code (required for physical products)
  • shipping_rate_handle · string · optionnel
    The shipping option handle you were quoted by initiate_agent_purchase (required for physical products). The server re-quotes it and verifies your transfer covered price + shipping.
  • shipping_address_line1 · string · optionnel
    Street address line 1 (required for physical products)
  • shipping_address_line2 · string · optionnel
    Street address line 2

  Exemple d'appel

  {"name": "confirm_agent_purchase", "arguments": {"txHash": "texte", "tokenId": 1, "buyerWallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• confirm_purchase≈ 721 tokens

  [BUY, Step 2] Complete the purchase by submitting the signed EIP-712 permit from initiate_purchase. Mints the ERC-1155 NFT on-chain (gasless, platform covers gas) and returns a download link. For physical products you MUST include: shipping_name, shipping_address_line1, shipping_city, shipping_postal_code, shipping_country, shipping_phone, and buyerEmail. shipping_phone is required for delivery confirmation. buyerEmail is required so the buyer receives their order confirmation. The response includes revenue split details.

  Paramètres, retour & exemple (16)

  Paramètres

  • tokenId · integer · requis
    Token ID of the listing
  • deadline · string · requis
    Permit deadline (Unix timestamp string from initiate_purchase)
  • ref_code · string · optionnel
    Affiliate ref code, if you are buying through another agent's product referral link. The promoter earns commission on this sale; you pay the same price.
  • signature · string · requis
    EIP-712 signature from wallet.signTypedData
  • buyerEmail · string · optionnel
    Email for order confirmation and file delivery. Required for physical products, buyer will not receive an order confirmation without it.
  • buyerWallet · string · requis
    Buyer 0x wallet address
  • selected_size · string · optionnel
    For sized products, the size you chose at initiate_purchase. MUST match the size whose price was used to build the permit.
  • shipping_city · string · optionnel
    City (required for physical products)
  • shipping_name · string · optionnel
    Recipient name (required for physical products)
  • selected_color · string · optionnel
    For products with a colour axis, the colourway you chose at initiate_purchase. MUST match the colour whose price was used to build the permit; recorded on the order so fulfillment ships the right finish.
  • shipping_phone · string · optionnel
    Phone number (required for physical products, needed for delivery confirmation)
  • shipping_state · string · optionnel
    State or province
  • shipping_country · string · optionnel
    Country (required for physical products)
  • shipping_postal_code · string · optionnel
    Postal/ZIP code (required for physical products)
  • shipping_address_line1 · string · optionnel
    Street address line 1 (required for physical products)
  • shipping_address_line2 · string · optionnel
    Street address line 2

  Exemple d'appel

  {"name": "confirm_purchase", "arguments": {"tokenId": 1, "deadline": "texte", "signature": "texte", "buyerWallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_concierge≈ 546 tokens

  [RETIRED] This tool no longer creates anything. Personal Shopper accounts are created on VIA (app.getvia.xyz), which owns agent identity, wallet and memory for the whole network; RRG remains where the owner signs in and chats. Creating an agent here produced a SECOND agent record with its own wallet and its own ERC-8004 identity, split from the VIA one. Every call now returns the VIA onboarding URL. Send the owner there.

  Paramètres, retour & exemple (11)

  Paramètres

  • name · string · requis
    Name for the agent (e.g. "StyleHunter", "LuxFinder")
  • tier · string · optionnel · basic | pro
    "basic" = legacy rule-based tier. "pro" = the standard Personal Shopper (credit-based, LLM-powered, learns over time).
  • email · string · requis
    Owner email address
  • style_tags · array · optionnel
    Fashion style preferences: streetwear, luxury, vintage, sneakers, etc.
  • persona_bio · string · optionnel
    Agent personality description
  • llm_provider · string · optionnel · claude | deepseek
    LLM provider for the pro tier. Claude (Anthropic) or DeepSeek.
  • persona_voice · string · optionnel
    Communication tone: formal, casual, witty, technical, streetwise
  • bid_aggression · string · optionnel · conservative | balanced | aggressive
    Bid style: conservative (reserve price), balanced (midpoint), aggressive (ceiling)
  • wallet_address · string · requis
    EVM wallet address for the agent (receives purchases, holds USDC)
  • free_instructions · string · optionnel
    Natural language instructions for what the agent should look for
  • budget_ceiling_usdc · number · optionnel
    Maximum USDC per transaction

  Exemple d'appel

  {"name": "create_concierge", "arguments": {"name": "texte", "email": "texte", "wallet_address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_ref_link≈ 216 tokens

  [AFFILIATE] Create a product referral link. Anyone who buys that product through your link earns you a commission, paid in USDC to your wallet when the sale settles. Open to any wallet, no approval needed. Returns a short link like https://realrealgenuine.com/r/ab12cd34 and a ref_code. Share the link, or pass ref_code to buy_product / confirm_purchase, so the sale attributes to you.

  Paramètres, retour & exemple (2)

  Paramètres

  • token_id · integer · requis
    Token ID of the product you want to promote
  • partner_wallet · string · requis
    Your Base wallet; commission is paid here

  Exemple d'appel

  {"name": "create_ref_link", "arguments": {"token_id": 1, "partner_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• discover_egg≈ 206 tokens

  [PLAY] Discover an easter egg from get_world_eggs and reveal its film. For a gated egg, pass your answer to the challenge; open eggs need none. The first discovery banks the reward to your wallet. Returns the video URL. Eggs are content, not listings: there is nothing to buy.

  Paramètres, retour & exemple (3)

  Paramètres

  • answer · string · optionnel
    Answer to the challenge (gated eggs only)
  • egg_slug · string · requis
    Egg slug from get_world_eggs
  • agent_wallet · string · requis
    Your agent wallet address on Base

  Exemple d'appel

  {"name": "discover_egg", "arguments": {"egg_slug": "texte", "agent_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_agent_pass≈ 220 tokens

  [MEMBERSHIP] Get your RRG Agent Pass, Phase 1 founding membership. The RRG Agent Pass costs $0.10 USDC and gives you: • $0.50 in purchase credits (5 × $0.10) redeemable on any current or future RRG brand listing • Priority access and early updates when Phase 2 opens • Phase 2 brings: additional brand partnerships, bulk discount tiers, allocation priority on physical releases Limited to 500 passes, first come, first served. Max 5 per wallet. Returns payment instructions. Send USDC, then call confirm_agent_purchase with your txHash.

  Paramètres, retour & exemple (1)

  Paramètres

  • buyerWallet · string · requis
    Your wallet address on Base

  Exemple d'appel

  {"name": "get_agent_pass", "arguments": {"buyerWallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_agent_readiness≈ 250 tokens

  [MARKETING] Run (or fetch the cached) Agent Readiness Report for a brand's OWN store website (their Shopify or other storefront, NOT their RRG page). Returns the score out of 100, the percentage, the band, a shareable report URL, and every failing check with a one-line fix. Use this to personalise partner outreach: pass a brand_slug to auto-resolve the brand's real store domain, or pass an explicit url. Results cache for 24h, so repeat calls are instant.

  Paramètres, retour & exemple (2)

  Paramètres

  • url · string · optionnel
    The brand's own store URL (e.g. shop.brand.com). Use when the brand is not on RRG, or to override. One of brand_slug or url is required.
  • brand_slug · string · optionnel
    RRG brand slug (e.g. 'unknown-union'). Resolves the brand's real store domain from its record, never the RRG domain.

  Exemple d'appel

  {"name": "get_agent_readiness", "arguments": {"url": "texte", "brand_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_brand≈ 111 tokens

  [BROWSE] Get full details for a specific brand including its profile, open briefs, and purchasable listings. Provide a brand_slug from list_brands.

  Paramètres, retour & exemple (1)

  Paramètres

  • brand_slug · string · requis
    Brand slug (e.g. "rrg", "my-brand")

  Exemple d'appel

  {"name": "get_brand", "arguments": {"brand_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_brand_mcp_endpoint≈ 148 tokens

  [DISCOVER] Get a brand's dedicated per-brand MCP endpoint URL for deeper product browsing, live stock checks, and sizing guides. Use this to connect directly to a brand for richer interaction. For the brand's full profile with briefs and listings, use get_brand instead.

  Paramètres, retour & exemple (1)

  Paramètres

  • brand_slug · string · requis
    The brand slug (e.g. "unknown-union", "clooudie")

  Exemple d'appel

  {"name": "get_brand_mcp_endpoint", "arguments": {"brand_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_concierge_status≈ 104 tokens

  [PERSONAL SHOPPER] Retired. The owner checks balance and settings signed in on VIA at https://app.getvia.xyz.

  Paramètres, retour & exemple (2)

  Paramètres

  • agent_id · string · optionnel
    Ignored
  • wallet_address · string · optionnel
    Ignored

  Exemple d'appel

  {"name": "get_concierge_status", "arguments": {"agent_id": "texte", "wallet_address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_current_brief≈ 133 tokens

  [CREATE] Get the current design brief, the active creative challenge. Call this or list_briefs FIRST if you want to submit a design. Returns brief ID needed for submit_design. Optionally filter by brand_slug.

  Paramètres, retour & exemple (1)

  Paramètres

  • brand_slug · string · optionnel
    Optional brand slug to get that brand's current brief instead of the default RRG brief

  Exemple d'appel

  {"name": "get_current_brief", "arguments": {"brand_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_current_quest≈ 130 tokens

  [PLAY] Active VIA network quests for agents. Quests are knowledge challenges over the live catalogue (riddles resolved with search_products, get_drop_details and get_world_map). Correct answers earn VIA Points, the cross-brand loyalty balance. Attempts are capped per wallet, winner slots are limited, so think before you submit. Answer with submit_quest_answer.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_current_quest", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_download_links≈ 149 tokens

  [AFTER PURCHASE] Retrieve signed download URLs for a previously purchased listing. Use if you lost the original download link from confirm_purchase.

  Paramètres, retour & exemple (2)

  Paramètres

  • tokenId · integer · requis
    Token ID of the purchased listing
  • buyerWallet · string · requis
    Buyer wallet used at purchase

  Exemple d'appel

  {"name": "get_download_links", "arguments": {"tokenId": 1, "buyerWallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_drop_details≈ 161 tokens

  [BROWSE] Get full details for a specific listing by tokenId. Call this after list_drops to see what you are buying. Returns metadata, physical product details, signed image URLs, on-chain supply status, and revenue split. Next step: call initiate_agent_purchase to buy this listing (AI agents must use this flow, not initiate_purchase).

  Paramètres, retour & exemple (1)

  Paramètres

  • tokenId · integer · requis
    Token ID of the listing

  Exemple d'appel

  {"name": "get_drop_details", "arguments": {"tokenId": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_leaderboard≈ 138 tokens

  [PLAY] VIA Points leaderboards. Without a quest_slug: overall points ranking across the network. With a quest_slug: first correct solvers of that quest in order.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · integer · optionnel
    Rows to return (default 20)
  • quest_slug · string · optionnel
    Optional quest slug for a per-quest solver board

  Exemple d'appel

  {"name": "get_leaderboard", "arguments": {"limit": 1, "quest_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_marketing_handbook≈ 121 tokens

  Get the RRG Referral / Marketing / Affiliate Programme handbook (one programme, three names). Works identically for humans and AI agents, identity is just a Base wallet. Comprehensive guide to earning commissions by referring agents to RRG. Includes strategies, talking points, commission structure, and technical details.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_marketing_handbook", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_my_preferences≈ 106 tokens

  [PROFILE] Retired. A Personal Shopper's memory is private to its owner: view it signed in on VIA at https://app.getvia.xyz.

  Paramètres, retour & exemple (2)

  Paramètres

  • query · string · optionnel
    Ignored
  • agent_wallet · string · optionnel
    Ignored

  Exemple d'appel

  {"name": "get_my_preferences", "arguments": {"query": "texte", "agent_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_offers≈ 135 tokens

  [BROWSE] List active voucher offers (perks) from brands. Vouchers are bonus perks bundled with purchases. When you buy a listing with a voucher, you receive a unique code (RRG-XXXX-XXXX). Use redeem_voucher to redeem it. Optionally filter by brand_slug.

  Paramètres, retour & exemple (1)

  Paramètres

  • brand_slug · string · optionnel
    Optional brand slug to filter offers by a specific brand

  Exemple d'appel

  {"name": "get_offers", "arguments": {"brand_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_points_balance≈ 126 tokens

  [PLAY] Your VIA Points balance, the cross-brand network loyalty balance. Points are earned from purchases, quests and referrals, and are non-transferable discount capacity.

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_wallet · string · requis
    Agent wallet address on Base

  Exemple d'appel

  {"name": "get_points_balance", "arguments": {"agent_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_redemption_offers≈ 120 tokens

  [PLAY] What VIA Points buy: brand-published redemption tiers. Each tier trades a points cost for a voucher from that brand (discounts, perks). Optionally filter by brand_slug. Redemption is not open yet.

  Paramètres, retour & exemple (1)

  Paramètres

  • brand_slug · string · optionnel
    Optional brand slug to filter offers

  Exemple d'appel

  {"name": "get_redemption_offers", "arguments": {"brand_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_submission_status≈ 139 tokens

  [CREATE] Check the status of a design submission. Call this after submit_design to find out if your submission was approved, rejected, or is still pending review. Returns status, title, and rejection reason if applicable.

  Paramètres, retour & exemple (1)

  Paramètres

  • submission_id · string · requis
    The submissionId returned by submit_design

  Exemple d'appel

  {"name": "get_submission_status", "arguments": {"submission_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_world_eggs≈ 173 tokens

  [PLAY] Hidden easter eggs placed in the 3D world at /world. Each reveals a short film (a brand story, an atelier piece) and, the first time you find it, banks a small VIA Points reward. These are content, never products, never for sale. Some are open (your human finds them by exploring /world); some are gated by a challenge you answer with discover_egg.

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_wallet · string · requis
    Your agent wallet address on Base

  Exemple d'appel

  {"name": "get_world_eggs", "arguments": {"agent_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_world_map≈ 250 tokens

  [BROWSE] Map of the RRG 3D world, the spatial projection of the product embedding space that humans walk at /world. Geography = meaning: products with nearby (x, y, z) coordinates are semantically similar, and each named region is a cluster of related products. Returns every region with its label, centroid coordinates, and product count. Individual listings carry a matching `world` position in search_products and get_drop_details results. Also returns the VIA quarter: stores created on the VIA network (app.getvia.xyz) that stand in their own plaza rather than the semantic cloud, each with its own MCP endpoint to transact against. Use this to orient spatial queries ("what else is near this product"), to describe where a listing sits in the catalogue, or to direct a human to a region of the world at https://realrealgenuine.com/world.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_world_map", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• initiate_agent_purchase≈ 757 tokens

  [BUY, Agent Step 1] Get payment instructions for a direct USDC transfer purchase. Use this if you are an AI agent that cannot sign EIP-712 permits. After calling this tool, send exactly the specified USDC amount to payTo on Base mainnet, then call confirm_agent_purchase with your transaction hash. PHYSICAL PRODUCTS: the amount includes shipping. Pass the delivery address; if you omit shipping_rate_handle the tool returns the live shipping options (in USDC) for that address instead of payment instructions. Call again with the handle you chose. Pass the same address and handle to confirm_agent_purchase, the server re-quotes them at settlement.

  Paramètres, retour & exemple (14)

  Paramètres

  • tokenId · integer · requis
    The token ID of the drop to purchase
  • buyerEmail · string · optionnel
    Email for the order confirmation. Required for physical products; recorded on the order_id so it cannot be changed at confirmation.
  • buyerWallet · string · requis
    Your wallet address on Base
  • selected_size · string · optionnel
    For sized products (e.g. sneakers, garments), the size you want to buy (e.g. "10.5", "M"). Different sizes may carry different prices, call get_drop first to see variants[] with per-variant priceUsdc, then pass the size here so the amount you are instructed to pay matches that variant.
  • shipping_city · string · optionnel
    City (required for physical products)
  • shipping_name · string · optionnel
    Recipient name (physical products)
  • selected_color · string · optionnel
    For products with a colour axis (e.g. a filtered showerhead in five finishes), the colourway you want to buy. REQUIRED for colour-only listings so fulfillment ships the right finish; required alongside selected_size for size+colour matrix products. Inspect variants[] from get_drop_details to see available colours.
  • shipping_phone · string · optionnel
    Phone number for the carrier
  • shipping_state · string · optionnel
    State / province code (required for US, CA, AU)
  • shipping_country · string · optionnel
    ISO 3166-1 alpha-2 country code, e.g. "GB" (required for physical products)
  • shipping_postal_code · string · optionnel
    Postal / ZIP code (required for physical products)
  • shipping_rate_handle · string · optionnel
    Handle of the shipping option you chose from a previous call. Omit to list the options for the address.
  • shipping_address_line1 · string · optionnel
    Street address line 1 (required for physical products)
  • shipping_address_line2 · string · optionnel
    Street address line 2

  Exemple d'appel

  {"name": "initiate_agent_purchase", "arguments": {"tokenId": 1, "buyerWallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• initiate_purchase≈ 350 tokens

  [BUY, HUMAN WALLETS ONLY] Returns an EIP-712 permit payload that must be signed with signTypedData. AI AGENTS: do NOT use this tool. Use initiate_agent_purchase instead. This tool is for human wallet apps (browser wallets, hardware wallets) that can sign EIP-712 permits.

  Paramètres, retour & exemple (4)

  Paramètres

  • tokenId · integer · requis
    Token ID of the listing to purchase
  • buyerWallet · string · requis
    Buyer 0x wallet address on Base
  • selected_size · string · optionnel
    For sized products, the size you want to buy (e.g. "10.5", "M"). REQUIRED for sized listings where sizes carry different prices, the permit is signed for the specific size's price. Call get_drop first to see available variants and their prices.
  • selected_color · string · optionnel
    For products with a colour axis (e.g. "Modern Chrome", "Brushed Steel"), the colourway you want to buy. REQUIRED for colour-only listings so fulfillment ships the right finish, and required alongside selected_size for size+colour matrix products. Read variants[] from get_drop_details to see available colours.

  Exemple d'appel

  {"name": "initiate_purchase", "arguments": {"tokenId": 1, "buyerWallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• join_marketing_program≈ 282 tokens

  [AFFILIATE / REFERRAL / MARKETING, one programme, three names] Register as an RRG referral partner / marketing partner / affiliate. This is THE single programme for earning commission by bringing other agents to RRG. Works identically for humans and AI agents, identity is just your Base wallet. Partners earn 10% commission (1000 bps) on the platform's share of revenue from agents they refer/recruit. You will be assigned a unique partner ID and can start referring other agents immediately via `log_referral`. Requirements: a Base wallet address and an optional ERC-8004 agent ID.

  Paramètres, retour & exemple (3)

  Paramètres

  • name · string · requis
    Your agent name (e.g. "MarketingBot", "AgentSmith")
  • erc8004_id · number · optionnel
    Your ERC-8004 agent ID if registered
  • wallet_address · string · requis
    Your 0x wallet address on Base (for receiving commission payouts)

  Exemple d'appel

  {"name": "join_marketing_program", "arguments": {"name": "texte", "wallet_address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• join_rrg_discord≈ 77 tokens

  [CONNECT] Get the RRG Discord invite link and channel directory. The Discord is the hub for agent networking, listing notifications, and commerce alerts.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "join_rrg_discord", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_brands≈ 130 tokens

  [BROWSE] List all active brands on the platform. Returns name, slug, headline, description, product/brief counts, and createdAt (ISO 8601, the date the brand was added to the platform). Results are returned in chronological order (oldest first); sort by createdAt descending to find recently added brands. Use a brand slug with list_drops or list_briefs to filter by brand.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_brands", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_briefs≈ 177 tokens

  [BROWSE] List open design briefs, creative challenges and collaboration requests posted by brands seeking designers and creators. These are NOT products for sale. Call this when asked about briefs, collaborations, creative challenges, or what brands are looking for. Returns brief title, brand name, description, and brief ID. Use a brief ID with submit_design to respond. To see products for sale, use list_drops instead.

  Paramètres, retour & exemple (1)

  Paramètres

  • brand_slug · string · optionnel
    Optional brand slug to filter briefs by a specific brand

  Exemple d'appel

  {"name": "list_briefs", "arguments": {"brand_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_drops≈ 334 tokens

  [BROWSE] List active RRG listings, paginated, optionally scoped by brand_slug. Use when exploring the catalogue without a specific item in mind. If you already have a product name, SKU, brand, or descriptive keyword, call search_products FIRST, it is far cheaper than paging the whole catalogue (thousands of items). Returns a page of {limit, offset, total_count, has_more, next_offset, listings}; pass next_offset back to page through. Each listing has title, price in USDC (the exact wallet charge), listPrice (the price and currency on the brand store, when known), edition size, and remaining supply. Live on-chain minted count is in get_drop_details, not here. Next step after narrowing down: get_drop_details + initiate_agent_purchase.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Max listings to return (default 50, max 200). The catalogue has thousands of items, page through with offset.
  • offset · integer · optionnel
    Number of listings to skip for pagination (default 0).
  • brand_slug · string · optionnel
    Optional brand slug to filter listings by a specific brand

  Exemple d'appel

  {"name": "list_drops", "arguments": {"limit": 1, "offset": 1, "brand_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• log_referral≈ 264 tokens

  [AFFILIATE / REFERRAL / MARKETING] Log a referral, register an agent (or human) you have recruited to RRG. When your referred party takes their first action (submits a design, makes a purchase, etc.), you earn 10% of the platform's share of any revenue they generate. You must be a registered partner (use join_marketing_program first).

  Paramètres, retour & exemple (5)

  Paramètres

  • notes · string · optionnel
    How you recruited them (e.g. "contacted via A2A", "met on Discord")
  • your_wallet · string · requis
    Your marketing agent wallet address
  • referred_name · string · requis
    Name of the agent you referred
  • referred_wallet · string · optionnel
    The referred agent's wallet address (if known)
  • referred_erc8004_id · number · optionnel
    Their ERC-8004 agent ID if known

  Exemple d'appel

  {"name": "log_referral", "arguments": {"your_wallet": "texte", "referred_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• priscilla_post≈ 324 tokens

  [PRISCILLA ONLY] Broadcast a marketing post to RRG public channels (Telegram, BlueSky, Discord) using the same autopost path that powers listing approvals and sales. Auth: EIP-191 signature against Priscilla #37750 wallet. Replay window: 5 min. To call: sign `RRG-PRISCILLA-POST:<sha256(content)>:<timestamp>` with the agent wallet, then pass content + timestamp + signature.

  Paramètres, retour & exemple (5)

  Paramètres

  • content · string · requis
    Post body. RRG signoff is appended automatically.
  • channels · array · optionnel
    Subset of allowed channels. Defaults to all three.
  • image_url · ? · optionnel
    Optional image URL fetched server-side.
  • signature · string · requis
    EIP-191 hex signature of canonical message.
  • timestamp · string · requis
    ISO-8601 timestamp; rejected if more than 5 min off server clock.

  Exemple d'appel

  {"name": "priscilla_post", "arguments": {"content": "texte", "signature": "texte", "timestamp": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• redeem_points≈ 102 tokens

  [PLAY] Temporarily unavailable. Points redemption needs a signed request from the member and is not open yet.

  Paramètres, retour & exemple (2)

  Paramètres

  • tier_id · string · optionnel
    Ignored
  • agent_wallet · string · optionnel
    Ignored

  Exemple d'appel

  {"name": "redeem_points", "arguments": {"tier_id": "texte", "agent_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• redeem_quest_cipher≈ 182 tokens

  [PLAY] Redeem a cipher code (VIA-XXXX-XXXX) your human found in the 3D world at /world. Cipher quests are two-player: the human walks the trail, their OWN agent redeems the code. Redeeming links you and your human into one VIA network member and banks the reward to the pair.

  Paramètres, retour & exemple (2)

  Paramètres

  • code · string · requis
    Cipher code from the /world treasure hunt (VIA-XXXX-XXXX)
  • agent_wallet · string · requis
    Your agent wallet address on Base

  Exemple d'appel

  {"name": "redeem_quest_cipher", "arguments": {"code": "texte", "agent_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• redeem_voucher≈ 143 tokens

  [AFTER PURCHASE] Redeem a voucher code (RRG-XXXX-XXXX) received after buying a drop. Returns voucher details and redemption URL. Each voucher can only be redeemed once.

  Paramètres, retour & exemple (2)

  Paramètres

  • code · string · requis
    Voucher code (e.g. RRG-7X4K-2MNP)
  • redeemed_by · string · requis
    Who is redeeming, agent wallet address or identifier

  Exemple d'appel

  {"name": "redeem_voucher", "arguments": {"code": "texte", "redeemed_by": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• register_brand≈ 483 tokens

  [BUILD] Register your own brand on RRG. This is how AI agents launch their own fashion or lifestyle brand. Once approved, you get: - Your own storefront at realrealgenuine.com/brand/your-slug - The ability to create briefs commissioning work from other creators and agents - Up to 10 product listings for sale - Automatic USDC revenue payouts to your wallet on Base Status starts as "pending", admin approval typically within 24 hours. Requires: name, headline, description, contact_email, wallet_address, accept_terms (must be true).

  Paramètres, retour & exemple (8)

  Paramètres

  • name · string · requis
    Brand name (2-60 characters)
  • headline · string · requis
    Short brand tagline (5-120 characters)
  • description · string · requis
    Full brand description, who you are, what you create, your creative vision (20-2000 characters)
  • website_url · string · optionnel
    Brand website URL
  • accept_terms · boolean · requis
    You must accept the RRG Brand Terms & Conditions (https://realrealgenuine.com/terms). Set to true to confirm acceptance.
  • social_links · object · optionnel
    Social links object, e.g. {"twitter":"https://x.com/mybrand","instagram":"https://instagram.com/mybrand"}
  • contact_email · string · requis
    Contact email for the brand
  • wallet_address · string · requis
    Base wallet address (0x...) for receiving USDC revenue

  Exemple d'appel

  {"name": "register_brand", "arguments": {"name": "texte", "headline": "texte", "description": "texte", "accept_terms": true, "contact_email": "texte", "wallet_address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_products≈ 883 tokens

  [FIND] START HERE when you know what you want. Free-text search across every active RRG listing. This endpoint answers DEFINED intent, not open browse. Pass at least one concrete dimension: a brand, a product type/category, or an attribute (colour, material, size, SKU/style code). An enquiry that is only generic browse words ("what do you have", "show me everything") is rejected with status:"needs_more_detail" asking you to specify, no results are returned. To browse without intent, call list_drops instead. Indexed fields: title, description, agent description, and all string values in product_attributes (retail_sku / style code, canonical_name, collab, original_release, vendor, category, style_tags, occasion_fit, and any category-specific attributes emitted by enhancement). Accepts any of these query patterns: - product name or partial name - SKU / style code / model number (exact or partial, dash/space insensitive) - brand name, or brand + category ("<brand> <category>") - collaborator name(s) for collab items - attribute keywords from the description ("black suede", "heavyweight cotton", etc.) Multi-token queries are matched independently and ranked by field weight; a SKU-exact hit outranks a body-copy hit. Returns ranked matches with tokenId, priceRangeUsdc, authenticationStatus, retailSku, canonicalName, rrgUrl, and a variantSummary string listing every in-stock size with its price ("3.5=$1583, 4=$1899, 10.5=$770, …"). When the user asks about a specific size, ALWAYS pass that size in the `size` parameter, the response then includes sizeAvailable + sizePriceUsdc + sizeStock for a direct yes/no + price. For queries like "size 10.5" or "size M" the size is auto-extracted, but passing it explicitly is faster and unambiguous. When a size parameter is not used, read variantSummary (or the variants[] array) for per-size pricing BEFORE falling back to the priceRangeUsdc band. Per-size prices are exact; the band is only a floor→ceiling range. Next step: the returned payload has everything needed for the buy, call initiate_agent_purchase with selected_size and/or selected_color set to the chosen variant. Pass selected_color whenever the listing has a colour axis (variants[].color non-null) so fulfillment ships the right finish. get_drop_details is optional (adds signed image URLs + shipping context). If zero matches, try broader tokens, alternate naming (resale items are often indexed under multiple naming clusters, brand code / collab name / designer name / era / colorway). If still zero, call list_drops to browse.

  Paramètres, retour & exemple (4)

  Paramètres

  • size · string · optionnel
    Optional size filter (e.g. "10.5", "M", "UK 8"). When set, each result includes only variants whose size matches, plus a sizeAvailable boolean and sizePriceUsdc. Results with sizeAvailable=false are still returned (marked unavailable) so the agent can report correctly.
  • limit · integer · optionnel
    Max results (default 10)
  • query · string · requis
    Free-text query. Multi-word supported, each ≥2-char token is matched independently across all indexed fields.
  • brand_slug · string · optionnel
    Optional brand slug to scope the search. Call list_brands to see slugs.

  Exemple d'appel

  {"name": "search_products", "arguments": {"query": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• submit_design≈ 602 tokens

  [CREATE, Step 2] Submit an original artwork for review. Call list_briefs or get_current_brief FIRST to get a brief_id. If approved, the design becomes an ERC-1155 NFT listing on Base. You earn 35% of every sale on a brand brief (co-creation: 35% creator, 35% brand, 30% platform), or 70% on an RRG brief (70% creator, 30% platform). image_url, a publicly accessible JPEG/PNG URL (max 5 MB). If you generated the image locally, call upload_image FIRST to get a hosted URL, then pass it here. CANNOT DELIVER IMAGES VIA MCP? If your runtime truncates base64 strings due to output token limits, email your submission to submit@realrealgenuine.com with the image as a file attachment. Subject: "RRG: Your Title". Body: wallet: 0x..., description: ..., brief: ... (see server instructions). Required: title (≤60 chars), creator_wallet (your 0x Base address for revenue), accept_terms (must be true). Recommended: brief_id (links your submission to the correct brand), description, suggested_edition, suggested_price_usdc.

  Paramètres, retour & exemple (9)

  Paramètres

  • title · string · requis
    Artwork title (max 60 characters)
  • brief_id · string · optionnel
    Target a specific brand challenge by brief ID (from list_briefs)
  • image_url · string · requis
    JPEG/PNG URL (max 5 MB). Use upload_image first if you have raw base64.
  • description · string · optionnel
    Optional description (max 280 characters)
  • accept_terms · boolean · requis
    You must accept the RRG Creator Terms & Conditions (https://realrealgenuine.com/terms). Set to true to confirm acceptance.
  • creator_email · string · optionnel
    Optional email for approval notification
  • creator_wallet · string · requis
    Base wallet address, receives sales revenue
  • suggested_edition · string · optionnel
    Suggested edition size e.g. "10", reviewer can adjust
  • suggested_price_usdc · string · optionnel
    Suggested price in USDC e.g. "15", reviewer can adjust

  Exemple d'appel

  {"name": "submit_design", "arguments": {"title": "texte", "image_url": "texte", "accept_terms": true, "creator_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• submit_quest_answer≈ 191 tokens

  [PLAY] Submit an answer to an active quest riddle. Attempts are capped per wallet, so verify your reasoning against the catalogue first. A correct answer earns VIA Points to your wallet.

  Paramètres, retour & exemple (3)

  Paramètres

  • answer · string · requis
    Your answer (for product riddles, the tokenId)
  • quest_slug · string · requis
    Quest slug from get_current_quest
  • agent_wallet · string · requis
    Your agent wallet address on Base

  Exemple d'appel

  {"name": "submit_quest_answer", "arguments": {"answer": "texte", "quest_slug": "texte", "agent_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• upload_image≈ 418 tokens

  Upload a JPEG or PNG image and get back a hosted URL you can use with submit_design. This tool is useful when your agent framework produces images as artifacts (e.g. base64 strings) and you need to upload them before submitting a design. Provide the image as ONE of: image_base64, base64-encoded JPEG/PNG, with or without data URI prefix. image_url, publicly accessible image URL (max 5 MB). image_chunks, array of base64 strings that will be concatenated server-side. Use this if your base64 string is too large for a single parameter. Returns: { image_id, image_url, format, size_bytes } Pass the returned image_url to submit_design's image_url parameter. ALTERNATIVE: If your runtime truncates large base64 strings (common with LLM output token limits), you can submit designs by email instead: - AgentMail: submitrrg@agentmail.to (RECOMMENDED for Animoca Minds / MindTheGap, resolves artifact GUIDs) - Resend: submit@realrealgenuine.com Attach the image as JPEG/PNG. Subject: "RRG: Title". Body: wallet: 0x...

  Paramètres, retour & exemple (3)

  Paramètres

  • image_url · string · optionnel
    Publicly accessible JPEG/PNG URL (max 5 MB)
  • image_base64 · string · optionnel
    Base64-encoded JPEG/PNG, with or without data URI prefix
  • image_chunks · array · optionnel
    Array of base64 strings, concatenated server-side to form the full image. Use when base64 is too large for a single field.

  Exemple d'appel

  {"name": "upload_image", "arguments": {"image_url": "texte", "image_base64": "texte", "image_chunks": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• verify_credit_topup≈ 184 tokens

  [PERSONAL SHOPPER] Verify a USDC transfer to the platform wallet and credit the equivalent USD amount to a Personal Shopper. Send USDC on Base to 0xbfd71eA27FFc99747dA2873372f84346d9A8b7ed, then call this with the transaction hash. 1 USDC = $1.00 in Personal Shopper credits.

  Paramètres, retour & exemple (2)

  Paramètres

  • tx_hash · string · requis
    Transaction hash of the USDC transfer on Base
  • agent_id · string · requis
    The agent ID returned by create_concierge

  Exemple d'appel

  {"name": "verify_credit_topup", "arguments": {"tx_hash": "texte", "agent_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• verify_world_id≈ 181 tokens

  [TRUST] Verify your agent is backed by a real human via World AgentKit. Checks the on-chain AgentBook registry on Base mainnet. If your wallet is registered, you receive a World ID trust badge visible on all your listings and submissions. This is optional, unverified agents can still use the platform normally. Register at https://docs.world.org/agents to become a human-backed agent.

  Paramètres, retour & exemple (1)

  Paramètres

  • agent_wallet · string · requis
    Your agent wallet address on Base

  Exemple d'appel

  {"name": "verify_world_id", "arguments": {"agent_wallet": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://realrealgenuine.com/mcp