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> for developer clients and automation; Claude.ai and ChatGPT connectors use OAuth instead — see Connectors
• Token format — vbl_pat_live_... (production) or vbl_pat_test_... (non-production)
• Protocol version — MCP 2025-11-25
• Plan — most tools need Starter or higher; optimize, content, social posts, product videos and insights need Growth. ping, credits.check, the catalog tools, brand_dna.get and the drop read tools 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

75 tools cover the full brand-operating loop, organized into 17 workflow domains:

• Utility (1) — ping
• Catalog (3) — catalog.list_blanks, catalog.get_blank, catalog.compare_blanks
• Brand DNA (3) — brand_dna.get, brand_dna.set, brand_dna.list_audience_presets
• Credits (3) — credits.check, credits.list_costs, credits.list_usage
• Designs (7) — design.generate, design.edit, design.get_generation, design.list, design.get, design.get_history, design.submit_feedback
• Mockups (8) — mockup.generate, mockup.get_generation, mockup.list, mockup.get, mockup.show, mockup.update_selection, mockup.submit_feedback, mockup.retry
• Virtual Models (3) — virtual_model.list, virtual_model.generate, virtual_model.get_generation
• Listings (10) — listing.create, listing.get, listing.list, listing.update, listing.regenerate_field, listing.publish, listing.delete, listing.get_generation, listing.list_warehouses, listing.sync_warehouses
• Content (4) — content.generate, content.get, content.list, content.delete
• Trends (8) — trend.list, trend.get, trend.list_keywords, trend.get_keyword, trend.generate_concept, trend.get_generation, trend.record_outcome, trend.list_seasonal_events
• Insights (3) — insight.get_overview, insight.list_design_performance, insight.get_guidance
• Integrations (1) — integration.list
• Optimize Product (6) — optimize.list_providers, optimize.list_provider_products, optimize.check_duplicate, optimize.import_product, optimize.refresh_listing, optimize.get_generation
• Workspace (1) — workspace.open
• Product Video (2) — product_video.generate, product_video.get_generation
• Social Post (5) — social_post.generate, social_post.list, social_post.update, social_post.publish, social_post.get
• Drop (7) — drop.list, drop.get, drop.create, drop.update, drop.attach, drop.related_trends, drop.pin_trend

Every tool has its own page in the Tool Reference, with its fields, an example call, credit cost and rate limit.

Credits

Generation costs credits, from the same balance your dashboard uses. Most generation is charged when it succeeds, so a failed render costs nothing. Check your balance any time with credits.check; each tool's page shows its cost, and the full table is in Credit Charging.

What's Next