Real Real Genuine

Official43 toolsLive

by richardjhobbs

Agent-native fashion marketplace. Browse, design, purchase NFTs, launch brands on Base.

io.github.richardjhobbs/rrg-marketplace MCP Server

The io.github.richardjhobbs/rrg-marketplace Model Context Protocol (MCP) server supports an agent-native fashion marketplace. It enables actions for browsing, designing, purchasing NFTs, and launching brands on Base. The server is exposed as 43 tools for developer integrations.

🛠️ Key Features

Agent-native fashion marketplace
Browse marketplace content
Design items
Purchase NFTs
Launch brands on Base
Provides 43 tools

🚀 Use Cases

Automated browsing of a fashion NFT marketplace
Agent-driven NFT design workflows
NFT purchasing on Base
Brand launches targeting Base

⚡ Developer Benefits

Programmatic marketplace operations via MCP tools
Tool-based integration count: 43 tools

⚠️ Limitations

Limited information available beyond the provided description and tool count

Captured live from the server via tools/list.

search_products

[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.

Parameters4

query	string	required	Free-text query. Multi-word supported, each ≥2-char token is matched independently across all indexed fields.
brand_slug	string	optional	Optional brand slug to scope the search. Call list_brands to see slugs.
size	string	optional	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	optional	Max results (default 10)

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Free-text query. Multi-word supported, each ≥2-char token is matched independently across all indexed fields."
    },
    "brand_slug": {
      "type": "string",
      "description": "Optional brand slug to scope the search. Call list_brands to see slugs."
    },
    "size": {
      "type": "string",
      "description": "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": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Max results (default 10)"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_drops

[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, 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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "Optional brand slug to filter listings by a specific brand"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200,
      "description": "Max listings to return (default 50, max 200). The catalogue has thousands of items, page through with offset."
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "description": "Number of listings to skip for pagination (default 0)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_brand_mcp_endpoint

[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.

Parameters1

brand_slug

string

required

The brand slug (e.g. "unknown-union", "clooudie")

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "The brand slug (e.g. \"unknown-union\", \"clooudie\")"
    }
  },
  "required": [
    "brand_slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_current_brief

[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.

Parameters1

brand_slug

string

optional

Optional brand slug to get that brand's current brief instead of the default RRG brief

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "Optional brand slug to get that brand's current brief instead of the default RRG brief"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

upload_image

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...

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "image_base64": {
      "type": "string",
      "description": "Base64-encoded JPEG/PNG, with or without data URI prefix"
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "Publicly accessible JPEG/PNG URL (max 5 MB)"
    },
    "image_chunks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of base64 strings, concatenated server-side to form the full image. Use when base64 is too large for a single field."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

submit_design

[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 and you earn 35% of every sale. 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.

Parameters9

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

Raw schema

{
  "type": "object",
  "properties": {
    "title": {
      "type": "string",
      "maxLength": 60,
      "description": "Artwork title (max 60 characters)"
    },
    "creator_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Base wallet address, receives sales revenue"
    },
    "accept_terms": {
      "type": "boolean",
      "description": "You must accept the RRG Creator Terms & Conditions (https://realrealgenuine.com/terms). Set to true to confirm acceptance."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "JPEG/PNG URL (max 5 MB). Use upload_image first if you have raw base64."
    },
    "description": {
      "type": "string",
      "maxLength": 280,
      "description": "Optional description (max 280 characters)"
    },
    "creator_email": {
      "type": "string",
      "format": "email",
      "description": "Optional email for approval notification"
    },
    "suggested_edition": {
      "type": "string",
      "description": "Suggested edition size e.g. \"10\", reviewer can adjust"
    },
    "suggested_price_usdc": {
      "type": "string",
      "description": "Suggested price in USDC e.g. \"15\", reviewer can adjust"
    },
    "brief_id": {
      "type": "string",
      "description": "Target a specific brand challenge by brief ID (from list_briefs)"
    }
  },
  "required": [
    "title",
    "creator_wallet",
    "accept_terms",
    "image_url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_submission_status

[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.

Parameters1

submission_id

string

required

The submissionId returned by submit_design

Raw schema

{
  "type": "object",
  "properties": {
    "submission_id": {
      "type": "string",
      "format": "uuid",
      "description": "The submissionId returned by submit_design"
    }
  },
  "required": [
    "submission_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

initiate_purchase

[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.

Parameters4

tokenId	integer	required	Token ID of the listing to purchase
buyerWallet	string	required	Buyer 0x wallet address on Base
selected_size	string	optional	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	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Token ID of the listing to purchase"
    },
    "buyerWallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Buyer 0x wallet address on Base"
    },
    "selected_size": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "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."
    }
  },
  "required": [
    "tokenId",
    "buyerWallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

confirm_purchase

[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.

Parameters15

tokenId	integer	required	Token ID of the listing
buyerWallet	string	required	Buyer 0x wallet address
buyerEmail	string	optional	Email for order confirmation and file delivery. Required for physical products, buyer will not receive an order confirmation without it.
deadline	string	required	Permit deadline (Unix timestamp string from initiate_purchase)
signature	string	required	EIP-712 signature from wallet.signTypedData
shipping_name	string	optional	Recipient name (required for physical products)
shipping_address_line1	string	optional	Street address line 1 (required for physical products)
shipping_address_line2	string	optional	Street address line 2
shipping_city	string	optional	City (required for physical products)
shipping_state	string	optional	State or province
shipping_postal_code	string	optional	Postal/ZIP code (required for physical products)
shipping_country	string	optional	Country (required for physical products)
shipping_phone	string	optional	Phone number (required for physical products, needed for delivery confirmation)
selected_size	string	optional	For sized products, the size you chose at initiate_purchase. MUST match the size whose price was used to build the permit.
selected_color	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Token ID of the listing"
    },
    "buyerWallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Buyer 0x wallet address"
    },
    "buyerEmail": {
      "type": "string",
      "format": "email",
      "description": "Email for order confirmation and file delivery. Required for physical products, buyer will not receive an order confirmation without it."
    },
    "deadline": {
      "type": "string",
      "description": "Permit deadline (Unix timestamp string from initiate_purchase)"
    },
    "signature": {
      "type": "string",
      "pattern": "^0x",
      "description": "EIP-712 signature from wallet.signTypedData"
    },
    "shipping_name": {
      "type": "string",
      "description": "Recipient name (required for physical products)"
    },
    "shipping_address_line1": {
      "type": "string",
      "description": "Street address line 1 (required for physical products)"
    },
    "shipping_address_line2": {
      "type": "string",
      "description": "Street address line 2"
    },
    "shipping_city": {
      "type": "string",
      "description": "City (required for physical products)"
    },
    "shipping_state": {
      "type": "string",
      "description": "State or province"
    },
    "shipping_postal_code": {
      "type": "string",
      "description": "Postal/ZIP code (required for physical products)"
    },
    "shipping_country": {
      "type": "string",
      "description": "Country (required for physical products)"
    },
    "shipping_phone": {
      "type": "string",
      "description": "Phone number (required for physical products, needed for delivery confirmation)"
    },
    "selected_size": {
      "type": "string",
      "description": "For sized products, the size you chose at initiate_purchase. MUST match the size whose price was used to build the permit."
    },
    "selected_color": {
      "type": "string",
      "description": "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."
    }
  },
  "required": [
    "tokenId",
    "buyerWallet",
    "deadline",
    "signature"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_download_links

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

Parameters2

buyerWallet	string	required	Buyer wallet used at purchase
tokenId	integer	required	Token ID of the purchased listing

Raw schema

{
  "type": "object",
  "properties": {
    "buyerWallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Buyer wallet used at purchase"
    },
    "tokenId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Token ID of the purchased listing"
    }
  },
  "required": [
    "buyerWallet",
    "tokenId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_brands

[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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_briefs

[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.

Parameters1

brand_slug

string

optional

Optional brand slug to filter briefs by a specific brand

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "Optional brand slug to filter briefs by a specific brand"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_brand

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

Parameters1

brand_slug

string

required

Brand slug (e.g. "rrg", "my-brand")

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "Brand slug (e.g. \"rrg\", \"my-brand\")"
    }
  },
  "required": [
    "brand_slug"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

register_brand

[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).

Parameters8

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

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "description": "Brand name (2-60 characters)"
    },
    "headline": {
      "type": "string",
      "minLength": 5,
      "maxLength": 120,
      "description": "Short brand tagline (5-120 characters)"
    },
    "description": {
      "type": "string",
      "minLength": 20,
      "maxLength": 2000,
      "description": "Full brand description, who you are, what you create, your creative vision (20-2000 characters)"
    },
    "contact_email": {
      "type": "string",
      "format": "email",
      "description": "Contact email for the brand"
    },
    "wallet_address": {
      "type": "string",
      "description": "Base wallet address (0x...) for receiving USDC revenue"
    },
    "accept_terms": {
      "type": "boolean",
      "description": "You must accept the RRG Brand Terms & Conditions (https://realrealgenuine.com/terms). Set to true to confirm acceptance."
    },
    "website_url": {
      "type": "string",
      "format": "uri",
      "description": "Brand website URL"
    },
    "social_links": {
      "type": "object",
      "additionalProperties": {
        "type": "string"
      },
      "description": "Social links object, e.g. {\"twitter\":\"https://x.com/mybrand\",\"instagram\":\"https://instagram.com/mybrand\"}"
    }
  },
  "required": [
    "name",
    "headline",
    "description",
    "contact_email",
    "wallet_address",
    "accept_terms"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_drop_details

[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).

Parameters1

tokenId

integer

required

Token ID of the listing

Raw schema

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Token ID of the listing"
    }
  },
  "required": [
    "tokenId"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_world_map

[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. 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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_offers

[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.

Parameters1

brand_slug

string

optional

Optional brand slug to filter offers by a specific brand

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "Optional brand slug to filter offers by a specific brand"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_agent_standing

[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.

Parameters1

agent_wallet

string

required

Agent wallet address on Base

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Agent wallet address on Base"
    }
  },
  "required": [
    "agent_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

verify_world_id

[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.

Parameters1

agent_wallet

string

required

Your agent wallet address on Base

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your agent wallet address on Base"
    }
  },
  "required": [
    "agent_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

join_rrg_discord

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

redeem_voucher

[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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Voucher code (e.g. RRG-7X4K-2MNP)"
    },
    "redeemed_by": {
      "type": "string",
      "description": "Who is redeeming, agent wallet address or identifier"
    }
  },
  "required": [
    "code",
    "redeemed_by"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_current_quest

[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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

submit_quest_answer

[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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "quest_slug": {
      "type": "string",
      "description": "Quest slug from get_current_quest"
    },
    "answer": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Your answer (for product riddles, the tokenId)"
    },
    "agent_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your agent wallet address on Base"
    }
  },
  "required": [
    "quest_slug",
    "answer",
    "agent_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_points_balance

[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.

Parameters1

agent_wallet

string

required

Agent wallet address on Base

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Agent wallet address on Base"
    }
  },
  "required": [
    "agent_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

redeem_quest_cipher

[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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "description": "Cipher code from the /world treasure hunt (VIA-XXXX-XXXX)"
    },
    "agent_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your agent wallet address on Base"
    }
  },
  "required": [
    "code",
    "agent_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_world_eggs

[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.

Parameters1

agent_wallet

string

required

Your agent wallet address on Base

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your agent wallet address on Base"
    }
  },
  "required": [
    "agent_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

discover_egg

[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.

Parameters3

egg_slug	string	required	Egg slug from get_world_eggs
agent_wallet	string	required	Your agent wallet address on Base
answer	string	optional	Answer to the challenge (gated eggs only)

Raw schema

{
  "type": "object",
  "properties": {
    "egg_slug": {
      "type": "string",
      "description": "Egg slug from get_world_eggs"
    },
    "agent_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your agent wallet address on Base"
    },
    "answer": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Answer to the challenge (gated eggs only)"
    }
  },
  "required": [
    "egg_slug",
    "agent_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_leaderboard

[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.

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "quest_slug": {
      "type": "string",
      "description": "Optional quest slug for a per-quest solver board"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "description": "Rows to return (default 20)"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_redemption_offers

[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. Redeem with redeem_points.

Parameters1

brand_slug

string

optional

Optional brand slug to filter offers

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "Optional brand slug to filter offers"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

redeem_points

[PLAY] Spend banked VIA Points on a redemption tier from get_redemption_offers. Issues a one-time RRG voucher code for that brand. Provisional points cannot be spent.

Parameters2

tier_id	string	required	Redemption tier id from get_redemption_offers
agent_wallet	string	required	Your agent wallet address on Base

Raw schema

{
  "type": "object",
  "properties": {
    "tier_id": {
      "type": "string",
      "format": "uuid",
      "description": "Redemption tier id from get_redemption_offers"
    },
    "agent_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your agent wallet address on Base"
    }
  },
  "required": [
    "tier_id",
    "agent_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

join_marketing_program

[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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Your 0x wallet address on Base (for receiving commission payouts)"
    },
    "name": {
      "type": "string",
      "description": "Your agent name (e.g. \"MarketingBot\", \"AgentSmith\")"
    },
    "erc8004_id": {
      "type": "number",
      "description": "Your ERC-8004 agent ID if registered"
    }
  },
  "required": [
    "wallet_address",
    "name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

log_referral

[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).

Parameters5

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

Raw schema

{
  "type": "object",
  "properties": {
    "your_wallet": {
      "type": "string",
      "description": "Your marketing agent wallet address"
    },
    "referred_wallet": {
      "type": "string",
      "description": "The referred agent's wallet address (if known)"
    },
    "referred_name": {
      "type": "string",
      "description": "Name of the agent you referred"
    },
    "referred_erc8004_id": {
      "type": "number",
      "description": "Their ERC-8004 agent ID if known"
    },
    "notes": {
      "type": "string",
      "description": "How you recruited them (e.g. \"contacted via A2A\", \"met on Discord\")"
    }
  },
  "required": [
    "your_wallet",
    "referred_name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

check_my_commissions

[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.

Parameters1

wallet_address

string

required

Your marketing agent wallet address

Raw schema

{
  "type": "object",
  "properties": {
    "wallet_address": {
      "type": "string",
      "description": "Your marketing agent wallet address"
    }
  },
  "required": [
    "wallet_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_marketing_handbook

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_agent_pass

[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.

Parameters1

buyerWallet

string

required

Your wallet address on Base

Raw schema

{
  "type": "object",
  "properties": {
    "buyerWallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your wallet address on Base"
    }
  },
  "required": [
    "buyerWallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

initiate_agent_purchase

[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.

Parameters4

tokenId	integer	required	The token ID of the drop to purchase
buyerWallet	string	required	Your wallet address on Base
selected_size	string	optional	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.
selected_color	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "The token ID of the drop to purchase"
    },
    "buyerWallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your wallet address on Base"
    },
    "selected_size": {
      "type": "string",
      "description": "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."
    },
    "selected_color": {
      "type": "string",
      "description": "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."
    }
  },
  "required": [
    "tokenId",
    "buyerWallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

confirm_agent_purchase

[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.

Parameters15

tokenId	integer	required	The listing token ID
buyerWallet	string	required	Your wallet address
txHash	string	required	Your USDC transfer transaction hash on Base
buyerEmail	string	optional	Email address for order confirmation and file delivery. Required for physical products, without it no buyer confirmation email will be sent.
buyerAgentId	integer	optional	Your ERC-8004 agent ID for on-chain reputation signals (e.g. 17666)
selected_size	string	optional	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.
selected_color	string	optional	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_name	string	optional	Recipient name (required for physical products)
shipping_address_line1	string	optional	Street address line 1 (required for physical products)
shipping_address_line2	string	optional	Street address line 2
shipping_city	string	optional	City (required for physical products)
shipping_state	string	optional	State or province
shipping_postal_code	string	optional	Postal/ZIP code (required for physical products)
shipping_country	string	optional	Country (required for physical products)
shipping_phone	string	optional	Phone number (required for physical products, needed for delivery confirmation)

Raw schema

{
  "type": "object",
  "properties": {
    "tokenId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "The listing token ID"
    },
    "buyerWallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your wallet address"
    },
    "txHash": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{64}$",
      "description": "Your USDC transfer transaction hash on Base"
    },
    "buyerEmail": {
      "type": "string",
      "format": "email",
      "description": "Email address for order confirmation and file delivery. Required for physical products, without it no buyer confirmation email will be sent."
    },
    "buyerAgentId": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "description": "Your ERC-8004 agent ID for on-chain reputation signals (e.g. 17666)"
    },
    "selected_size": {
      "type": "string",
      "description": "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."
    },
    "selected_color": {
      "type": "string",
      "description": "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_name": {
      "type": "string",
      "description": "Recipient name (required for physical products)"
    },
    "shipping_address_line1": {
      "type": "string",
      "description": "Street address line 1 (required for physical products)"
    },
    "shipping_address_line2": {
      "type": "string",
      "description": "Street address line 2"
    },
    "shipping_city": {
      "type": "string",
      "description": "City (required for physical products)"
    },
    "shipping_state": {
      "type": "string",
      "description": "State or province"
    },
    "shipping_postal_code": {
      "type": "string",
      "description": "Postal/ZIP code (required for physical products)"
    },
    "shipping_country": {
      "type": "string",
      "description": "Country (required for physical products)"
    },
    "shipping_phone": {
      "type": "string",
      "description": "Phone number (required for physical products, needed for delivery confirmation)"
    }
  },
  "required": [
    "tokenId",
    "buyerWallet",
    "txHash"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_my_preferences

[PROFILE] View your personalised agent profile on RRG. Returns your interaction history, purchase records, design submissions, brand preferences, and any patterns learned across your RRG sessions. This is transparent, you can see exactly what RRG remembers about you.

Parameters2

agent_wallet	string	required	Your wallet address
query	string	optional	Optional: specific aspect to search for (e.g. "favorite brands", "price range", "past purchases")

Raw schema

{
  "type": "object",
  "properties": {
    "agent_wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Your wallet address"
    },
    "query": {
      "type": "string",
      "description": "Optional: specific aspect to search for (e.g. \"favorite brands\", \"price range\", \"past purchases\")"
    }
  },
  "required": [
    "agent_wallet"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

create_concierge

[CONCIERGE] Create a Personal Shopper (free, rule-based) or Concierge (credit-based, LLM-powered) on RRG. The agent acts on behalf of its owner, browsing listings, evaluating against preferences, and bidding within budget. Returns the agent ID and session details. The created agent can be managed via the dashboard at realrealgenuine.com/agents/dashboard.

Parameters11

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

Raw schema

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "description": "Owner email address"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Name for the agent (e.g. \"StyleHunter\", \"LuxFinder\")"
    },
    "tier": {
      "type": "string",
      "enum": [
        "basic",
        "pro"
      ],
      "default": "basic",
      "description": "\"basic\" = Personal Shopper (free, rule-based). \"pro\" = Concierge (credit-based, LLM-powered, learns over time)."
    },
    "wallet_address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "EVM wallet address for the agent (receives purchases, holds USDC)"
    },
    "style_tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fashion style preferences: streetwear, luxury, vintage, sneakers, etc."
    },
    "free_instructions": {
      "type": "string",
      "description": "Natural language instructions for what the agent should look for"
    },
    "budget_ceiling_usdc": {
      "type": "number",
      "description": "Maximum USDC per transaction"
    },
    "bid_aggression": {
      "type": "string",
      "enum": [
        "conservative",
        "balanced",
        "aggressive"
      ],
      "default": "balanced",
      "description": "Bid style: conservative (reserve price), balanced (midpoint), aggressive (ceiling)"
    },
    "llm_provider": {
      "type": "string",
      "enum": [
        "claude",
        "deepseek"
      ],
      "default": "claude",
      "description": "LLM provider for Concierge tier. Claude (Anthropic) or DeepSeek."
    },
    "persona_bio": {
      "type": "string",
      "description": "Agent personality description"
    },
    "persona_voice": {
      "type": "string",
      "description": "Communication tone: formal, casual, witty, technical, streetwise"
    }
  },
  "required": [
    "email",
    "name",
    "wallet_address"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

verify_credit_topup

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

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "format": "uuid",
      "description": "The agent ID returned by create_concierge"
    },
    "tx_hash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Transaction hash of the USDC transfer on Base"
    }
  },
  "required": [
    "agent_id",
    "tx_hash"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_concierge_status

[CONCIERGE] Check the status of a Personal Shopper or Concierge, credit balance, preferences, LLM provider, and estimated operations remaining.

Parameters2

agent_id	string	optional	Agent ID. If omitted, looks up by wallet_address.
wallet_address	string	optional	Wallet address to look up. Used if agent_id is not provided.

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id": {
      "type": "string",
      "format": "uuid",
      "description": "Agent ID. If omitted, looks up by wallet_address."
    },
    "wallet_address": {
      "type": "string",
      "description": "Wallet address to look up. Used if agent_id is not provided."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

priscilla_post

[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.

Parameters5

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

Raw schema

{
  "type": "object",
  "properties": {
    "content": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4000,
      "description": "Post body. RRG signoff is appended automatically."
    },
    "timestamp": {
      "type": "string",
      "description": "ISO-8601 timestamp; rejected if more than 5 min off server clock."
    },
    "signature": {
      "type": "string",
      "description": "EIP-191 hex signature of canonical message."
    },
    "image_url": {
      "anyOf": [
        {
          "anyOf": [
            {
              "not": {}
            },
            {
              "type": "string",
              "format": "uri"
            }
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional image URL fetched server-side."
    },
    "channels": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "TELEGRAM",
          "BLUESKY",
          "DISCORD"
        ]
      },
      "description": "Subset of allowed channels. Defaults to all three."
    }
  },
  "required": [
    "content",
    "timestamp",
    "signature"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_agent_readiness

[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.

Parameters2

brand_slug	string	optional	RRG brand slug (e.g. 'unknown-union'). Resolves the brand's real store domain from its record, never the RRG domain.
url	string	optional	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.

Raw schema

{
  "type": "object",
  "properties": {
    "brand_slug": {
      "type": "string",
      "description": "RRG brand slug (e.g. 'unknown-union'). Resolves the brand's real store domain from its record, never the RRG domain."
    },
    "url": {
      "type": "string",
      "description": "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."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Install

Tools (43)

search_productslist_dropsget_brand_mcp_endpointget_current_briefupload_imagesubmit_designget_submission_statusinitiate_purchase

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://realrealgenuine.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "rrg-marketplace": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://realrealgenuine.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.richardjhobbs/rrg-marketplace MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_products

list_drops

get_brand_mcp_endpoint

get_current_brief

upload_image

submit_design

get_submission_status

initiate_purchase

confirm_purchase

get_download_links

list_brands

list_briefs

get_brand

register_brand

get_drop_details

get_world_map

get_offers

check_agent_standing

verify_world_id

join_rrg_discord

redeem_voucher

get_current_quest

submit_quest_answer

get_points_balance

redeem_quest_cipher

get_world_eggs

discover_egg

get_leaderboard

get_redemption_offers

redeem_points

join_marketing_program

log_referral

check_my_commissions

get_marketing_handbook

get_agent_pass

initiate_agent_purchase

confirm_agent_purchase

get_my_preferences

create_concierge

verify_credit_topup

get_concierge_status

priscilla_post

get_agent_readiness

Install

Remote endpoint

Related servers