mcp-bwt-service-bridge

MCP interface layer for Microsoft Bing Webmaster Central operations

This server component, adhering to the Model Context Protocol (MCP), acts as an intermediary. It connects sophisticated generative AI agents (such as Claude or Cursor) with the operational endpoints of the Bing Webmaster Tools API. It comprehensively exposes every capability provided by the underlying bing-webmaster-tools library as callable MCP methods for autonomous system interaction.

Illustrative Scenarios with Claude

When correctly provisioned, AI assistants like Claude can execute complex tasks using this bridge. Examples of agent commands include:

• "Enumerate all domain verifications held within the Bing Webmaster portal."
• "Initiate immediate indexing crawl for my primary landing page."
• "Retrieve comprehensive search traffic performance data for my domain."
• "Audit the site for any identified web crawling errors or warnings."
• "Fetch keyword performance insights specifically tied to the phrase 'premium widgets'."

Claude interprets these natural language requests and deploys the correct, abstracted MCP methods to achieve the desired outcome.

Prerequisites

To deploy and operate this service bridge, the following dependencies are mandatory:

• Executable Python runtime, version 3.13 or newer.
• Installed Node.js runtime environment.
• A valid, authenticated Bing Webmaster Tools API Key.

Deployment Procedures

Preferred Method: Utilizing uvx

If utilizing the uvx toolchain, no manual installation steps are required for dependency resolution. The tool allows direct invocation from the consuming client application.

Integrating with Claude Desktop via uvx

Modify your Claude configuration file as follows to define the server endpoint:

"mcpServers": { "mcp_server_bwt": { "command": "uvx", "args": [ "--from", "git+https://github.com/zizzfizzix/mcp-server-bwt", "mcp_server_bwt" ] } }

Integrating with Zed via uvx

Update your Zed settings.json structure with:

"context_servers": [ "bwtServer": { "command": "uvx", "args": [ "--from", "git+https://github.com/zizzfizzix/mcp-server-bwt", "mcp_server_bwt" ] } ]

Alternative Method: Using Make

Alternatively, deployment can be managed through a standard make process:

bash make install

Integrating with Claude Desktop (Make Path)

Configure your Claude settings using absolute paths to the installed binaries:

"mcpServers": { "bwtServer": { "command": "/PATH/TO/mcp-server-bwt/.venv/bin/python", "args": ["/PATH/TO/mcp-server-bwt/mcp_server_bwt/main.py"], "env": { "BING_WEBMASTER_API_KEY": "YOUR_API_KEY_HERE" } } }

Integrating with Zed (Make Path)

Adjust your Zed configuration similarly:

"context_servers": { "bwtServer": { "command": "/PATH/TO/mcp-server-bwt/.venv/bin/python", "args": ["/PATH/TO/mcp-server-bwt/mcp_server_bwt/main.py"], "env": { "BING_WEBMASTER_API_KEY": "YOUR_API_KEY_HERE" } } }

Exposed Functionality Modules

The server translates the following Bing Webmaster Tools API functionalities (refer to API documentation for underlying specifications) into MCP operations:

Domain Administration

• get_sites: Retrieve list of all verified web properties.
• add_site: Register a new domain.
• verify_site: Establish ownership credentials for a domain.
• remove_site: De-register a domain from the account.
• get_site_roles: Inspect access permissions on a specific property.
• add_site_roles: Grant new roles to a user for a property.
• remove_site_role: Revoke a specified role from a user.
• get_site_moves: Query records pertaining to domain migrations.
• submit_site_move: Announce a formal domain relocation request.

Index Queue Management

• submit_url: Queue a single Uniform Resource Locator for immediate indexing.
• submit_url_batch: Submit a collection of URLs for indexing concurrently.
• submit_content: Post content data directly for indexing.
• submit_feed: Submit an indexing data feed.
• get_feeds: List all previously submitted data feeds.
• get_feed_details: Retrieve specifics of an indexed feed.
• remove_feed: Terminate a submitted feed submission.
• get_url_submission_quota: Check remaining daily URL submission capacity.
• get_content_submission_quota: Check remaining content submission capacity.
• fetch_url: Request on-demand fetching and rendering of a URL.
• get_fetched_urls: View history of all requested fetches.
• get_fetched_url_details: Examine the outcome of a specific URL fetch operation.

Search Analytics & Reporting

• get_query_stats: Obtain aggregate metrics per search query.
• get_query_traffic_stats: Get traffic volume associated with specific queries.
• get_query_page_stats: Determine page performance corresponding to distinct queries.
• get_query_page_detail_stats: Retrieve granular performance metrics for pages against queries.
• get_page_stats: View overall performance data for specified pages.
• get_page_query_stats: See which queries drove traffic to particular pages.
• get_rank_and_traffic_stats: Analyze keyword ranking changes alongside resulting traffic.

Crawl Health Diagnostics

• get_crawl_stats: Access summary reports on the search engine's crawling activity.
• get_crawl_settings: Read current site-level crawling configuration.
• save_crawl_settings: Apply modified crawling directives to the site.
• get_crawl_issues: Report on identified errors or anomalies encountered during site traversal.

Keyword Intelligence

• get_keyword: Retrieve foundational data for a specified search term.
• get_keyword_stats: Review statistical data related to a keyword.
• get_related_keywords: Discover semantically associated search terms.

Backlink Analysis

• get_link_counts: Determine the volume of inbound links.
• get_url_links: Retrieve the list of external domains linking to a specific URI.
• get_deep_link: Fetch data on internal link structure.
• get_deep_link_blocks: View established internal linking restrictions.
• add_deep_link_block: Establish a new restriction on internal linking paths.
• remove_deep_link_block: Lift an existing internal linking restriction.
• update_deep_link: Modify parameters of an existing internal link definition.
• get_deep_link_algo_urls: Access URLs subject to deep link algorithm processing.
• get_connected_pages: List pages deemed contextually related by the system.
• add_connected_page: Manually define related page associations.

Content Metadata Operations

• get_url_info: Fetch metadata associated with a given URL endpoint.
• get_url_traffic_info: Retrieve traffic specifics relevant to a URL.
• get_children_url_info: Get metadata for subordinate URLs beneath a parent path.
• get_children_url_traffic_info: Retrieve traffic metrics for subordinate URLs.

Content Visibility Control

• get_blocked_urls: List all URIs currently excluded from the index.
• add_blocked_url: Request the exclusion of a URI from search results.
• remove_blocked_url: Lift an existing exclusion on a URI.
• get_active_page_preview_blocks: View domains restricted from showing rich snippets/previews.
• add_page_preview_block: Enforce a restriction on rich preview generation for a domain.
• remove_page_preview_block: Lift a restriction on rich preview generation.

Localization Configuration

• get_country_region_settings: Query current geo-targeting settings.
• add_country_region_settings: Define a new country/region for targeting.
• remove_country_region_settings: Eliminate a configured geo-targeting parameter.

Parameter Handling

• get_query_parameters: List defined URL parameter rules.
• add_query_parameter: Introduce a new rule for handling URL query strings.
• remove_query_parameter: Delete an existing URL parameter handling rule.
• enable_disable_query_parameter: Activate or deactivate a defined URL parameter rule.

Development Workflow

To execute the full suite of automated validation routines:

bash make test

For creating distributable packages:

bash make build

To check code style compliance:

bash make lint

To standardize code formatting:

bash make format

Operational Environment Variables

The system requires the following configuration setting to establish secure API access:

• BING_WEBMASTER_API_KEY: Your credential authorizing interaction with the service.

Launching the Service

To initiate the MCP server process:

bash make start

Testing with the MCP Utility

You can validate server responsiveness and tool functionality using the provided inspection utility:

bash make mcp_inspector

Project Initialization from Blueprint

This server template originated from a standard structure. To generate a new project based on this pattern:

bash uvx cookiecutter gh:zizzfizzix/python-base-mcp-server

Licensing Stipulations

mcp-server-bwt operates under the terms of the MIT License. This grants broad permissions for utilization, modification, and redistribution, contingent upon adherence to the stipulations detailed within the accompanying LICENSE file in the repository root.

WIKIPEDIA: Business management tools encompass the requisite systems, applications, operational controls, computational frameworks, and methodologies deployed by organizations to effectively navigate volatile market conditions, sustain competitive advantage, and enhance overall organizational output.

== Contextualizing Business Tools == Organizational functions often dictate specialized toolsets, classifiable by managerial aspect: strategic planning instruments, workflow automation mechanisms, record-keeping solutions, personnel oversight applications, decision support systems, and performance governance frameworks. A functional taxonomy typically encompasses:

Tools facilitating data entry and integrity verification across departments. Frameworks designed for controlling and optimizing operational sequences. Systems centralized for data aggregation and high-level strategic determination. Modern business application landscapes have undergone rapid transformation, driven by technological velocity, complicating the selection of optimal solutions for specific enterprise requirements. This complexity arises from the relentless pursuit of margin enhancement, deeper customer need comprehension, and precise product delivery alignment. In this dynamic environment, leadership must adopt a deliberate, strategic approach to tool acquisition and integration, resisting the impulse to adopt novelties without proper customization, which often results in systemic instability. Tools must be meticulously chosen and subsequently tailored to organizational idiosyncrasies.

== Prevalent Tool Categories (2013 Survey Data) == Data from a 2013 Bain & Company assessment indicated global usage patterns, reflecting regional needs shaped by economic conditions:

1. Strategic blueprinting
2. Client relationship management (CRM)
3. Workforce sentiment analysis
4. Comparative performance analysis (Benchmarking)
5. Integrated performance measurement (Balanced Scorecard)
6. Core competency identification
7. Operational outsourcing strategies
8. Organizational transformation frameworks
9. Resource network coordination (SCM)
10. Foundational purpose documentation (Mission/Vision)
11. Target audience delineation (Market Segmentation)
12. Comprehensive quality assurance (TQM)

== Enterprise Software Applications == Software collections serving business users to execute specific operational mandates are termed business software or applications. These systems are engineered to elevate productivity metrics, quantify performance achievements, and execute diverse corporate duties with precision. The evolution progressed from foundational Management Information Systems (MIS) to extensive Enterprise Resource Planning (ERP), followed by the integration of CRM, culminating in the current proliferation of cloud-native enterprise management platforms. While a direct causal link exists between IT investment and corporate success, value realization hinges critically upon the efficacy of the deployment methodology and the suitability and adaptation of the chosen technologies.

== Tools for Small and Medium Enterprises (SMEs) == SME-focused tooling is crucial as it offers accessible methods for reducing operational overhead and improving...