apply_setup_plan
ChatGPTUse this to set up a whole in-app purchase and subscription catalog in one step. Declaratively evaluate and execute a complete monetization catalog setup (products, entitlements, offerings, packages, placements). Defaults to dry_run: true for safe inspection of diffs and warnings before mutating. Set dry_run: false to commit.
create_campaign
ChatGPTSave a campaign as a DRAFT. It reaches no one until it has an audience and is activated in the dashboard.
create_entitlement
ChatGPTCreate a new entitlement in the catalog and optionally link it to products.
create_experiment
ChatGPTUse this to A/B test paywalls: compare two or more paywalls in an app. Create a paywall A/B experiment as a DRAFT: each variant shows a different paywall at the same place in the app. The first variant is the control unless one says is_control. Traffic splits evenly unless every variant gives traffic_percent (they must add up to 100). It serves nothing until start_experiment, and every paywall in it must be published first.
create_feature_flag
ChatGPTUse this to add a feature flag for a mobile or web app. Create a feature flag, OFF: every user gets false until update_feature_flag turns it on. The app reads it by key. For a multivariate flag give variants (2+, rollout_percentage adding up to 100, optional JSON payload each).
create_journey
ChatGPTSave a linear journey as a DRAFT (activate it in the dashboard; branches are built on its canvas). entry_trigger.trigger is one of: signup, app_open, paywall_presented, paywall_dismissed, paywall_purchased, trial_start, trial_ending, subscription_created, subscription_renewed, subscription_cancelled, subscription_expired, billing_issue, survey_completed, inactivity, segment_entered, or custom_event with event_name.
create_message_template
ChatGPTUse this to write a reusable push notification or in-app message. Save a reusable push or in-app message template (the same kind the dashboard Templates library shows). Use its id as template_id in a journey step.
create_offering
ChatGPTCreate a new offering with packages. Created inactive/non-current by default.
create_paywall_from_template
ChatGPTUse this to start a mobile app paywall from a paywall template. Create a new paywall in the project from an existing template. Created as an inactive draft by default. The result's exits says whether a visitor can leave without buying: most templates draw a header close or back icon that does nothing, or hide the close; exits.fix is the update_paywall patch that wires it.
create_placement
ChatGPTCreate a new placement in the project. Created unlinked by default.
create_product
ChatGPTUse this to add an in-app purchase or subscription from App Store Connect, Google Play or Stripe. Create a store product (subscription or in-app purchase) in the project catalog. A product can only be sold on a platform it has a store id for (app_store_product_id for Apple, play_store_product_id for Google, stripe_price_id for web); the result warns about any target platform missing one. If the identifier exists, nothing is changed (use update_product).
create_project
ChatGPTCreate a new BillDog project for the authenticated user with a specified name, bundle ID, and platform. With the "Create projects" permission (Sign in with BillDog), this connection then works in the new project: every other tool acts on it, and use_project switches back. Otherwise the connection stays on its current project and the result says how to reconnect — do not configure the new project until then. Check result.connection.switched.
create_public_sdk_key
ChatGPTGenerate a client-safe public SDK key (bd_public_live_... or bd_public_test_...) for mobile and web apps. Never mints secret keys.
create_survey
ChatGPTUse this to draft an in-app survey. Save a survey as a DRAFT with its questions (activate it in the dashboard). Questions are checked as the dashboard checks them: a choice question needs choices, a rating needs maxRating ≥ 1, a link needs config.url.
design_paywall
ChatGPTUse this to generate a mobile app paywall from a description, or to build one from a layout you write. For a paywall inside the user's own app, not for reading paywalled articles. Design a paywall and save it as an inactive draft. Two ways: (1) pass recipe: you design it yourself — a compact layout (theme, presentation, body nodes such as text, icon, feature-list, products, button) that BillDog compiles into a native paywall. Its JSON schema is below; call get_paywall_recipe_guide for the full language and design guidance. Uses no AI credit. If it does not compile, the error lists every problem; fix them and call again. (2) pass prompt: BillDog's AI designer (the same one as the dashboard's "Generate with AI") writes the recipe from your description and the project's offering and store listing. Uses one of the user's AI credits, charged only when a design compiles. Never write prices in text: the products node shows each package's real store price. Pass offering_id so the plan picker binds to that offering.
discover_schema
ChatGPTReturn the full BillDog analytics schema — every (source, metric) pairing the project supports, with a 1-line description of what each returns. Call this once at the start of a session to know which combinations are valid.
get_experiment_results
ChatGPTUse this to read a paywall A/B test: conversion, revenue per user and which variant won. Per-variant results of an experiment for its whole run: users, conversions, conversion rate, revenue per user, lift vs control, p-value and significance (p < 0.05 with 100+ users per arm), plus a verdict: winner, loser, keep_running or no_data. Reads production unless sandbox is true.
get_feature_flag_results
ChatGPTHow many users and evaluations got each value of a flag over the last N days (default 30, max 90), from the $feature_flag_called events the SDKs send. Name it by flag_id or key. Reads production unless sandbox is true.
get_paywall
ChatGPTGet a paywall by UUID or identifier: status, layouts, offering, colours and copy_outline — every text and button with its component id, current colours, whether users can see it (hidden, show_with) and whether a product list fills it (product_field), for update_paywall patch.copy, patch.colors and patch.visibility; and exits — whether a visitor can leave without buying, the header close/back icons with whether each closes or is hidden, and the patch (close_button, visibility) that fixes it. include_config returns the full draft and published configs (often hundreds of KB, too large for most agents: prefer copy_outline).
get_paywall_recipe_guide
ChatGPTGet the full guide to writing a design_paywall recipe: every node type and its fields, theme tokens, icons, dynamic price values, layout and design advice.
get_project
ChatGPTGet project metadata including bundle ID, package name, and registered domains.
get_recent_sdk_activity
ChatGPTUse this to check whether an iOS, Android, React Native, Flutter, Expo or web app is sending events and purchases to BillDog. Is the app sending data? For the last window_hours (default 24): events by name, purchases and session replays, split into sandbox and production, with has_traffic for each.
get_saved_view_results
ChatGPTRe-run a saved view and return its results. Equivalent to opening that report in the dashboard with the saved filters/range applied. Reads production data unless sandbox is true.
get_sdk_integration_guide
ChatGPTUse this when adding BillDog to an iOS, Android, React Native, Flutter, Expo or web app, for paywalls, in-app purchases or analytics. Get the code to add BillDog to an app on one platform: a setup snippet carrying this project's public SDK key, and the guide to installing the SDK, identifying the signed-in user, showing a paywall, buying and restoring. Give the user this code rather than writing BillDog SDK calls from memory. If the snippet shows a placeholder, the project has no public key yet: create_public_sdk_key makes one.
get_setup_status
ChatGPTUse this when a paywall, in-app purchase or subscription integration is not working, or to see what is left to set up. Inspect the setup status of BillDog for this project. Returns an actionable checklist covering SDK keys, platform configuration, analytics ingestion, store credentials, products, entitlements, default offerings, and paywalls.
link_placement
ChatGPTLink one or more offerings to a placement with priority order (replaces its links). On a live project (a production purchase, or 10+ production customers, in the last 30 days; sample projects never count) the change waits for an owner or admin to approve it: the result is awaiting_approval with an approve_url to pass on.
list_campaigns
ChatGPTList all marketing and engagement campaigns configured for this project.
list_cohorts
ChatGPTList saved cohorts for this project. Each cohort has a definition (event-frequency / property / behavioral predicate) and a member_count. Pass a cohort id as the segment_id param to run_analytics_query to scope a report to that cohort.
list_entitlements
ChatGPTList all entitlements in this project and the product IDs associated with each entitlement.
list_event_names
ChatGPTList the event names this project received in the last days days (default 30), most frequent first, with each one's count and unique users. Useful when the user asks about an event by approximate name and you need the canonical one. Reads production data unless sandbox is true.
list_experiments
ChatGPTList the project's experiments with their status, what devices are served now (variants, the shipped winner, or the control only), and each variant's paywall and traffic share.
list_feature_flags
ChatGPTList the project's feature flags: key, on/off, rollout percentage, variants, and whether it has release conditions (audience rules, edited in the dashboard).
list_journeys
ChatGPTList all customer onboarding and engagement journeys with their sequence of steps.
list_message_templates
ChatGPTList the project's message templates (push, in-app, email, SMS) with their title and body, as the dashboard Templates library shows them. Deleted templates are excluded.
list_offerings
ChatGPTList all offerings in this project, showing their packages, attached products, and default/current status.
list_paywalls
ChatGPTUse this to see the mobile app paywalls in the connected project. List all paywalls in this project, including active state, wall type, and publication timestamps.
list_placements
ChatGPTList all placements in this project, including access gating settings and linked offerings.
list_products
ChatGPTUse this to see the in-app purchases and subscriptions set up for an app. List all products configured in this project's catalog, including their identifiers, product types, subscription durations, and store mapping IDs.
list_projects
ChatGPTList all BillDog projects accessible to the authenticated user, identifying the current active project, bundle ID, and platform.
list_saved_views
ChatGPTList saved analytics views for this project, each with what it asks (source, metric, dims, filters, date range, segment). Use get_saved_view_results to run one. Only views the user can see (shared with the project, or their own). pillar_id narrows to one area (revenue, product, surveys, …).
list_surveys
ChatGPTList all multi-page surveys and micro-survey walls configured for this project.
list_templates
ChatGPTUse this to browse paywall templates by app category before building a paywall. List available paywall and onboarding templates from the BillDog template catalog.
manage_offering_packages
ChatGPTAdd or remove packages within an existing offering. A new package goes after the last one unless position is given. action "retype" changes a package's package_type (package_id + package_type), e.g. a monthly plan stored as "custom", which offering.monthly cannot see. If customers can reach the offering (it is current, linked to a placement, or a published paywall uses it) and the project is live, the change waits for an owner or admin to approve it (awaiting_approval, with an approve_url to pass on). Live means a production purchase, or 10+ production customers, in the last 30 days; sample projects never count.
pause_journey
ChatGPTPause an active journey: nobody new enters. Never needs approval (stopping must always work). People already in it are held where they are and continue when it is activated again.
preview_paywall
ChatGPTEvaluate paywall publish gate (validating components, bindings, offerings) and generate a secure short-lived preview link and token. store_warnings (when present) lists products a platform the project targets will not show because they have no App Store / Google Play product id; it does not block publishing.
publish_paywall
ChatGPTPublish a draft paywall to make it active for SDK delivery. Validates paywall before publishing. On a live project (a production purchase, or 10+ production customers, in the last 30 days; sample projects never count) the change waits for an owner or admin to approve it: the result is awaiting_approval with an approve_url to pass on. The approval publishes the draft as it was when you asked; edit it afterwards and you must ask again. store_warnings (when present) lists products a platform the project targets will not show because they have no App Store / Google Play product id: tell the user, it does not block.
resolve_placement_preview
ChatGPTUse this to debug which paywall and offering an app will show at a placement. Dry-run preview of what a client SDK receives when resolving a placement: an active campaign first (a holdout serves nothing), else the offering linked to the placement, else nothing. Returns served_by, the matched offering, packages, and assigned paywall, plus any running or shipped experiment on that paywall (experiments, with each arm's traffic and paywall): while one runs, assigned_paywall is only what its control sees.
run_analytics_query
ChatGPTUse this for subscription analytics and mobile app analytics in the connected project: revenue, MRR movement, churn, active subscriptions, retention, funnels and paywall conversion. Run a single analytics report. Returns a ReportResult envelope with columns + rows + optional totals. Properties named like personal data (email, phone, name, token) are refused and email addresses in results are hidden. Available sources: events, revenue, cohorts, notifications, surveys, virtual_currency, subscriptions, paywalls, offerings, products, campaigns, experiments, journeys, customers. Available metrics: totals, timeseries, breakdown, funnel, retention, distribution, top_n, flow, compare, mrr_movement, ab_results, stickiness. Call discover_schema first if you need to know which (source, metric) pairings are supported. Reads production data unless sandbox is true; the result says which environment it read.
set_current_offering
ChatGPTMake an offering the project current offering (the others stop being current, atomically). On a live project (a production purchase, or 10+ production customers, in the last 30 days; sample projects never count) the change waits for an owner or admin to approve it: the result is awaiting_approval with an approve_url to pass on.
set_entitlement_products
ChatGPTSet the explicit list of product IDs granting an entitlement (replaces the list; only the links that change are touched). On a live project, removing a product (its buyers lose the entitlement) waits for an owner or admin to approve.
start_experiment
ChatGPTStart (or resume) an experiment: users who reach its paywall are split between the variants. Refused unless it has 2+ variants whose traffic adds up to 100, exactly one control, every paywall published, and no other running experiment on the same paywall. On a live project (a production purchase, or 10+ production customers, in the last 30 days; sample projects never count) it waits for an owner or admin to approve it: the result is awaiting_approval with an approve_url to pass on.
stop_experiment
ChatGPTStop an experiment. mode "pause" (default) and "end" both send every user back to the control paywall; a paused one can be started again, an ended one cannot. mode "ship_winner" ends it and serves winner_variant_id to everyone (its traffic becomes 100%, the others are retired). Live projects need approval as for start_experiment.
unpublish_paywall
ChatGPTDeactivate an active paywall. Refused while a running experiment serves it (stop the experiment first). On a live project (a production purchase, or 10+ production customers, in the last 30 days; sample projects never count) the change waits for an owner or admin to approve it: the result is awaiting_approval with an approve_url to pass on.
update_entitlement
ChatGPTUpdate display name, description, or linked products for an existing entitlement. product_ids REPLACES the list. On a live project, a change that removes a product (its buyers lose the entitlement) waits for an owner or admin to approve.
update_feature_flag
ChatGPTTurn a feature flag on (start) or off (stop), change its rollout percentage or variants, or rename it. Name it by flag_id or key. Turning it on needs a rollout_percentage above 0 (100 = everyone). A change to what users get, on a live project (a production purchase, or 10+ production customers, in the last 30 days), waits for an owner or admin to approve it: the result is awaiting_approval with an approve_url to pass on. Editing a flag that stays off applies at once.
update_paywall
ChatGPTApply constrained patch updates to a paywall's draft (copy, title, subtitle, CTA text, brand colors, one element's colours, what is shown or hidden, offering binding, which button buys). On a published paywall this edits the draft only: users keep seeing the published version until publish_paywall.
update_product
ChatGPTUpdate metadata, store IDs, or display pricing for an existing product in this project. On a live project (a production purchase, or 10+ production customers, in the last 30 days) the change is not applied: it becomes an approval request for a project owner or admin, and the result carries the approval link.
use_project
ChatGPTSwitch this connection to another project it may use: the project chosen when it was connected, or one it created with create_project. Every other tool then acts on that project. list_projects marks which ones this connection can use (connection_can_use).
activate_journey
Claudeapply_setup_plan
Claudecreate_campaign
Claudecreate_entitlement
Claudecreate_experiment
Claudecreate_feature_flag
Claudecreate_journey
Claudecreate_message_template
Claudecreate_offering
Claudecreate_paywall_from_template
Claudecreate_placement
Claudecreate_product
Claudecreate_project
Claudecreate_public_sdk_key
Claudecreate_survey
Claudedesign_paywall
Claudediscover_schema
Claudeget_experiment_results
Claudeget_feature_flag_results
Claudeget_paywall
Claudeget_paywall_recipe_guide
Claudeget_project
Claudeget_recent_sdk_activity
Claudeget_saved_view_results
Claudeget_sdk_integration_guide
Claudeget_setup_status
Claudelink_placement
Claudelist_campaigns
Claudelist_cohorts
Claudelist_entitlements
Claudelist_event_names
Claudelist_experiments
Claudelist_feature_flags
Claudelist_journeys
Claudelist_message_templates
Claudelist_offerings
Claudelist_paywalls
Claudelist_placements
Claudelist_products
Claudelist_projects
Claudelist_saved_views
Claudelist_surveys
Claudelist_templates
Claudemanage_offering_packages
Claudepause_journey
Claudepreview_paywall
Claudepublish_paywall
Clauderesolve_placement_preview
Clauderun_analytics_query
Claudeset_current_offering
Claudeset_entitlement_products
Claudestart_experiment
Claudestop_experiment
Claudeunpublish_paywall
Claudeupdate_entitlement
Claudeupdate_feature_flag
Claudeupdate_paywall
Claudeupdate_product
Claudeuse_project
Claude