---
title: "Connect your AI agent to RiffAds"
url: "https://riffads.com/connect"
description: "Connect Claude, ChatGPT, Cursor or VS Code to RiffAds with one URL. Your agent prices each job, then makes UGC video ads, images, video and ad breakdowns."
source: "RiffAds"
---

# Connect your AI agent to RiffAds

Connect your AI agent. Let it make the ads.

RiffAds makes UGC video ads with AI actors. Connect your AI agent with one URL and it can price a job, make talking actor ads, images and video, and hand back the finished files, all from your workspace's credits and inside limits a person sets.

## Connector URL

`https://mcp.riffads.com`

Streamable HTTP with OAuth. Add it as a custom connector in your agent, then sign in when your browser opens. [Connect guide](https://docs.riffads.com/mcp/setup).

## Pick your client

Each tile opens that app's own connector dialog with the URL filled in, or gives you the one line to paste in a terminal. You approve the connection there, in your browser.

- **Claude** (Web or desktop): [Connect](https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=RiffAds&connectorUrl=https%3A%2F%2Fmcp.riffads.com)
- **Claude Code** (In the terminal): run `claude mcp add --transport http riffads https://mcp.riffads.com`
- **ChatGPT** (Custom connector): [Open settings](https://chatgpt.com/#settings/Connectors)
- **Cursor** (One click): [Install](https://cursor.com/en/install-mcp?name=riffads&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLnJpZmZhZHMuY29tIn0%3D)
- **VS Code** (Copilot agent mode): [Install](vscode:mcp/install?%7B%22name%22%3A%22riffads%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.riffads.com%22%7D)
- **The RiffAds CLI** (Scripts and CI): run `npx riffads@latest login`

## What your agent can do

- **Price it first**: It checks the cost of every job for free, then names the most it may spend. A job over that cap is refused, never trimmed.
- **Make the ad**: Talking actor ads, images and video, with the same actors, voices and models as the studio.
- **Rebuild a reference**: Give it an ad you like. It breaks down the hook, the shots and the captions, then remakes it with your product.
- **Read its history**: Its past generations and your library of uploads and outputs, so it can pick up where it left off.
- **Hear when work is done**: Register a webhook and RiffAds sends a signed event when a job finishes, so nothing has to keep checking.

## What it never does

- **Post anywhere**: It never posts to Meta, TikTok, YouTube, X or any other social platform.
- **Return anything but results**: It returns a download link to each finished file, or for an analysis, the JSON breakdown itself. Where the ad goes next is your call.
- **Spend past your limits**: By default an agent may spend 600 credits a job and 2,000 credits a day. A workspace owner or admin can lower both, or set them to zero.

[Set your agent limits](https://app.riffads.com/connections)

## Install

The skills teach your agent the safe way to use RiffAds. The CLI is for scripts, CI and anyone who lives in a terminal.

### Claude Code plugin

Run these two lines inside Claude Code. They add the RiffAds connector and these skills:

1. `/plugin marketplace add riffads-ai/skills`
2. `/plugin install riffads@riffads`

- `cost-aware-generation` quotes the cost and waits for a yes
- `batch-actor-variants` runs one script past several actors
- `batch-image-variants` makes up to four versions of one image or video
- `analyze-reference-ad` takes apart an ad you like, beat by beat
- `clone-hook` rebuilds a winning hook with your product and actor
- `clone-static-ad` remakes a static image ad in your own brand
- `riffads-router` picks the right tool for any ad job you describe

[Skills guide](https://docs.riffads.com/skills/setup)

### The RiffAds CLI

Sign in once. Then price, make and download from any terminal, with a credit cap on every paid call.

`npx riffads@latest login`. [CLI guide](https://docs.riffads.com/cli/setup).

### The REST API

Writing your own code instead? Use the REST API with a key from your workspace. [Create an API key](https://app.riffads.com/api-keys), [API quickstart](https://docs.riffads.com/api/setup).

## Connect once. Ship ads all week.

Create your account and pick a plan. Your agent spends the same credits as the studio, at the same prices.

- [Create your account](https://app.riffads.com/sign-up?redirect=%2Fconnections)
- [Log in](https://app.riffads.com/sign-in?redirect=%2Fconnections)