MCP Tools¶
55 tools are exposed by this MCP server, covering the full range of everyday Bing Webmaster Tools operations -- site management, sitemaps, URL submission and indexing, crawl diagnostics, search analytics, keyword research, URL normalization, geo-targeting, connected pages, and page preview blocks -- plus IndexNow support for instant re-indexing. All tools work identically across the Go and C# implementations.
| Tool | Area | Description |
|---|---|---|
list_sites |
Sites | List all sites in your Bing Webmaster account |
add_site |
Sites | Add a new site |
verify_site |
Sites | Attempt to verify ownership of a site |
remove_site |
Sites | Remove a site (destructive) |
get_site_roles |
Site Access | List delegated user access to a site |
add_site_role |
Site Access | Delegate site access to a user |
remove_site_role |
Site Access | Revoke a user's delegated access |
list_sitemaps |
Sitemaps | List submitted sitemaps for a site |
get_sitemap_details |
Sitemaps | Get details for one submitted sitemap |
submit_sitemap |
Sitemaps | Submit a sitemap URL |
remove_sitemap |
Sitemaps | Remove a submitted sitemap |
submit_url |
URL Submission | Submit a single URL for indexing |
submit_url_batch |
URL Submission | Submit up to 500 URLs in one call |
submit_url_indexnow |
URL Submission | Ping the IndexNow protocol for instant (re)indexing |
get_url_submission_quota |
URL Submission | Check remaining daily/monthly submission quota |
submit_content |
Content Submission | Submit raw content directly for a URL |
get_content_submission_quota |
Content Submission | Check remaining content submission quota |
get_crawl_issues |
Crawling | List URLs with crawl issues |
get_crawl_stats |
Crawling | Daily crawl statistics |
get_url_info |
URL & Index Inspection | Index status/details for a single URL |
get_url_traffic_info |
URL & Index Inspection | Clicks/impressions for a single URL |
get_url_links |
URL & Index Inspection | Inbound links to a specific URL |
get_link_counts |
URL & Index Inspection | Pages with inbound links |
get_children_url_info |
Directory Inspection | Index details for every URL under a directory |
get_children_url_traffic_info |
Directory Inspection | Traffic for every URL under a directory |
get_blocked_urls |
Blocked URLs | List blocked pages/directories |
add_blocked_url |
Blocked URLs | Block a page or directory |
remove_blocked_url |
Blocked URLs | Unblock a page or directory |
fetch_url |
Fetch Diagnostics | Request an immediate Bing crawl of a URL |
list_fetched_urls |
Fetch Diagnostics | List URLs submitted for fetch requests |
get_fetched_url_details |
Fetch Diagnostics | Full result of a fetch request |
get_site_moves |
Site Moves | List site move requests |
submit_site_move |
Site Moves | Notify Bing of a site migration |
get_rank_and_traffic_stats |
Search Analytics | Daily clicks/impressions over time |
get_query_stats |
Search Analytics | Top queries by clicks/impressions |
get_page_stats |
Search Analytics | Top pages by clicks/impressions |
get_page_query_stats |
Search Analytics | Queries driving traffic to one page |
get_query_page_stats |
Search Analytics | Pages ranking for one query |
get_query_page_detail_stats |
Search Analytics | Detailed daily stats for one query+page |
get_query_traffic_stats |
Search Analytics | Daily stats for one query, site-wide |
get_keyword_stats |
Search Analytics | Historical keyword impression stats (market-wide) |
get_keyword |
Keyword Research | Market-wide impressions for one keyword/period |
get_related_keywords |
Keyword Research | Discover related keywords with impression data |
get_query_parameters |
URL Normalization | List URL normalization query parameters |
add_query_parameter |
URL Normalization | Add a query parameter Bing should ignore |
remove_query_parameter |
URL Normalization | Remove a query parameter |
enable_disable_query_parameter |
URL Normalization | Toggle a query parameter on/off |
get_country_region_settings |
Geo-Targeting | List geo-targeting settings |
add_country_region_settings |
Geo-Targeting | Target a page/directory/domain/subdomain at a country |
remove_country_region_settings |
Geo-Targeting | Remove a geo-targeting setting |
get_connected_pages |
Connected Pages | List pages connected to your site |
add_connected_page |
Connected Pages | Declare a connected page |
get_active_page_preview_blocks |
Page Preview Blocks | List active page preview blocks |
add_page_preview_block |
Page Preview Blocks | Block a page's search result preview |
remove_page_preview_block |
Page Preview Blocks | Unblock a page's search result preview |
Common Notes¶
site_url¶
Most tools take a site_url parameter -- this must be a site already added and (for most
operations) verified in your Bing Webmaster account. Use list_sites to see the
exact URLs your API key has access to. A few tools (get_keyword, get_related_keywords,
get_keyword_stats) are market-wide and don't take a site_url at all.
Error Responses¶
All tools return a JSON error object when an exception occurs, instead of breaking the MCP session:
Timestamps¶
Read tools include a queriedAt timestamp (ISO-8601 UTC). Write/submission tools echo the key
inputs plus a submittedAt/requestedAt timestamp and a success indicator. All dates are
normalized to ISO-8601 -- Bing's underlying /Date(...)/ wire format is never exposed to the
client.
Date ranges¶
Only get_keyword and get_related_keywords accept
a start_date/end_date parameter. Every other analytics tool (get_rank_and_traffic_stats,
get_query_stats, get_page_stats, get_page_query_stats, get_query_page_stats,
get_query_page_detail_stats, get_query_traffic_stats, get_keyword_stats) returns a fixed
window decided by Bing, with no way to request a specific period. Some of these return one row per
day, but that's a property of the response, not a request parameter -- there's no input that
narrows it.
get_query_stats vs get_page_stats¶
Bing's API reuses one underlying response shape across several endpoints. get_query_stats and
get_page_query_stats return a query field holding a search query; get_page_stats and
get_query_page_stats return a page field holding a page URL, using the same underlying data
shape. This server renames the field appropriately per tool so the output is unambiguous.
Destructive and consequential tools¶
Most write tools are safely reversible (add_blocked_url / remove_blocked_url, submit_sitemap
/ remove_sitemap, add_country_region_settings / remove_country_region_settings,
add_page_preview_block / remove_page_preview_block). A few are not: remove_site permanently
drops a site's history from your account view, submit_site_move tells Bing to treat one site as
superseded by another in a way that isn't easily undone, and add_connected_page has no matching
removal tool in Bing's API at all. Use all three with care.