Bing Search MCP Server

Instructions

Input Schema

Input Schema (JSON Schema)

Implementation Reference

• mcp_server_bing/server.py:162-236 (handler)

  The primary handler for the 'bing_news_search' tool. Decorated with @server.tool() for registration in FastMCP. Implements the core logic: API key check, rate limiting, HTTP request to Bing News Search endpoint, parses JSON response, formats results with title, URL, description, date, and provider.
  @server.tool() async def bing_news_search( query: str, count: int = 10, market: str = "en-US", freshness: str = "Day" ) -> str: """Searches for news articles using Bing News Search API for current events and timely information. Args: query: News search query (required) count: Number of results (1-50, default 10) market: Market code like en-US, en-GB, etc. freshness: Time period of news (Day, Week, Month) """ # Get API key from environment api_key = os.environ.get("BING_API_KEY", "") if not api_key: return ( "Error: Bing API key is not configured. Please set the " "BING_API_KEY environment variable." ) try: check_rate_limit() # News search has a different endpoint news_url = f"{BING_API_URL}v7.0/news/search" headers = { "User-Agent": USER_AGENT, "Ocp-Apim-Subscription-Key": api_key, "Accept": "application/json", } params = { "q": query, "count": min(count, 50), "mkt": market, "freshness": freshness, } async with httpx.AsyncClient() as client: response = await client.get( news_url, headers=headers, params=params, timeout=10.0 ) response.raise_for_status() data = response.json() if "value" not in data: return "No news results found." results = [] for result in data["value"]: published_date = result.get("datePublished", "Unknown date") provider_info = result.get("provider", [{"name": "Unknown"}]) # Handle potential empty provider list provider_name = ( provider_info[0]["name"] if provider_info else "Unknown" ) results.append( f"Title: {result['name']}\n" f"URL: {result['url']}\n" f"Description: {result['description']}\n" f"Published: {published_date}\n" f"Provider: {provider_name}" ) return "\n\n".join(results) except httpx.HTTPError as e: return f"Error communicating with Bing API: {str(e)}" except Exception as e: return f"Unexpected error: {str(e)}"
• mcp_server_bing/server.py:163-174 (schema)

  Input schema and documentation for bing_news_search tool, defining parameters query (str required), count (int default 10, 1-50), market (str default en-US), freshness (str default Day), returning formatted string of news results.
  async def bing_news_search( query: str, count: int = 10, market: str = "en-US", freshness: str = "Day" ) -> str: """Searches for news articles using Bing News Search API for current events and timely information. Args: query: News search query (required) count: Number of results (1-50, default 10) market: Market code like en-US, en-GB, etc. freshness: Time period of news (Day, Week, Month) """
• mcp_server_bing/server.py:77-92 (helper)

  Shared helper function check_rate_limit() used by bing_news_search (and other tools) to enforce rate limits (1/sec, 15k/month). Called before API requests.
  def check_rate_limit(): """Check if we're within rate limits""" now = time.time() if now - request_count["last_reset"] > 1: request_count["second"] = 0 request_count["last_reset"] = now if ( request_count["second"] >= RATE_LIMIT["per_second"] or request_count["month"] >= RATE_LIMIT["per_month"] ): raise Exception("Rate limit exceeded") request_count["second"] += 1 request_count["month"] += 1
• mcp_server_bing/server.py:162-162 (registration)

  The @server.tool() decorator registers the bing_news_search function as an MCP tool in the FastMCP server.
  @server.tool()