MCP Server for Bing Webmaster Tools

An MCP (Model Context Protocol) server that provides access to Bing Webmaster Tools functionality through Claude and other MCP-compatible AI assistants.

🚀 Quick Start

For Claude Code Users:

# Add the MCP server with your API key
claude mcp add bing-webmaster -e BING_WEBMASTER_API_KEY=your_api_key_here -- npx -y @isiahw1/mcp-server-bing-webmaster@latest

# Launch Claude Code
claude

For Claude Desktop Users:

Add to your configuration (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "bing-webmaster": {
      "command": "npx",
      "args": ["-y", "@isiahw1/mcp-server-bing-webmaster@latest"],
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Get your API key from Bing Webmaster Tools → Settings → API Access

Table of Contents

• Features
• Installation
• Configuration
  • Claude Code (Detailed Guide)
  • Claude Desktop (Detailed Guide)
  • Cursor
  • Windsurf
  • Development Setup
• Available Tools
• Usage Examples
• Development
• Contributing
• Support

Features

• 🚀 Direct API Integration: Simple and reliable access to Bing Webmaster Tools
• 📊 Comprehensive Features: Site management, traffic analytics, crawl data, and more
• 🛡️ Error Handling: Robust error handling with detailed logging
• 🎯 MCP Compliant: Full compatibility with Model Context Protocol
• 📈 Rich Functionality: URL submission, keyword analysis, sitemap management, and more

Installation

Prerequisites

• Node.js 16+ (for npm/npx)
• Python 3.10+ (python.org)
• Bing Webmaster API key (Get your API key)

Quick Start

The easiest way to use this MCP server is through npx (no installation required):

npx @isiahw1/mcp-server-bing-webmaster@latest

Global Installation (Optional)

npm install -g @isiahw1/mcp-server-bing-webmaster

Development Installation

For contributors and developers:

git clone https://github.com/isiahw1/mcp-server-bing-webmaster.git
cd mcp-server-bing-webmaster
uv pip install -e .

Configuration

1. Get your Bing Webmaster API Key

1. Sign in to Bing Webmaster Tools
2. Go to Settings → API Access
3. Generate your API key

2. Client Setup Instructions

Option 1: Quick Setup (Recommended)

# Add the MCP server with inline API key
claude mcp add bing-webmaster -e BING_WEBMASTER_API_KEY=your_api_key_here -- npx -y @isiahw1/mcp-server-bing-webmaster@latest

# Launch Claude Code
claude

Option 2: Using System Environment Variable

# Set your API key
export BING_WEBMASTER_API_KEY="your_api_key_here"

# Add the MCP server
claude mcp add bing-webmaster -- npx -y @isiahw1/mcp-server-bing-webmaster@latest

# Launch Claude Code
claude

Option 3: Using Environment File

# Create .env file
echo "BING_WEBMASTER_API_KEY=your_api_key_here" > .env

# Add the MCP server
claude mcp add bing-webmaster -- npx -y @isiahw1/mcp-server-bing-webmaster@latest

# Launch Claude Code
claude

Troubleshooting

If you encounter issues, run with debug mode:

claude --mcp-debug

1. Open Claude Desktop
2. Go to Claude → Settings
3. Select Developer from the sidebar
4. Click Edit Config
5. Add the following to your configuration:

{
  "mcpServers": {
    "bing-webmaster": {
      "command": "npx",
      "args": ["-y", "@isiahw1/mcp-server-bing-webmaster@latest"],
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

6. Save the file and restart Claude Desktop

Configuration file locations:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

1. Launch Cursor
2. Open Cursor → Settings → Cursor Settings
3. Select MCP in the left sidebar
4. Click Add new global MCP server
5. Paste this configuration:

{
  "mcpServers": {
    "bing-webmaster": {
      "command": "npx",
      "args": ["-y", "@isiahw1/mcp-server-bing-webmaster@latest"],
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

6. Restart Cursor

1. Open Windsurf
2. Navigate to Settings → MCP Configuration
3. Add the following configuration:

{
  "mcpServers": {
    "bing-webmaster": {
      "command": "npx",
      "args": ["-y", "@isiahw1/mcp-server-bing-webmaster@latest"],
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

4. Restart Windsurf

For developers working with the source code:

# Clone the repository
git clone https://github.com/isiahw1/mcp-server-bing-webmaster.git
cd mcp-server-bing-webmaster

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv pip install -e .

Claude Desktop Configuration for Development

{
  "mcpServers": {
    "bing-webmaster-dev": {
      "command": "uv",
      "args": ["run", "python", "-m", "mcp_server_bwt"],
      "cwd": "/path/to/mcp-server-bing-webmaster",
      "env": {
        "BING_WEBMASTER_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code Configuration for Development

# Set environment variable
export BING_WEBMASTER_API_KEY="your_api_key_here"

# Run from the project directory
cd /path/to/mcp-server-bing-webmaster
claude mcp add bing-webmaster-dev -- uv run python -m mcp_server_bwt

3. Verify Installation

After configuration, you should be able to:

• See "bing-webmaster" in your MCP servers list
• Use commands like "Show me all my sites in Bing Webmaster Tools"
• Access all Bing Webmaster Tools functions

Troubleshooting

"Could not attach to MCP server" error:

1. Check your API key is correct
2. Ensure you have internet connectivity
3. For Claude Desktop: Check logs in Settings → Developer → Open Logs Folder
4. For Claude Code: Run with claude --mcp-debug

"spawn mcp-server-bing-webmaster ENOENT" error:

• Make sure you're using npx as the command, not mcp-server-bing-webmaster
• If you have an old global installation, uninstall it: npm uninstall -g @isiahw1/mcp-server-bing-webmaster

Available Tools

Site Management

• get_sites - List all verified sites in your account
• add_site - Add a new site to Bing Webmaster Tools
• verify_site - Verify ownership of a site
• remove_site - Remove a site from your account
• get_site_roles - Get list of users with access to the site
• add_site_roles - Delegate site access to another user

Traffic Analysis

• get_query_stats - Get search query performance data
• get_page_stats - Get page-level traffic statistics
• get_rank_and_traffic_stats - Get overall ranking and traffic data
• get_query_page_stats - Get detailed traffic statistics for a specific query
• get_query_page_detail_stats - Get statistics for specific query-page combinations
• get_url_traffic_info - Get traffic information for specific URLs

Crawling & Indexing

• get_crawl_stats - View crawl statistics and bot activity
• get_crawl_issues - Get crawl errors and issues
• get_crawl_settings - Get crawl settings for a site
• update_crawl_settings - Update crawl settings (slow/normal/fast)
• get_url_info - Get detailed index information for a specific URL

URL Management

• submit_url - Submit a single URL for indexing
• submit_url_batch - Submit multiple URLs at once
• get_url_submission_quota - Check your URL submission limits

Content Submission

• submit_content - Submit page content directly without crawling
• get_content_submission_quota - Get content submission quota information

Sitemaps & Feeds

• submit_sitemap - Submit a new sitemap
• remove_sitemap - Remove a sitemap
• get_feeds - Get all RSS/Atom feeds for a site

Keyword Analysis

• get_keyword_data - Get detailed data for specific keywords
• get_related_keywords - Find related search terms
• get_keyword_stats - Get historical statistics for a specific keyword

Link Analysis

• get_link_counts - Get inbound link statistics
• get_url_links - Get inbound links for specific site URL (requires link and page parameters)
• add_connected_page - Add a page that has a link to your website

Content Blocking

• get_blocked_urls - View blocked URLs
• add_blocked_url - Block URLs from crawling
• remove_blocked_url - Unblock URLs

Deep Link Management

• get_deep_link_blocks - Get list of blocked deep links
• add_deep_link_block - Block deep links for specific URL patterns
• remove_deep_link_block - Remove a deep link block

URL Parameters

• get_query_parameters - Get URL normalization parameters (may require special permissions)
• add_query_parameter - Add URL normalization parameter
• remove_query_parameter - Remove a URL normalization parameter

Geographic Settings

• get_country_region_settings - Get country/region targeting settings (may require special permissions)
• add_country_region_settings - Add country/region targeting settings
• remove_country_region_settings - Remove country/region targeting settings

Page Preview Management

• add_page_preview_block - Add a page preview block to prevent rich snippets
• get_active_page_preview_blocks - Get list of active page preview blocks
• remove_page_preview_block - Remove a page preview block

Site Migration

• get_site_moves - Get history of site moves/migrations
• submit_site_move - Submit a site move/migration notification

Children URL Management

• get_children_url_info - Get information about child URLs under a parent URL
• get_children_url_traffic_info - Get traffic information for child URLs

Usage Examples

Once configured, you can use these tools in Claude:

Basic Examples

"Show me all my verified sites in Bing Webmaster Tools"
"What are the top search queries for example.com?"
"Submit https://example.com/new-page for indexing"
"Show me crawl errors for my site"
"What's my daily URL submission quota?"

Advanced Examples

"Get detailed stats for the query 'best products' on my site"
"Submit this HTML content directly for https://example.com/page"
"Show me traffic info for my top 10 pages"
"Add [email protected] as an administrator for my site"
"Block all URLs matching /temp/* pattern"
"Get historical data for the keyword 'seo tools'"
"Configure crawl rate to slow for my site"
"Get keyword suggestions related to 'marketing'"

Development

Setup Development Environment

# Clone the repository
git clone https://github.com/isiahw1/mcp-server-bing-webmaster.git
cd mcp-server-bing-webmaster

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Install dependencies
uv sync

# Install in development mode
uv pip install -e .

Running the Server

# Set your API key
export BING_WEBMASTER_API_KEY=your_api_key_here

# Run the server
uv run python -m mcp_server_bwt

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.

Support

For issues, questions, or contributions, please visit: https://github.com/isiahw1/mcp-server-bing-webmaster