Vibbe

    Developer docs

    Agent Setup Guide

    Connect your AI agent to Vibbe in 3 steps

    Recommended

    MCP server (OAuth 2.1)

    No API key — you sign in with your Vibbe account

    Paste the MCP URL into ChatGPT, Claude, Cursor or Lovable. The client registers itself automatically and you approve access on the Vibbe consent screen, so every tool call runs as you.

    MCP server URL

    https://vibbe.io/api/public/mcp

    Stable endpoint — updated when the app is published.

    Preview MCP URL

    https://vibbe.io/api/public/mcp-preview

    Staging endpoint — gets new tools first, so you can test before publishing.

    Tools available over MCP

    • list_workspaces

      List the workspaces you can act in

    • get_current_workspace

      See the workspace this connection works in

    • set_current_workspace

      Switch it — remembered for every later call

    • list_studio_projects

      List Studio projects (slides or video)

    • get_studio_project

      Read pages, timeline and every element

    • get_studio_schema

      Element types and properties accepted by the Studio

    • create_studio_project

      Start a new slides or video project

    • edit_studio_elements

      Add, patch, delete, reorder, split, trim or animate elements

    • edit_studio_pages

      Add, duplicate, delete or reorder slides and settings

    • generate_studio_element

      Generate media with AI straight into a scene

    • view_studio_frame

      Render one scene to PNG so the agent can see it

    • render_studio_project

      Export the project to PNG, PDF or MP4

    • list_recipes

      Recipes with variables, schedules and recent runs

    • upsert_recipe

      Create or update a recipe

    • run_recipe

      Run a recipe now (or dry-run its preconditions)

    • manage_recipe_schedule

      Create, update, pause or delete recipe schedules

    • list_automations

      Automations, templates, webhooks and run history

    • upsert_automation

      Create or update an automation (also from a template)

    • run_automation

      Run an automation now, or test it with a sample event

    • manage_media

      Media Library: direct base64 or signed-URL upload, list and delete

    • manage_ideas

      Ideas inbox: capture, inspect and approve/adjust/retry

    • manage_recreations

      Recreate pipeline: start from a URL, follow and advance

    • list_accounts

      Social accounts with connected / disconnected status

    • get_calendar

      Published and scheduled entries per channel, with errors

    • list_posts

      Recent posts with status and deep links

    • create_draft_post

      Create a draft post with ordered media attachments

    • publish_post

      Publish now or schedule for a specific/next available slot

    • get_playbook

      Step-by-step flows for carousels, articles, videos, threads and uploads

    • call_vibbe_api

      Escape hatch to any other Vibbe API route

    REST API + skill manifest

    For scripts, n8n, Zapier, cron jobs and custom agents

    1

    Get your API Key

    Create an API key from your dashboard

    Sign in, go to Account → API Keys, and create a new key. Give it a name like "My Agent". Copy the key immediately — it's only shown once.

    2

    Install the Skill

    Give your agent the Vibbe skill manifest

    The skill file is a versioned JSON manifest that teaches your agent every available API action. Your agent can check for updates automatically by comparing versions.

    Skill manifest URL

    https://vibbe.io/api/public/agent-skill

    Add to your agent's instructions:

    Download the Vibbe skill from:
https://vibbe.io/api/public/agent-skill

Use the API key stored in your secrets as VIBBE_API_KEY.
Before each session, check the skill version and update if needed.
All API calls go to the base URL provided in the skill manifest.
    3

    Start Using It

    Your agent is ready to manage your social media

    Once your agent has the skill and API key, try these commands:

    List my Vibbe workspaces and work in Acme

    Create a LinkedIn post about productivity tips

    Show me slide 2 of my carousel project and fix the headline

    Add the image you just generated to page 1 of the project

    Create a 7-page carousel, add my 7 images in order, and save it as a draft post

    Attach these image files to a draft and schedule it in each account's next slot

    Trim the first 2 seconds of the video project and render it

    Run my 'daily news' recipe now and show me the result

    Schedule that recipe every weekday at 8:30 in São Paulo time

    Test my comment automation with a sample comment

    Schedule my draft posts for the next available slots

    Working workspace

    Your agent remembers which workspace it is working in. Ask it to list workspaces and pick one — that choice stays the default for every later call until you change it.

    Full Studio control

    Agents can do everything you can do in the Studio: create projects, add and edit canvas or timeline elements, manage carousel pages, generate media with AI and insert it, look at a rendered frame, and export the final asset.

    Recipes & automations

    Agents can list, create and update recipes, run them on demand (or dry-run their preconditions), manage daily/weekly schedules, and run or test automations — with full run history.

    Library & pipelines

    Agents can browse and upload to the Media Library, drive the Ideas inbox and the Recreate pipeline, check which social accounts are connected, and read the calendar of published and scheduled posts.