get_blocked_urls

Instructions

Implementation Reference

• mcp_server_bwt/main.py:502-518 (handler)

  Handler function for the 'get_blocked_urls' tool. Registered via @mcp.tool decorator. Takes site_url as input, calls Bing Webmaster API's GetBlockedUrls endpoint via the api helper, and returns list of blocked URLs with MCP-compatible typing.

  @mcp.tool(name="get_blocked_urls", description="Get list of blocked URLs for a site.")
  async def get_blocked_urls(
      site_url: Annotated[str, "The URL of the site"]
  ) -> List[Dict[str, Any]]:
      """
      Get list of blocked URLs for a site.
  
      Args:
          site_url: The URL of the site
  
      Returns:
          List of blocked URLs
      """
      async with api:
          urls = await api._make_request(f"GetBlockedUrls?siteUrl={site_url}")
          return api._ensure_type_field(urls, "BlockedUrl")

• mcp_server_bwt/main.py:59-111 (helper)

  Core helper method in BingWebmasterAPI class that performs the actual HTTP request to Bing Webmaster API, handles authentication, parameters, errors, and OData response unwrapping. Used by get_blocked_urls.

  async def _make_request(
      self,
      endpoint: str,
      method: str = "GET",
      json_data: Optional[Dict[str, Any]] = None,
      params: Optional[Dict[str, Any]] = None,
  ) -> Any:
      """Make a request to the Bing API and handle OData responses."""
      if not self.client:
          raise RuntimeError(
              "API client not initialized. Use 'async with api:' context manager."
          )
  
      headers = {"Content-Type": "application/json; charset=utf-8"}
  
      # Build URL with API key
      if "?" in endpoint:
          url = f"{self.base_url}/{endpoint}&apikey={self.api_key}"
      else:
          url = f"{self.base_url}/{endpoint}?apikey={self.api_key}"
  
      # Add additional parameters if provided
      if params:
          for key, value in params.items():
              url += f"&{key}={value}"
  
      try:
          if method == "GET":
              response = await self.client.get(url, headers=headers)
          else:
              response = await self.client.request(
                  method, url, headers=headers, json=json_data
              )
  
          if response.status_code != 200:
              error_text = response.text
              logger.error(f"API error {response.status_code}: {error_text}")
              raise Exception(f"API error {response.status_code}: {error_text}")
  
          data = response.json()
  
          # Handle OData response format
          if "d" in data:
              return data["d"]
          return data
  
      except httpx.TimeoutException:
          logger.error(f"Request timeout for {endpoint}")
          raise Exception("Request timed out")
      except Exception as e:
          logger.error(f"Request failed: {str(e)}")
          raise

• mcp_server_bwt/main.py:112-121 (helper)

  Helper method that adds MCP-required __type fields to API response data for compatibility.

  def _ensure_type_field(self, data: Any, type_name: str) -> Any:
      """Ensure __type field is present for MCP compatibility."""
      if isinstance(data, list):
          for item in data:
              if isinstance(item, dict) and "__type" not in item:
                  item["__type"] = f"{type_name}:#Microsoft.Bing.Webmaster.Api"
      elif isinstance(data, dict) and "__type" not in data:
          data["__type"] = f"{type_name}:#Microsoft.Bing.Webmaster.Api"
      return data

• mcp_server_bwt/main.py:502-502 (registration)

  The @mcp.tool decorator registers the get_blocked_urls function as an MCP tool with the specified name and description.

  @mcp.tool(name="get_blocked_urls", description="Get list of blocked URLs for a site.")

• mcp_server_bwt/main.py:124-124 (helper)

  Global instantiation of the BingWebmasterAPI client used by all tools including get_blocked_urls.

  api = BingWebmasterAPI(API_KEY)