vibiz-mcp

Using the Vibiz MCP

The Vibiz MCP server is auto-configured by this plugin at https://www.vibiz.ai/api/mcp. After /plugin install, the user authenticates once via /mcp → vibiz → Authenticate, and from then on every Vibiz tool call is scoped to their workspace group via OAuth.

Quick start: post an image or video

The 95% workflow is list_vibiz → generate → poll → publish. Four tools, one runId threaded through.

One-time setup

1. /plugin install vibiz — auto-configures the MCP at https://www.vibiz.ai/api/mcp.
2. /mcp → vibiz → Authenticate → browser login (Clerk → WorkOS).
3. Connect a social account. If vibiz_social_list_accounts is empty, it returns a connectUrl — open it once to link IG/TikTok/etc.

No API keys to manage. OAuth scopes the token to the user's workspace group.

1. Get the brand slug

list_vibiz  →  [{ name, slug, websiteUrl, logoUrl }]

Pick the slug. This is the only ID you ever need to remember — pass it as target.vibiz on every call.

2. Generate the media

Image:

vibiz_generate_image({
  target: { vibiz: "<slug>" },
  prompt: "...",
  platform: "instagram_portrait",
})
// → { adId, runId, statusUrl, mcpGenerationUrl, viewUrl }

Video:

vibiz_generate_ad_video({
  target: { vibiz: "<slug>" },
  prompt: "...",
  videoDuration: "6s",
})
// → { adId, runId, statusUrl, viewUrl }

3. Poll for the final URL

One unified status tool. Feed it runId, get the media URL when ready:

vibiz_generation_status({ runId: "run_xyz123" })
// → { status, imageUrl?, videoUrl?, viewUrl, pollInterval }

Poll every pollInterval seconds until status === "completed". Images: 10–30s. Videos: 1–3 min — don't time out at 30s.

⚠️ Use runId for polling — NOT adId, NOT mcpGenerationUrl. Those are different identifiers and the status tool only accepts runId.

4. Publish

vibiz_social_publish({
  target: { vibiz: "<slug>" },
  content: "post copy here",
  mediaUrls: ["<imageUrl or videoUrl from step 3>"],
  platforms: [{ platform: "instagram", accountId: "<from social_list_accounts>" }],
  scheduledFor: "2026-05-02T15:00:00Z", // optional; omit = post now
})