# OfferBanner

> OfferBanner is a no-code promotional-banner builder: design a banner, install one script tag per site, and a calendar of bookings decides which banner shows when — with real Stripe discount codes created using the merchant's own restricted key.

The unit of everything here is a **site**: one host, one script tag, installed once and never edited again. Banners belong to a site, the snippet belongs to the site rather than to any campaign, and booking a banner on the calendar is what shows it — there is no separate publish step.

Agents should start with this index, load the smallest relevant document, and use the MCP server for anything that changes an account. Every page below has a `.md` mirror; the mirrors are the authoritative text for machines.

## Start here

- [Connect the MCP server](https://offerbanner.com/mcp): Streamable HTTP, OAuth 2.1 + PKCE in the browser, or `Authorization: Bearer ob_…` for CI. `claude mcp add --transport http offerbanner https://offerbanner.com/mcp`.
- [AI agent guide](https://offerbanner.com/agents.md): The fifteen tools, the scopes, the typical flow, and the rules an agent must follow.
- [Install the tag](https://offerbanner.com/help): Getting the one-line snippet onto a page — by hand, Shopify, WordPress, Wix, Webflow, Framer, GTM, an AI builder, or a developer.
- [Pricing](https://offerbanner.com/pricing.md): Free forever, or $49 once. Free is one campaign at a time per site, running on the dates you book it; Pro adds several campaigns at once, country targeting, triggers, plus discount codes made for you. Nothing renews and nothing is metered by traffic.

## Product

- [What OfferBanner is](https://offerbanner.com/index.md): The product, the site/banner/booking model, and how a campaign runs end to end.
- [Features](https://offerbanner.com/features.md): All fifty-three capabilities in nine groups, each badged Free or Pro. Generated from the page's own config.
- [Pricing](https://offerbanner.com/pricing.md): The two plans, where the Free/Pro line falls, the exact limits the server enforces, and why all sales are final.
- [Home](https://offerbanner.com/): What the banners look like, how the calendar works, and the install in one line.
- [Help](https://offerbanner.com/help): Installing the tag, checking that it is working, previewing a draft, connecting an AI agent, and Stripe discount codes.

## For agents

- [Agent guide](https://offerbanner.com/agents.md): Connection, authentication, the fifteen tools in one table, and the operating rules.
- [Information for AI systems](https://offerbanner.com/ai-info.md): The authoritative summary of capabilities, access, Stripe dependencies and limitations.
- [The same, as a page](https://offerbanner.com/ai-info): The human-readable version of the above.
- [MCP endpoint](https://offerbanner.com/mcp): The canonical Streamable HTTP server. A browser GET returns the human overview; everything else speaks MCP.
- [MCP server card](https://offerbanner.com/.well-known/mcp.json): Machine-readable identity, transport and authorization metadata.
- [OAuth protected-resource metadata](https://offerbanner.com/.well-known/oauth-protected-resource): Discovery for the OAuth 2.1 flow. Scopes are `banners:read` and `banners:write`.
- [API keys](https://offerbanner.com/agents): Where a person creates an `ob_…` key for a runtime that has no browser to consent in.

## Platform guides

- [Announcement bar for WordPress](https://offerbanner.com/for/wordpress): Installing the tag on WordPress, including block themes, and why a banner plugin and a coupon plugin do not work together.
- [Announcement bar for Webflow](https://offerbanner.com/for/webflow): Installing the tag in Webflow's custom code, and what the banner does that a Webflow component cannot.
- [Launch banners with real discount codes](https://offerbanner.com/for/course-creators): Running a launch window on a course site, with codes that expire when the cart closes.

## Legal

- [Terms of Service](https://offerbanner.com/tos): The agreement covering the dashboard, the embed and the MCP server, including that all sales are final.
- [Privacy Policy](https://offerbanner.com/privacy-policy): What is collected from a merchant's visitors, and what is not.

## Notes

- **Booking is showing.** `schedule_site` with action "add" is the only tool that changes what a visitor sees. There is no status field to set.
- **Countries and triggers are Pro; dates are free.** A booking with a country list, and any trigger other than immediate, needs Pro. A booking with a start and an end date serves on every plan. On the Free plan a country-targeted booking is still written and still on the calendar — it is simply never served, and the response says so. Creating a discount code is refused outright on Free (`pro_required`); a code the merchant made themselves prints on the bar on either plan.
- **Codes are real Stripe objects** in the merchant's own account, created with a restricted key scoped to coupon write and promotion code write. OfferBanner holds no platform key and cannot read a merchant's key back out.
- **Removing a banner does not stop its code** unless the code was given an expiry or is explicitly retired. Removing a booking stops the banner, not the code.
- **API keys and OAuth tokens are secrets.** Keep them out of browser code, prompts, repositories and public logs.
- **Nothing here is metered by views.** There is no impression tier and no traffic limit on either plan.
- Support: <https://offerbanner.com/help> — a form, read by a person. There is no support email address.