MMetadata /docs
⌘K
Docs/Tools/create_microsoft_sitelink_extension

create_microsoft_sitelink_extension

Add an extra clickable shortcut (sitelink) that appears beneath a Microsoft Ads (Bing) ad — helpful deep-links like "See Pricing", "Book a Demo", or "Contact Sales" with two sho…

Writes extensions

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

What it does

Add an extra clickable shortcut (sitelink) that appears beneath a Microsoft Ads (Bing) ad — helpful deep-links like "See Pricing", "Book a Demo", or "Contact Sales" with two short description lines. Sitelinks lift click-through rate by giving searchers alternate landing paths to the same advertiser.

                ALSO KNOWN AS: sitelink, site link, extra link, ad link, secondary link, deep link, additional link, jump link

                KEYWORDS: sitelink, site link, link, deep link, shortcut, microsoft ads, bing, extension, pricing link, demo link, contact link, landing page, CTR, click through

                WHEN TO USE:
                - "Add a sitelink to our Microsoft Ads / Bing library"
                - "Create a 'See Pricing' / 'Book a Demo' / 'Contact Sales' link extension for Bing"
                - "Register a new Microsoft Ads sitelink for the homepage redesign"

                WHEN NOT TO USE:
                - Want a non-clickable selling-point snippet ("Free Shipping", "24/7 Support") → use create_microsoft_callout_extension
                - Want a labeled list of offerings (e.g. "Brands: Nest, Nexus") → use create_microsoft_structured_snippet_extension
                - Same sitelink for Google Ads → use create_google_sitelink_extension (library entries are per-channel)
                - Anything for Facebook / LinkedIn / Reddit — ad extensions are a search-channel-only concept

                INPUTS (all required):
                - url:          destination the sitelink opens.
                - link_text:    visible link text (1-25 chars).
                - description1: first description line under the link (1-35 chars).
                - description2: second description line (1-35 chars).

                EXAMPLE:
                create_microsoft_sitelink_extension(
                    url="https://example.com/pricing",
                    link_text="See Pricing",
                    description1="Plans for every team size",
                    description2="Start free, upgrade anytime",
                )

                Returns the persisted extension (id, externalId, type=SITELINK, channel=MICROSOFT_ADS). A 400 usually means a character-limit was exceeded.

Arguments

ArgumentTypeNotes
url string required Destination URL the sitelink points to (non-blank).
link_text string required Visible link text. 1-25 characters.
description1 string required First description line. 1-35 characters.
description2 string required Second description line. 1-35 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_sitelink_extension","arguments":{"url":"<url>","link_text":"<link_text>","description1":"<description1>","description2":"<description2>"}}}'

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