get_blocked_urls
Retrieve blocked pages and directories for a site. Get a list of URLs blocked by Bing Webmaster Tools with their settings to identify and manage blocked content.
Instructions
Get a list of blocked pages/directories for a site.
Args: site_url: The URL of the site
Returns: List[BlockedUrl]: List of blocked URLs and their settings
Raises: BingWebmasterError: If blocked URLs cannot be retrieved
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| self | Yes | ||
| site_url | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- The `wrap_service_method` function is the generic handler wrapper that dynamically wraps any service method as an MCP tool. For 'get_blocked_urls', it wraps `content_blocking.ContentBlockingService.get_blocked_urls` by calling `wrap_service_method(mcp, service, 'blocking', 'get_blocked_urls')`.
def wrap_service_method( mcp: FastMCP, service: BingWebmasterService, service_attr: str, method_name: str ) -> Callable[..., Any]: """Helper function to wrap a service method with mcp.tool() while preserving its signature and docstring. Args: mcp: The MCP server instance service: The BingWebmasterService instance service_attr: The service attribute name (e.g., 'sites', 'submission') method_name: The method name to wrap Returns: The wrapped method as an MCP tool """ # Get the service class from our mapping service_class = SERVICE_CLASSES[service_attr] # Get the original method original_method = getattr(service_class, method_name) # Get the signature sig = inspect.signature(original_method) # Remove 'self' parameter from signature parameters = list(sig.parameters.values())[1:] # Skip 'self' # Create new signature without 'self' new_sig = sig.replace(parameters=parameters) # Create wrapper function with same signature @mcp.tool() @wraps(original_method) async def wrapper(*args: Any, **kwargs: Any) -> Any: # Filter out any 'self' arguments that might be passed by the MCP client kwargs = {k: v for k, v in kwargs.items() if k != "self"} async with service as s: service_obj = getattr(s, service_attr) # Get the method from the instance method = getattr(service_obj, method_name) # Call the method directly - it's already bound to the instance return await method(*args, **kwargs) # Copy signature and docstring wrapper.__signature__ = new_sig # type: ignore wrapper.__doc__ = original_method.__doc__ return wrapper - mcp_server_bwt/tools/bing_webmaster.py:196-196 (registration)The registration line that creates the 'get_blocked_urls' MCP tool by wrapping the 'get_blocked_urls' method from the 'blocking' (ContentBlockingService) service.
get_blocked_urls = wrap_service_method(mcp, service, "blocking", "get_blocked_urls") # noqa: F841 - The service initialization in `__aenter__` where `self.blocking` is instantiated as `content_blocking.ContentBlockingService(self.client)`, which is the service object whose `get_blocked_urls` method will be called.
async def __aenter__(self) -> "BingWebmasterService": self.client = BingWebmasterClient(self.settings) await self.client.__aenter__() # Expose all services directly self.sites = site_management.SiteManagementService(self.client) self.submission = submission.SubmissionService(self.client) self.traffic = traffic_analysis.TrafficAnalysisService(self.client) self.crawling = crawling.CrawlingService(self.client) self.keywords = keyword_analysis.KeywordAnalysisService(self.client) self.links = link_analysis.LinkAnalysisService(self.client) self.content = content_management.ContentManagementService(self.client) self.blocking = content_blocking.ContentBlockingService(self.client) self.regional = regional_settings.RegionalSettingsService(self.client) self.urls = url_management.UrlManagementService(self.client) - mcp_server_bwt/tools/bing_webmaster.py:22-33 (registration)The SERVICE_CLASSES mapping that maps 'blocking' to `content_blocking.ContentBlockingService`, used by `wrap_service_method` to resolve the service class and its methods.
SERVICE_CLASSES = { "sites": site_management.SiteManagementService, "submission": submission.SubmissionService, "traffic": traffic_analysis.TrafficAnalysisService, "crawling": crawling.CrawlingService, "keywords": keyword_analysis.KeywordAnalysisService, "links": link_analysis.LinkAnalysisService, "content": content_management.ContentManagementService, "blocking": content_blocking.ContentBlockingService, "regional": regional_settings.RegionalSettingsService, "urls": url_management.UrlManagementService, } - mcp_server_bwt/main.py:1-17 (handler)The main entry point that creates the MCP server and calls `add_bing_webmaster_tools(mcp, bing_service)` which registers all tools including 'get_blocked_urls'.
import os from mcp.server.fastmcp import FastMCP from mcp_server_bwt.services.bing_webmaster import BingWebmasterService from mcp_server_bwt.tools.bing_webmaster import add_bing_webmaster_tools mcp = FastMCP("mcp-server-bwt") # Initialize Bing Webmaster Tools service api_key = os.getenv("BING_WEBMASTER_API_KEY") if not api_key: raise ValueError("BING_WEBMASTER_API_KEY environment variable is required") # Create the service with the API key bing_service = BingWebmasterService(api_key=api_key) # Add the tools to the MCP server add_bing_webmaster_tools(mcp, bing_service)