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
| Argument | Type | Notes | |
|---|---|---|---|
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.
Related
Other extensions tools: