Skip to main content

​
Overview

Playbook pricing is the set of pricing facts your storefront gives the Merchandising Agent so it prices products the way you would. Instead of a static rate card returned to every buyer, you hand over the anchors — “rich media runs around a $30 CPM”, “never quote CTV below $22”, “holiday inventory carries a premium” — and the agent applies them as it composes a proposal for the buyer in front of it. A pricing fact is deliberately lightly structured: a short label, a natural-language condition describing when it applies, and a price anchor (target, floor, and/or ceiling). It is reasoning context for the agent, not a rigid product template. This is where the numbers from your rate card, media kit, or a setup-call conversation live.
These are your product-pricing facts, separate from any Scope3 contract rate card. They price the inventory you sell through your storefront.

​
What a rate card holds

The portable Playbook Page lets you review and edit structured pricing alongside versioned selling guidance in any MCP Apps host. The same configuration is available through the storefront’s compositionPricing field — a StorefrontCompositionPricing object: Each pricing fact (StorefrontPricingFact): Every fact must carry at least one of targetPrice or floorPrice.

​
Where you set it

  • In chat with Murph — the fastest path. Ask Murph to set your rate card or update pricing terms; get_playbook opens the portable editor. You can finish the change there, or Murph can apply an exact confirmed replacement through write_pricing_rules.
  • Any MCP Apps client — call get_playbook to open the same editor in Claude, ChatGPT, or another compatible host.
  • REST — PUT /api/v2/storefront with a compositionPricing object. The full nested structure is returned on GET /api/v2/storefront.

​
How pricing reaches discovery

When a buyer discovers products, the Merchandising Agent reads your pricing facts, matches them against the brief, and anchors each composed product’s price accordingly. The price surfaces on the discovered product as:
  • cpm — the quoted price, in the pricing scope’s currency.
  • currency — ISO 4217, inherited from your rateCard.currency unless the buyer’s currency requires conversion.
  • pricingScope — public (your open rate-card price) or account (a buyer-specific price, e.g. after a house discount).
Two guardrails always hold:
  • The wholesale floor wins. Every quote is floored at the storefront’s wholesale cost. A pricing fact can raise or shape a price, but the agent never composes a quote below cost.
  • Buyer currency must be accepted. Discovery only returns priced products in a currency on the storefront’s accepted list; otherwise no products are returned (see cross-currency).

​
Playbook pricing vs. discounts

Playbook pricing sets your base pricing — what any buyer sees. To give a specific buyer a better price, layer a discount on top:

House discounts

Structured rate-card discounts keyed to a buyer’s brand or operator.

Buyer instructions

Freeform per-buyer terms, notes, and operator-and-brand intersections.

Merchandising agent

How the agent turns what you have into a priced proposal.

Playbook guidance

The rules the agent follows when composing products.