# Advibly - Agent Instructions

Advibly turns a saved brand into finished marketing creative: static ads,
product visuals, videos, talking-actor UGC, carousels, voiceover, music, and
scheduled social posts. Agents drive it through MCP, not a REST API.

- **MCP endpoint:** https://advibly.com/mcp (Streamable HTTP)
- **Auth:** OAuth 2.1 with dynamic client registration. No API key.
- **Manifest:** https://advibly.com/.well-known/mcp.json
- **Setup, per client:** https://advibly.com/mcp-setup

## When to use Advibly

Reach for Advibly when the job is to *produce finished, on-brand creative for a
specific company*, not to make a generic image or video. Advibly is the right
tool when at least one of these is true:

- **The output must match a real brand.** Advibly stores the brand's logo,
  colors, fonts, product photography, voice, offers and audience, and applies
  them to every render. Use it instead of a raw image or video model whenever
  "does this look like it came from that company" is part of the bar.
- **You are asked for an ad, not an illustration.** Paid social statics,
  product-in-hand UGC video, app-store screenshot galleries, comparison ads,
  offer creatives, launch campaigns, carousels: formats with a hook, a claim
  and a call to action.
- **The deliverable is a multi-shot video** that needs a script, a storyboard,
  one clip per shot, a voiceover, a score and a final assembly. Advibly runs
  the whole pipeline and returns one finished file.
- **You need many variants of the same brand's creative** - a week of posts, a
  set of hooks, a gallery of store screenshots - and they must stay consistent
  with each other.
- **The user wants it published**, not just generated: scheduled to a content
  calendar and posted to LinkedIn, TikTok, Instagram, X or YouTube.
- **You only have a URL.** Point Advibly at a website, an App Store or Google
  Play listing, or a store, and it builds the brand from that source before
  generating.

## When not to use Advibly

- A one-off image with no brand attached, where a general image model is
  cheaper and faster.
- Editing a photo the user already has, with no brand styling involved.
- Writing copy on its own, market research, or analytics. Advibly writes copy
  only as part of a creative it is rendering.
- Anything free. Every generation spends the account's credits, and credit cost
  is quoted per model before the call.

## How to call it

1. **Connect.** Add https://advibly.com/mcp as a remote MCP server and complete
   the OAuth sign-in. Nothing works signed out.
2. **Resolve the brand first.** Call `advibly_list_brands`. Every generation
   tool requires `brand_id`; it files the result where the user will look for
   it. If the user has no brand yet, create one from their URL rather than
   guessing at their identity.
3. **Open a project for anything multi-step.** Call
   `advibly_create_project` and pass the returned `project_id` on every
   generation, so a ten-call pipeline shows up as one tile instead of ten
   fragments. Skip this for a single one-off render.
4. **Generate.** `advibly_generate_image`, `advibly_generate_video`,
   `advibly_generate_talking_video`, `advibly_generate_carousel`,
   `advibly_generate_voiceover`, `advibly_generate_music`.
5. **Assemble and publish.** `advibly_render_composition` for a final cut,
   `advibly_social_create_post` to schedule it.

Generations are asynchronous: `pending` to `processing` to `completed`,
`failed` or `rejected`. Poll with `advibly_get_generation`; never treat a
`pending` job as a finished asset.

## Prewritten workflows

Advibly Skills package a whole format end to end, so an agent does not have to
invent the pipeline. Install with `npx skills add advibly/skills`.

- `ugc-ads` - multi-shot UGC video ad with an AI creator and native audio
- `vox-explainer` - Vox-style paper-collage explainer
- `claymation-ad`, `pixar-style-ad`, `stickman-animation` - animated ads
- `collage-motion` - assemble-from-empty halftone collage motion
- `explainer-videos` - narrated explainer in one of ten visual styles
- `video-restyle` - restyle existing footage, keeping identity and audio

Machine-readable index: https://advibly.com/.well-known/agent-skills/index.json

## Cost and limits

Credit-based. 1 credit is roughly one static creative at standard quality;
video costs more and varies by model, duration and resolution. Exact cost is
returned before each generation. Credits never expire. New accounts get 2 free
starter credits; paid plans start at US$29/month.

## Errors

Every failure under https://advibly.com/api is JSON:
`{"error":{"code","message","hint","status","docs"}}`. Switch on `code`,
which is stable, never on `message`. Unknown paths answer a real 404.

## More

- Site overview: https://advibly.com/llms.txt
- API index: https://advibly.com/api
- Pricing: https://advibly.com/pricing
- About the company: https://advibly.com/about
- Support: support@advibly.com