get_site_roles
Retrieve all role assignments for a specific site, including optional subdomains, using the Bing Webmaster Tools API. Simplifies role management and access control for webmasters.
Instructions
Get all roles assigned for a specific site.
Args: site_url: The URL of the site include_all_subdomains: Whether to include roles for all subdomains
Returns: List[SiteRole]: List of role assignments for the site
Raises: BingWebmasterError: If the roles cannot be retrieved
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include_all_subdomains | No | ||
| self | Yes | ||
| site_url | Yes |
Implementation Reference
- Generic handler wrapper function that executes all Bing Webmaster tools, including get_site_roles. It binds the tool call to the appropriate sub-service method (site_management.SiteManagementService.get_site_roles) using the provided service_attr='sites' and method_name='get_site_roles' from registration.@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__
- mcp_server_bwt/tools/bing_webmaster.py:89-89 (registration)Specific registration of the 'get_site_roles' tool by invoking wrap_service_method with parameters targeting the sites service's get_site_roles method.get_site_roles = wrap_service_method(mcp, service, "sites", "get_site_roles") # noqa: F841
- Helper function that generates the MCP tool handler, copies schema from original service method, and delegates execution to the underlying Bing Webmaster service method.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/main.py:17-17 (registration)Top-level registration call that adds all Bing Webmaster tools, including get_site_roles, to the MCP server.add_bing_webmaster_tools(mcp, bing_service)
- Initializes the 'sites' sub-service instance used by the get_site_roles tool handler.self.sites = site_management.SiteManagementService(self.client)