MMetadata /docs
Docs/Tools/create_microsoft_price_extension

create_microsoft_price_extension

Add a price-list shown beneath a Microsoft Ads (Bing) ad — 3-8 tiles, each with a plan/product name, a short description, a USD amount, and a billing unit.

Writes extensions

Creates or changes something in the account. Put it behind whatever review your agent uses.

What it does

Add a price-list shown beneath a Microsoft Ads (Bing) ad — 3-8 tiles, each with a plan/product name, a short description, a USD amount, and a billing unit. Standard play for SaaS pricing tiers, subscription plans, course catalogs, service menus, or hotel night rates.

                ALSO KNOWN AS: price extension, pricing, price list, pricing tiers, plan pricing, subscription pricing, price tiles, rate card, fare list

                KEYWORDS: price, pricing, price list, plan, plans, tier, tiers, subscription, monthly, yearly, hourly, daily, fare, rate, cost, dollar, $, USD, microsoft ads, bing, extension

                WHEN TO USE:
                - "Show our pricing tiers under our Microsoft Ads"
                - "Add a Bing price extension with Basic / Pro / Scale plans"
                - "Register monthly subscription prices for the Microsoft Ads campaign"

                WHEN NOT TO USE:
                - Single time-bound discount (Black Friday 20% off, promo code) → use create_microsoft_promotion_extension
                - Non-priced offerings list (just names, no amounts) → use create_microsoft_structured_snippet_extension
                - Same price list for Google Ads → use create_google_price_extension

                INPUTS:
                - price_qualifier: prefix shown before each price. UNSPECIFIED (no prefix) | FROM ("From $X") | UP_TO ("Up to $X") | AVERAGE ("Avg $X").
                - price_offerings: 3-8 tiles. Each tile:
                    - url:         landing page for that tier (non-blank, ≤2000 chars).
                    - header:      tier name (1-25 chars). E.g. "Basic", "Pro", "Scale".
                    - description: short tagline (1-25 chars). E.g. "Starter plan".
                    - amount:      USD number (max 999999999.99, two decimals).
                    - unit:        billing cadence. UNSPECIFIED | PER_HOUR | PER_DAY | PER_WEEK | PER_MONTH | PER_YEAR | PER_NIGHT.

                EXAMPLE:
                create_microsoft_price_extension(
                    price_qualifier="FROM",
                    price_offerings=[
                        {"url": "https://example.com/basic", "header": "Basic",
                         "description": "Starter plan",  "amount": 9.99,  "unit": "PER_MONTH"},
                        {"url": "https://example.com/pro",   "header": "Pro",
                         "description": "Growing teams", "amount": 29.00, "unit": "PER_MONTH"},
                        {"url": "https://example.com/scale", "header": "Scale",
                         "description": "Enterprise",    "amount": 99.00, "unit": "PER_MONTH"},
                    ],
                )

Arguments

ArgumentTypeNotes
price_qualifier string required Price qualifier shown before the price.
one of: UNSPECIFIED, FROM, UP_TO, AVERAGE
price_offerings array required 3-8 price offerings.

Request

curl
curl -s -X POST https://mcp-server.metadata.io/mcp \
  -H "Authorization: $METADATA_PAT" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-11-25" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"create_microsoft_price_extension","arguments":{"price_qualifier":"UNSPECIFIED","price_offerings":[]}}}'

Response

No recorded response. This tool writes to the account, so it is never executed to build these docs. The request above is still the exact shape to send. Nothing on this page is invented.

Other extensions tools:

All 160 tools · machine-readable index