MMetadata /docs
⌘K
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

Request template, not a complete runnable example. Replace placeholders, empty objects, arrays, and zero values with valid account-specific inputs. Read required fields and nested constraints in the full schema. Confirm the account, connected channels, and referenced assets before calling a write tool.

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 is an illustrative template. Fill required fields and check the current schema before calling it. No response is fabricated.

Other extensions tools:

Browse the tool catalog · machine-readable index