Wix MCP Documentation Navigator
Pre-indexed recipe catalog with inline routing. Optimized for parallelism:
single-recipe domains need 0 file reads, multi-recipe domains need 1.
Rules
- NEVER call
BrowseWixRESTDocsMenu without a deep menuUrl (107K+ chars)
- Quick facts first — if facts fully answer the question, 0 MCP calls
- Selective Related — only read Related articles relevant to the question
- Maximize parallelism — use the parallel patterns below
Domain Routing
Recipe base: https://dev.wix.com/docs/picasso/wix-ai-docs/recipes-v2/manage
Instant recipes (0 file reads — call ReadFullDocsArticle directly)
| Keywords |
URL (append to base) |
| blog, post, article, publish post |
/blog/recipe-how-to-create-blog-posts-rest |
| upload image, media manager, import file |
/media/recipe-upload-media-to-wix |
| event, ticket, RSVP, list events |
/events/recipe-list-events |
| restaurant, menu, food, dishes |
/restaurants/recipe-wix-restaurants-setup |
| pricing plan, subscription, membership |
/pricing-plans/recipe-create-and-update-pricing-plans |
| ricos, rich content, html to ricos |
/rich-content/recipe-ricos-converter-service |
Call ReadFullDocsArticle(base + path) immediately — no file read needed.
If question doesn't match, read recipe file for fallback search terms.
Multi-recipe domains (1 file read)
| Keywords |
Recipe file |
| products, catalog, store, shop, cart, checkout, order, ecommerce |
stores |
| appointment, booking, staff, schedule, hours, class, course |
bookings |
| collection, data, CMS, database, items |
cms |
| payment, invoice, charge, link, credit card |
payments |
| contact, lead, CRM, customer, label |
contacts |
| site, create site, domain, currency, timezone |
sites |
| install app, velo, wix code |
platform |
Read ~/.claude/skills/wix-mcp/recipes/<name>.md to find the matching recipe.
SDK or Headless?
- SDK/client-side →
SearchWixSDKDocumentation(keywords) → DONE
- Headless/external →
SearchWixHeadlessDocumentation(keywords) → DONE
Decision Flow
Instant recipe domain
ReadFullDocsArticle(base + path) + log.sh RECIPE_HIT — in parallel. DONE.
Multi-recipe domain
- Read recipe file (OPTIONAL: + speculative
SearchWixRESTDocumentation in parallel)
- Quick facts answer fully? → Return facts, log
FACT_CACHE_HIT, DONE
- Recipe found + Related →
ReadFullDocsArticle(recipe + relevant Related) IN PARALLEL, log RECIPE_HIT, DONE
- Recipe found, no Related →
ReadFullDocsArticle(recipe URL) + log — parallel, DONE
- No recipe → use speculative search result if available, or
SearchWixRESTDocumentation(Fallback terms), log RECIPE_MISS
→ Found article? → ReadFullDocsArticle(URL), DONE
→ Nothing? → WixREADME(), log README_FALLBACK, DONE
Parallel Patterns
Pattern 1: Instant recipe (fastest — 1 turn, 0 reads)
ReadFullDocsArticle(inline URL) + log.sh RECIPE_HIT → parallel
Pattern 2: Speculative search (matches raw MCP speed)
For multi-recipe domains, fire recipe file Read + SearchWixRESTDocumentation
in parallel. RECIPE_MISS has zero additional latency.
Read recipes/<domain>.md + SearchWixRESTDocumentation(keywords) → parallel
Recipe hit → discard search, use recipe URL
Recipe miss → search result already available, no wait
Trade-off: wastes ~750 tokens on recipe hits. Use when speed > token savings.
Pattern 3: Cluster parallel read
Recipe has Related articles. Fire all reads simultaneously.
ReadFullDocsArticle(recipe) + ReadFullDocsArticle(related1) + ReadFullDocsArticle(related2) + log.sh → all parallel
Only include Related articles relevant to the specific question.
Pattern 4: Multi-domain or SDK+REST
Read recipes/stores.md + Read recipes/bookings.md → parallel
SearchWixSDKDocumentation(kw) + SearchWixRESTDocumentation(kw) → parallel
Sequential only
SearchWixRESTDocumentation → ReadFullDocsArticle (need URL)ReadFullDocsArticle → ReadFullDocsMethodSchema (only if no examples)
Tool Quick Reference
| Situation |
Use |
Avoid |
| Quick facts answer question |
Return facts (0 MCP) |
ReadFullDocsArticle |
| Instant recipe domain |
ReadFullDocsArticle (inline URL) |
Recipe file read |
| Recipe + Related |
ReadFullDocsArticle x N parallel |
Sequential reads |
| Recipe, no Related |
ReadFullDocsArticle (recipe URL) |
WixREADME |
| No recipe |
SearchWixRESTDocumentation |
BrowseWixRESTDocsMenu |
| No examples, need schema |
ReadFullDocsMethodSchema |
BrowseWixRESTDocsMenu |
| SDK docs |
SearchWixSDKDocumentation |
SearchWixRESTDocumentation |
| Headless docs |
SearchWixHeadlessDocumentation |
|
Logging
~/.claude/skills/wix-mcp/scripts/log.sh <EVENT> <DOMAIN> "<DETAIL>"
Always run log calls in parallel with MCP reads — they are independent.
Events: RECIPE_HIT, RECIPE_MISS, FACT_CACHE_HIT, README_FALLBACK,
BROWSE_AVOIDED, BROWSE_USED
Maintenance
Run /update-wix-recipes when log shows frequent README_FALLBACK events.
For single-recipe domains, also update inline URLs in this file.
Reference Files (rarely needed)
- recipes/ — Per-domain recipe files (1 per query max)
- domain-routing.md — Deep menu URLs (last resort only)
- decision-tree.md — Detailed decision flowchart
- README.md — Benchmarks, log evaluation, maintenance
1---2name: wix-mcp3description: Efficient navigator for Wix MCP documentation tools. Use this skill when an agent needs to find Wix API documentation, code examples, method schemas, or recipes covering stores, products, bookings, appointments, blog posts, CMS collections, events, pricing plans, restaurants, contacts, CRM, media uploads, payments, eCommerce, or any Wix platform API. Provides a pre-indexed recipe catalog and domain routing to minimize token usage and unnecessary MCP calls.4---56# Wix MCP Documentation Navigator78Pre-indexed recipe catalog with inline routing. Optimized for parallelism:9single-recipe domains need 0 file reads, multi-recipe domains need 1.1011## Rules12131. **NEVER** call `BrowseWixRESTDocsMenu` without a deep `menuUrl` (107K+ chars)142. **Quick facts first** — if facts fully answer the question, 0 MCP calls153. **Selective Related** — only read Related articles relevant to the question164. **Maximize parallelism** — use the parallel patterns below1718## Domain Routing1920Recipe base: `https://dev.wix.com/docs/picasso/wix-ai-docs/recipes-v2/manage`2122### Instant recipes (0 file reads — call ReadFullDocsArticle directly)2324| Keywords | URL (append to base) |25|----------|----------------------|26| blog, post, article, publish post | `/blog/recipe-how-to-create-blog-posts-rest` |27| upload image, media manager, import file | `/media/recipe-upload-media-to-wix` |28| event, ticket, RSVP, list events | `/events/recipe-list-events` |29| restaurant, menu, food, dishes | `/restaurants/recipe-wix-restaurants-setup` |30| pricing plan, subscription, membership | `/pricing-plans/recipe-create-and-update-pricing-plans` |31| ricos, rich content, html to ricos | `/rich-content/recipe-ricos-converter-service` |3233Call `ReadFullDocsArticle(base + path)` immediately — no file read needed.34If question doesn't match, read recipe file for fallback search terms.3536### Multi-recipe domains (1 file read)3738| Keywords | Recipe file |39|----------|-------------|40| products, catalog, store, shop, cart, checkout, order, ecommerce | `stores` |41| appointment, booking, staff, schedule, hours, class, course | `bookings` |42| collection, data, CMS, database, items | `cms` |43| payment, invoice, charge, link, credit card | `payments` |44| contact, lead, CRM, customer, label | `contacts` |45| site, create site, domain, currency, timezone | `sites` |46| install app, velo, wix code | `platform` |4748Read `~/.claude/skills/wix-mcp/recipes/<name>.md` to find the matching recipe.4950### SDK or Headless?51- SDK/client-side → `SearchWixSDKDocumentation(keywords)` → DONE52- Headless/external → `SearchWixHeadlessDocumentation(keywords)` → DONE5354## Decision Flow5556### Instant recipe domain57`ReadFullDocsArticle(base + path)` + `log.sh RECIPE_HIT` — in parallel. DONE.5859### Multi-recipe domain601. Read recipe file (OPTIONAL: + speculative `SearchWixRESTDocumentation` in parallel)612. Quick facts answer fully? → Return facts, log `FACT_CACHE_HIT`, DONE623. Recipe found + Related → `ReadFullDocsArticle(recipe + relevant Related)` IN PARALLEL, log `RECIPE_HIT`, DONE634. Recipe found, no Related → `ReadFullDocsArticle(recipe URL)` + log — parallel, DONE645. No recipe → use speculative search result if available, or `SearchWixRESTDocumentation(Fallback terms)`, log `RECIPE_MISS`65 → Found article? → `ReadFullDocsArticle(URL)`, DONE66 → Nothing? → `WixREADME()`, log `README_FALLBACK`, DONE6768## Parallel Patterns6970### Pattern 1: Instant recipe (fastest — 1 turn, 0 reads)71```72ReadFullDocsArticle(inline URL) + log.sh RECIPE_HIT → parallel73```7475### Pattern 2: Speculative search (matches raw MCP speed)76For multi-recipe domains, fire recipe file Read + SearchWixRESTDocumentation77in parallel. RECIPE_MISS has zero additional latency.78```79Read recipes/<domain>.md + SearchWixRESTDocumentation(keywords) → parallel80 Recipe hit → discard search, use recipe URL81 Recipe miss → search result already available, no wait82```83Trade-off: wastes ~750 tokens on recipe hits. Use when speed > token savings.8485### Pattern 3: Cluster parallel read86Recipe has Related articles. Fire all reads simultaneously.87```88ReadFullDocsArticle(recipe) + ReadFullDocsArticle(related1) + ReadFullDocsArticle(related2) + log.sh → all parallel89```90Only include Related articles relevant to the specific question.9192### Pattern 4: Multi-domain or SDK+REST93```94Read recipes/stores.md + Read recipes/bookings.md → parallel95SearchWixSDKDocumentation(kw) + SearchWixRESTDocumentation(kw) → parallel96```9798### Sequential only99- `SearchWixRESTDocumentation` → `ReadFullDocsArticle` (need URL)100- `ReadFullDocsArticle` → `ReadFullDocsMethodSchema` (only if no examples)101102## Tool Quick Reference103104| Situation | Use | Avoid |105|-----------|-----|-------|106| Quick facts answer question | Return facts (0 MCP) | ReadFullDocsArticle |107| Instant recipe domain | ReadFullDocsArticle (inline URL) | Recipe file read |108| Recipe + Related | ReadFullDocsArticle x N parallel | Sequential reads |109| Recipe, no Related | ReadFullDocsArticle (recipe URL) | WixREADME |110| No recipe | SearchWixRESTDocumentation | BrowseWixRESTDocsMenu |111| No examples, need schema | ReadFullDocsMethodSchema | BrowseWixRESTDocsMenu |112| SDK docs | SearchWixSDKDocumentation | SearchWixRESTDocumentation |113| Headless docs | SearchWixHeadlessDocumentation | |114115## Logging116117```bash118~/.claude/skills/wix-mcp/scripts/log.sh <EVENT> <DOMAIN> "<DETAIL>"119```120Always run log calls in parallel with MCP reads — they are independent.121122Events: `RECIPE_HIT`, `RECIPE_MISS`, `FACT_CACHE_HIT`, `README_FALLBACK`,123`BROWSE_AVOIDED`, `BROWSE_USED`124125## Maintenance126127Run `/update-wix-recipes` when log shows frequent `README_FALLBACK` events.128For single-recipe domains, also update inline URLs in this file.129130## Reference Files (rarely needed)131132- [recipes/](recipes/) — Per-domain recipe files (1 per query max)133- [domain-routing.md](domain-routing.md) — Deep menu URLs (last resort only)134- [decision-tree.md](decision-tree.md) — Detailed decision flowchart135- [README.md](README.md) — Benchmarks, log evaluation, maintenance
QuentinEnhancementStudio