<div align="center">

🅱️ bing-seo-mcp

The full Bing Webmaster Tools API for AI agents — over one MCP server.

Sites & verification · URL submission · Sitemaps · Traffic & crawl stats · Keyword research · URL blocking

</div>

---

A Model Context Protocol server that lets Claude (and any MCP client) drive Bing Webmaster Tools end to end — manage and verify sites, push URLs for indexing, submit sitemaps, pull traffic / query / crawl stats, research keywords, and block URLs. Auth is a single API key — paste it once and you're running.

✨ Highlights

• 🌐 Sites & verification — list, add, verify, inspect roles
• 📤 URL submission — single, batch, full-content, with live quota
• 🗺️ Sitemaps — list and submit feeds
• 📈 Stats — rank & traffic, queries, pages, crawl stats & issues
• 🔑 Keyword research — keyword and related-keyword data
• 🚫 URL blocking — block pages/directories and deep links
• 🔐 One-key auth — validated on save, stored locally
• 🛡️ Safety rails — read-only mode and per-call confirm guards

📦 Installation

Run straight from npm with npx (no install needed), or build from source:

# from source
git clone https://github.com/skiddgoddamn/bing-seo-mcp
cd bing-seo-mcp
npm install && npm run build

🔌 Connect to your MCP client

Add to your MCP config (e.g. ~/.claude.json or claude_desktop_config.json):

{
  "mcpServers": {
    "bing-seo": {
      "command": "npx",
      "args": ["-y", "bing-seo-mcp"],
      "env": { "BING_API_KEY": "" }
    }
  }
}

<details> <summary>Or point at a local build</summary>

{
  "mcpServers": {
    "bing-seo": {
      "command": "node",
      "args": ["F:/projects/bing-seo-mcp/build/index.js"]
    }
  }
}

</details>

🔑 Get your API key

1. Sign in at Bing Webmaster Tools
2. Go to Settings → API access → API Key
3. Copy the key — set it via the b_set_apikey tool or the BING_API_KEY env var

🚀 Setup flow

Step	Tool	What happens
1	b_set_apikey	Save your key — validated against the live API before it's stored
2	bing_sites_get	List your verified sites
✓	b_auth_status	Check whether the key is configured and valid

⚙️ Environment variables

Variable	Default	Description
BING_API_KEY	—	Fallback API key (a saved key takes precedence)
BING_MCP_CONFIG_DIR	~/.bing-seo-mcp	Override the config directory
B_READONLY	false	Block every mutating tool (_add _submit _remove _block _verify)
B_CONFIRM	false	Require a confirm=true argument on mutating calls
B_LOG_LEVEL	INFO	DEBUG · INFO · WARNING · ERROR
B_LOG_BODIES	false	Log request/response bodies to stderr (verbose)
B_LOG_FILE	—	Append log lines to a file (default: stderr only)

See .env.example for a ready-to-copy template.

🧰 Tool reference

🔐 Auth

Tool	Description
b_auth_status	Show whether an API key is configured and valid
b_set_apikey	Save and validate the Bing Webmaster API key

🌐 Site management

Tool	Description
bing_sites_get	List all sites for the authenticated user
bing_site_add	Add a site to the account
bing_site_verify	Trigger ownership verification for a site
bing_site_roles	Get roles/owners of a site

📤 URL submission

Tool	Description
bing_submit_url	Submit a single URL for indexing
bing_submit_url_batch	Submit multiple URLs in one batch
bing_submit_content	Submit a URL with its full HTTP content
bing_url_quota	Daily/monthly URL submission quota

🗺️ Sitemaps

Tool	Description
bing_sitemaps_get	List submitted sitemaps/feeds for a site
bing_sitemap_submit	Submit a sitemap/feed URL

📈 Stats & analytics

Tool	Description
bing_rank_traffic_stats	Rank and traffic stats for a site
bing_query_stats	Search query stats for a site
bing_page_stats	Per-page traffic stats
bing_page_query_stats	Query stats for a specific page
bing_crawl_stats	Crawl stats for a site
bing_crawl_issues	Crawl issues/errors for a site

🔑 Keywords

Tool	Description
bing_keyword_get	Impression data for an exact keyword
bing_related_keywords	Related keywords for a query

🚫 URL blocking

Tool	Description
bing_blocked_urls_get	List blocked URLs for a site
bing_block_url_add	Block a URL or directory from Bing search
bing_block_url_remove	Remove a URL block
bing_deep_link_block	Add a deep link block

🛡️ Safety rails

• B_READONLY=true — blocks every tool whose name contains _add _submit _remove _block _verify. Reads still work.
• B_CONFIRM=true — mutating tools return a preview and require a follow-up call with confirm: true.

📄 License

MIT © skiddgoddamn