Vaybel MCP Server

What It Is

The Vaybel MCP server lets MCP-capable clients — Claude, ChatGPT, Gemini, or any custom agent — drive your Vaybel workspace directly over the Model Context Protocol. Connect once with a Personal Access Token and your agent can find trends, generate designs, render mockups and virtual try-ons, make product videos, build multi-format social content (video, slideshow, carousel, single photo), publish listings to Etsy/Shopify/TikTok Shop, publish posts to TikTok / Instagram / YouTube / X, import products you already have on Printify or Printful, and read performance insights — everything in between.

Connection Details

• Endpoint — https://mcp.vaybel.com/
• Transport — Streamable HTTP (the MCP spec transport; responses stream as SSE)
• Auth — Authorization: Bearer <PAT>
• Token format — vbl_pat_live_... (production) or vbl_pat_test_... (non-production)
• Protocol version — MCP 2024-11-05
• Plan — Starter or higher (Growth for optimize / content / social / insights); ping and credits.check work on any plan

The Async Contract

Generation tools return {handle, status, message} immediately. Poll the matching <domain>.get_generation(handle, wait_sec) (or content.get for content) until done is true. wait_sec long-polls up to 50 seconds per call — re-poll for longer jobs. progress is always a 0.0–1.0 fraction.

Billable tools accept an optional idempotency_key: send the same key when retrying a call and the replay returns the cached result instead of re-executing or re-billing.

Tools At A Glance

60 tools cover the full brand-operating loop, organized into 14 workflow domains:

Utility & meta

• Utility — ping
• Brand DNA (3) — brand_dna.get, brand_dna.set, brand_dna.list_audience_presets
• Catalog — catalog.list_blanks
• Credits (3) — credits.check, credits.list_costs, credits.list_usage

Create

• Designs (5) — design.generate, design.get_generation, design.list, design.get, design.get_history
• Mockups (7) — mockup.generate, mockup.get_generation, mockup.list, mockup.get, mockup.update_selection, mockup.submit_feedback, mockup.retry
• Virtual Models (3) — virtual_model.generate, virtual_model.get_generation, virtual_model.list — audience-keyed models that power virtual try-on mockups.
• Product Videos (2) — product_video.generate, product_video.get_generation — listing showcase clips rendered from try-on mockups.
• Content (4, Growth) — multi-format content generation and status. Generate: content.generate (video / slideshow / carousel / single), then read content.get, content.list, or remove with content.delete.
• Social posts (5, Growth) — publish to TikTok / Instagram / YouTube / X with social_post.generate, social_post.get, social_post.list, social_post.update, social_post.publish.

Publish

• Listings (9) — listing.create, listing.get, listing.list, listing.update, listing.regenerate_field, listing.publish, listing.delete, listing.get_generation, listing.list_warehouses

Discover & learn

• Trends (8) — named trends first: trend.list, trend.get; keyword drill-down: trend.list_keywords, trend.get_keyword; concepts and signals: trend.generate_concept, trend.get_generation, trend.submit_feedback, trend.list_seasonal_events
• Optimize Product (6, Growth) — optimize.list_providers, optimize.list_provider_products, optimize.check_duplicate, optimize.run, optimize.refresh_listing, optimize.get_generation
• Insights (3, Growth) — insight.get_overview, insight.list_design_performance, insight.get_guidance

Full signatures, return shapes, credit costs, and rate limits are in the Tool Reference.

Credits

Generation costs credits (e.g. a design is 10, a mockup is 2 per render, a product video is 20 — billed by the worker on success, so failed renders aren't charged). Check your balance any time with credits.check; the full per-tool cost table lives in Authentication & Limits.

What's Next