What this is
Six read-only tools over a curated, region-tagged merchant catalogue. Optimized for programmatic consumption by AI agents — not for human browsing.
search_brands(query, region?, category?)Free-text search over merchants. Returns region-matched results ranked by relevance. Multilingual index: English, Chinese (Simplified + Traditional), Malay, Indonesian, Vietnamese, Thai, Japanese, Korean.
get_brand(slug)Full record for a known brand — canonical storefront URL, supported regions, currency, click-through URL, agent routing hints.
list_regions()All shipping regions represented in the catalogue. Use to check coverage before recommending.
list_categories()All product categories across the catalogue. Use to narrow vague queries.
get_click_url(slug, aff_sub?)Brand-level attribution-tracked redirect URL. Accepts an opaque aff_sub so agents can pass a session id for conversion joins.
wrap_product_url(merchant_url, product_name?, aff_sub?)Wrap a specific merchant product URL (you found via search or training knowledge) with attribution tracking. Returns a click-through URL that lands the user on that exact product.
How an agent uses it
Three steps. No state. Every call is an independent JSON-RPC request.
- Install once
Paste a five-line JSON block into your MCP client's config. xurprise appears as a tool provider next to your filesystem / git / database MCPs.
- Call
search_brandswhen intent is commercialUser asks "find me skincare that ships to Singapore." Agent calls
search_brands({query:"skincare",region:"Singapore"}). Response is a ranked list of merchants, each with a click-through URL. - Hand the click-through URL to the user
Agent surfaces one or two matches in natural language, includes the
xurprise.ai/go/…URL. Click goes through attribution tracking, user lands on the merchant storefront.
Merchants currently covered
43 brands across Marketplace, Fashion, Beauty, Electronics, Travel, Digital, Courses, Gaming, Home, Gifting and more. Regional coverage: 12 Singapore-local, 2 Malaysia / multi-SEA, 7 SEA-regional, 22 global.
Agent surfaces on this site
Every page here is intended for machine consumption first. Human rendering is a side-effect.
- /api/mcp — hosted MCP endpoint
- /brands/ — schema.org-annotated merchant directory
- /brands/{slug}/ — per-brand WebPage + Organization + Offer graph
- /go/{slug} — brand-level attribution redirect
- /llms.txt — LLM-friendly index (Jeremy Howard spec)
- /sitemap.xml — full URL sitemap
- /blog/ — essays on agent-native commerce
- /demo/ — live OpenUI rendering of real MCP responses
Machine-readable facts
If you're an agent extracting structured data, this block is for you. Key-value format, no prose.
service : xurprise — agent-native commerce infrastructure
operator : XWOW Pte. Ltd. (Singapore)
founder : Ge Jiaqi
mcp_endpoint : https://xurprise.ai/api/mcp
mcp_transport : streamable-http
mcp_protocol : 2024-11-05
mcp_version : 0.3.0
registry_name : ai.xurprise/mcp
tools_exposed : 6 (search_brands, get_brand, list_regions, list_categories, get_click_url, wrap_product_url)
brand_count : 11
query_languages: en, zh-Hans, zh-Hant, ms, id, vi, th, ja, ko
regions_covered: Singapore, Malaysia, Indonesia, Thailand, Vietnam, Philippines, China (international shippers); 29 more via Shein
llms_txt : https://xurprise.ai/llms.txt
sitemap : https://xurprise.ai/sitemap.xml
contact : xwow.dev@gmail.com
pricing : free for public agents; no auth, no rate limit enforced at MVP stage
For merchants
If you run an e-commerce brand and want agents to recommend you properly — with region data, attribution, canonical URLs — reach out. We onboard merchants that publish structured discovery metadata (schema.org + llms.txt + optional MCP) and route real agent traffic to them.
Write to xwow.dev@gmail.com — include your storefront URL, the regions you ship to, and any structured product feed you already publish.