# Build Revup Promotions with Claude and ChatGPT

Revup is software for building, publishing, and measuring branded forms, sweepstakes, giveaways, contests, instant-win experiences, and purchase promotions, with customer intelligence, winner management, email, and SMS tools for authorized follow-up.

- Canonical HTML: https://revup.com/build-with-ai/
- Full HTML page: [Open the canonical page](https://revup.com/build-with-ai/)
- Last reviewed: 2026-09-16



## Overview

Revup runs a hosted Model Context Protocol server, so Claude, ChatGPT, and Codex can operate your Revup account in a conversation. Fourteen tools cover discovering your real settings, creating and editing giveaways, contests, instant win, purchase promotions, forms, and surveys across fourteen configuration sections, importing images into your library, checking readiness and preview links, and reading aggregate performance reports. Connections use OAuth with per-account consent, revision locking, and idempotent writes.

## Core capabilities

- A hosted MCP server at https://revup.com/mcp using remote Streamable HTTP with OAuth authorization code and S256 PKCE
- Fourteen tools spanning account capabilities, promotion discovery, schema discovery, authoring, images, readiness, preview, and reporting
- Schema discovery first: the assistant reads the real themes, fonts, field types, and catalogs on your account before writing anything
- Create, edit, and duplicate supported promotions across content, rules, security, colors, fonts, layout, theme, form fields, prizes, bonus actions, assets, schedule, custom CSS, and design
- Revision locking on every edit and a required idempotency key, so a retried request does not apply twice
- Image import from a supplied file into your account library, with status polling before the image is attached
- Aggregate promotion reports with comparison periods and device, source, campaign, or landing breakdowns
- Per-account consent at sign-in, scopes you choose, and one-click revocation from Account then Integrations
- Aggregate reporting only: no participant identities, no exports, no raw URL paths
- Automatic OAuth client registration, so custom connectors need no client ID or secret


## Product details

### It operates the account, not a clipboard

Revup exposes a real hosted MCP server rather than a chat window that writes copy for you to paste. Your assistant calls the same Revup services the dashboard uses, so there is no second-class AI path and no copy step between the conversation and the promotion. Ask it to check the connected account and its permissions before you make changes.

### Discover before you write

get_promotion_schema returns the allowed settings and catalogs for a section, so the assistant works from your account's real theme list, font list, field registry, and bonus-action catalog instead of inventing options. get_account_capabilities, list_promotions, and get_promotion cover the rest of discovery, including reading a specific section of a saved promotion and the revision you will need to edit it.

### Build it

create_promotion_draft creates an explicitly selected supported promotion type with a name and a schedule, optionally applying structured edits in the same call. update_promotion_draft applies narrow ordered operations across fourteen sections: content, rules, security, colors, fonts, layout, theme, form fields, prizes, bonus actions, assets, schedule, custom CSS, and design. duplicate_promotion_draft queues a bounded configuration copy with new dates; participants, results, integrations, language variants, and sends are never copied.

### Illustrate it

Ask for a hero image in your assistant, and import_image brings the file it supplies into your Revup account library, where list_assets and the promotion's asset slots put it on the page. Revup validates the bytes as PNG, JPEG, WebP, or GIF up to 5 MiB and 40 million pixels, and get_asset_status must report the import complete before the image is attached. Revup imports supplied images; it does not generate them.

### Read it

get_promotion_report returns aggregate metrics for a date range, with an optional comparison period and a device, source, campaign, or landing breakdown. Reports carry their own metric definitions, denominators, timezone, filters, and freshness limits, and distinguish participant rows from weighted entry chances and counted completions. Comparisons describe what changed; they do not establish why, and reports never include participant identities or raw URL paths.

### Safe by construction

Every edit supplies the revision it expects, so a change made elsewhere is rejected instead of silently overwritten. Every write carries an idempotency key that is unique to that operation on that connection, so a retry replays the original result rather than creating a second promotion. Retry keys do not carry across connections: after reconnecting, read the current state before starting a new operation.

### You choose the account and the permissions

Connecting runs an OAuth sign-in where you pick the Revup account and review the requested scopes. account:read reads capabilities, promotions:read covers discovery, validation, and preview, promotions:write covers creating, editing, duplicating, and importing images, analytics:read covers aggregate reports, and offline_access lets the client refresh without a new sign-in. New connections apply to all promotions in the selected account within the approved scopes. Tools follow your current account membership and role, and you can delete the connection from Account then Integrations at any time.

### Changes are live immediately

Creating or editing a promotion can affect its public page right away. There is no separate publication approval step, including for tools whose names contain draft. The promotion's schedule controls when entries are accepted, and closing your assistant does not pause a running promotion. Use validate_promotion for saved configuration blockers and warnings and preview_promotion for the preview, public, and share links before you share anything.

### Where it starts

Build with AI supports giveaways, contests, instant win, purchase promotions, forms, and surveys, created in English. Other languages are set up in the builder. Purchase promotions require their store integration to be connected, and instant win requires prize allocation in the dashboard. MCP does not expose participant identities or exports, winner selection, messaging, payments, or subscriptions. Revup is added to assistants as a custom connection rather than through a published directory listing.



## Common use cases

### Launch from a sentence

Describe what you want to run and get back a complete promotion ready to review.

### Repeat what worked

Duplicate a successful promotion with new dates, prizes, or creative without rebuilding it.

### Change it while it is live

Update copy, images, prizes, or settings without opening the Revup dashboard.

### Ask what is working

Check performance, compare periods, and see which sources are bringing people in, just by asking.




## Common questions

### What is Build with AI?

It is a connection between Revup and your AI assistant. Connect it once, and Claude, ChatGPT, or Codex can build and edit promotions in your Revup account and report on how they did, without you opening the dashboard.

### Which assistants can connect?

Claude, ChatGPT, and Codex, plus any other assistant that supports a remote MCP connection. Revup publishes setup steps for all three, and connecting takes an ordinary sign-in rather than an API key.

### What can it actually build?

Giveaways, contests, instant win, purchase promotions, forms, and surveys. Your assistant sets the content, rules, prizes, bonus actions, form fields, colors, fonts, layout, images, and dates, and it can duplicate a promotion you already ran.

### Is there anything I still have to finish myself?

A few things. Promotions are created in English, so other languages are set up in the builder. Purchase promotions still need their store integration connected, and instant win still needs its prize allocation set, both in the dashboard.

### Does it put the promotion live?

There is no separate publish step. Creating or editing reaches the public page right away, and the promotion's schedule still controls when entries open and close. Ask your assistant to check readiness and send you the preview link before you share it. A readiness check looks for missing setup, not legal compliance, so your official rules still need your own review.

### Can it see my participants?

No. Reporting comes back as totals only, with no participant names and no exports. Your assistant also cannot pick winners, send messages, or take payments.

### Does Revup make the images?

No. Your assistant makes the image, or you supply one, and Revup brings that file into your account library so it can go on the promotion. Revup checks each file and accepts PNG, JPEG, WebP, and GIF.

### What stops a mistake from breaking a live promotion?

Two things. If someone changed the promotion in the dashboard first, your assistant's edit is refused instead of applied on top of it, so your team's work is never quietly overwritten. And if the same request is sent twice, it returns the original result rather than creating a second promotion.

### How do I control or remove access?

You choose the Revup account and approve the permissions when you connect. New connections apply to all promotions in that account within the permissions you allow. Access follows your current account membership and role. Remove the connection anytime from Account then Integrations.

### Is this the same as the Revup API?

No. The REST API uses API keys and is for integrations your developers build. This connection is for AI assistants working in your account through conversation. Use the API reference if you are writing code.




## Related resources

- [RevAssist](/revassist/): The promotion AI that drafts your promotion and answers entrant questions once it is live.
- [Revup API](/integrations/api/): Key-based REST access for building your own integrations around promotion data.
- [Integrations](/integrations/): Connect collected fields and consent to supported email, CRM, and marketing platforms.



## Learn more

For full product detail, examples, and current interface descriptions, use the [canonical Build with AI page](https://revup.com/build-with-ai/).
