Skip to content

01 — For AI agents

What an assistant can do here, and what it cannot.

OfferBanner shows a promotional bar on a website through one script tag, and a calendar decides when it runs. It includes an MCP server, so an AI assistant can do the whole job — register the site, design the banner, book the window, create the discount code, read the numbers — without anyone opening the dashboard. This page is the summary; the machine-readable version is /ai-info.md.

MCP endpoint
https://offerbanner.com/mcp
Transport
Streamable HTTP
Auth
OAuth 2.1 + PKCE, or a Bearer API key
Scopes
banners:read, banners:write

02 — Capabilities

Fifteen tools, and what they do

The unit is a site: one host, one script tag, installed once and never edited again. Banners belong to a site, and the calendar decides which banner is shown.

  • Register and inspect sites

    A site is one host and one script tag. Every tool takes a site id, and listing the sites is where an assistant starts.

  • Design the banner

    Copy, colours, height, font, position, entrance, countdown, and one of twenty-seven effects, all set through the tools rather than a dashboard form.

  • Schedule the banner

    A booking is a banner, a date window and a list of countries. Booking a banner is what shows it; there is no publish step and no status to set.

  • Create real discount codes

    A Stripe coupon and promotion code, created in the merchant's own Stripe account with their own restricted key.

  • Read the results

    Views, clicks, code copies, claims, and redemptions read back from Stripe — per site or per banner, compared with the previous window.

  • Confirm the install

    Fetches a page of the merchant's site and reports whether the tag is present, including the content-security policy blocking it when there is one.

03 — Access

Free, Pro, and the one feature that needs Stripe

Free — $0, forever

Unlimited sites, one banner showing per site, one campaign window running at a time on the start and end dates you book it, 14 of the 27 effects, and the small “Powered by OfferBanner” badge. The MCP server, API keys, discount codes and every statistic are included on this plan.

Pro — $49, once

Unlimited banners and windows at once, all 27 effects, exit-intent, click and return-visit triggers, scheduled design switches, per-visitor codes, and the badge is removed. Nothing renews, and nothing is metered by views.

Stripe is optional. The banner, the calendar, the effects, the triggers and the analytics all work with no key at all, and a code created in any other checkout can be typed into the banner and displayed unchanged. A key is needed only to create codes for you: a restricted key scoped to coupon write and promotion code write, created by the merchant in Stripe’s own dashboard and connected per site. It cannot charge anyone, read customers, move money or access payouts, and it is never readable back through the API or the MCP tools.

04 — Limitations

What it does not do

  • No page-level targeting

    A booking targets by date and by country. It does not target by URL, path, referrer, device or returning-visitor status. Targeting is per site, not per page.

  • Per-visitor codes require Pro

    The only feature that gives each visitor their own newly created code is the unwrappable gift, and the gift is a Pro effect. On the Free plan, per-visitor codes are not available.

  • Codes are Stripe codes

    They redeem in Stripe Checkout, Payment Links and the Billing portal. They are not WooCommerce coupons or Shopify discounts. For another checkout, create the code there and have the banner display it unchanged; that is fully supported, but we do not create or expire those codes.

  • Removing a banner does not stop its code

    Taking a banner off the schedule does not stop a code. A code stops when it reaches the expiry it was created with, or when it is retired.

  • No A/B testing

    Traffic can be split between two bookings by weight. Comparing two banners and picking a winner is on the roadmap and is not shipped.

  • No SLA

    There is no ticketing system and no support rota. Support is a single form at offerbanner.com/help, read by the person who built the product.

05 — Machine-readable

Where to read the rest

Questions this page does not answer go to the form at offerbanner.com/help, which a person reads. The endpoint itself, https://offerbanner.com/mcp, returns an overview page to a browser and speaks MCP to everything else.