MMetadata /docs
Docs/Tools/create_microsoft_structured_snippet_extension

create_microsoft_structured_snippet_extension

Add a labeled list of offerings (structured snippet) shown beneath a Microsoft Ads (Bing) ad — a category header plus 3-10 short items, e.g.

Writes extensions

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

What it does

Add a labeled list of offerings (structured snippet) shown beneath a Microsoft Ads (Bing) ad — a category header plus 3-10 short items, e.g. header "Brands" with values "Nest", "Nexus", "Chromebook", or header "Services" with "Hosting", "DNS", "CDN". Helps searchers self-qualify before clicking.

                ALSO KNOWN AS: structured snippet, snippet, category list, offering list, header values, product list, service list

                KEYWORDS: structured snippet, snippet, header, values, brands, services, products, courses, destinations, list, category, microsoft ads, bing, extension

                WHEN TO USE:
                - "Add a structured snippet listing our service tiers on Microsoft Ads"
                - "Create a Bing snippet under 'Brands' with Nest, Nexus, Chromebook"
                - "Register a list of supported integrations as a Microsoft Ads snippet extension"

                WHEN NOT TO USE:
                - Want a single phrase (e.g. "Free Shipping") → use create_microsoft_callout_extension
                - Want clickable links to subpages → use create_microsoft_sitelink_extension
                - Want a pricing table (with amounts) → use create_microsoft_price_extension
                - Same snippet for Google Ads → use create_google_structured_snippet_extension

                INPUTS:
                - header: snippet category title (1-25 chars). Microsoft Ads mirrors Google's predefined header vocabulary ("Brands", "Models", "Service catalog", "Insurance coverage", etc.) — pass the chosen header string here.
                - values: 3-10 items, each 1-25 chars.

                EXAMPLE:
                create_microsoft_structured_snippet_extension(
                    header="Brands",
                    values=["Nest", "Nexus", "Chromebook"],
                )

Arguments

ArgumentTypeNotes
header string required Snippet header. 1-25 characters.
values array required 3-10 snippet values, each 1-25 characters.

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_structured_snippet_extension","arguments":{"header":"<header>","values":[]}}}'

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