mikechao/brave-search-mcp

Brave Search MCP Server

An MCP Server implementation that integrates the Brave Search API, providing, Web Search, Local Points of Interest Search, Video Search, Image Search, News Search and LLM Context Search capabilities

Features

• Web Search: Perform a regular search on the web
• Image Search: Search the web for images.
• News Search: Search the web for news
• Video Search: Search the web for videos
• Local Points of Interest Search: Search for local physical locations, businesses, restaurants, services, etc
• LLM Context Search: Fetch and extract full web page content optimized for reading and synthesizing sources

Tools

• brave_web_search

  • Execute web searches using Brave's API
  • Inputs:
    • query (string): The term to search the internet for
    • count (number, optional): The number of results to return (max 20, default 10)
    • offset (number, optional, default 0): The offset for pagination
    • freshness (enum, optional): Filters search results by when they were discovered
      • The following values are supported
        • pd: Discovered within the last 24 hours.
        • pw: Discovered within the last 7 Days.
        • pm: Discovered within the last 31 Days.
        • py: Discovered within the last 365 Days
        • YYYY-MM-DDtoYYYY-MM-DD: Custom date range (e.g., 2022-04-01to2022-07-30)

• brave_image_search

  • Get images from the web relevant to the query
  • Inputs:
    • query (string): The term to search the internet for images of
    • count (number, optional): The number of images to return (max 50, default 10)

• brave_news_search

  • Searches the web for news
  • Inputs:
    • query (string): The term to search the internet for news articles, trending topics, or recent events
    • count (number, optional): The number of results to return (max 20, default 10)
    • offset (number, optional, default 0): The zero-based offset for pagination (max 9)
    • freshness (enum, optional): Filters search results by when they were discovered
      • The following values are supported
        • pd: Discovered within the last 24 hours.
        • pw: Discovered within the last 7 Days.
        • pm: Discovered within the last 31 Days.
        • py: Discovered within the last 365 Days
        • YYYY-MM-DDtoYYYY-MM-DD: Custom date range (e.g., 2022-04-01to2022-07-30)

• brave_local_search

  • Search for local businesses, services and points of interest
  • Falls back to brave_web_search on the initial page if no location results are found
  • Inputs:
    • query (string): Local search term
    • count (number, optional): The number of results to return (max 20, default 5)
    • offset (number, optional, default 0): The zero-based offset for pagination (max 9)

• brave_video_search

  • Search the web for videos
  • Inputs:
    • query: (string): The term to search for videos
    • count: (number, optional): The number of videos to return (max 20, default 10)
    • offset (number, optional, default 0): The zero-based offset for pagination (max 9)
    • freshness (enum, optional): Filters search results by when they were discovered
      • The following values are supported
        • pd: Discovered within the last 24 hours.
        • pw: Discovered within the last 7 Days.
        • pm: Discovered within the last 31 Days.
        • py: Discovered within the last 365 Days
        • YYYY-MM-DDtoYYYY-MM-DD: Custom date range (e.g., 2022-04-01to2022-07-30)

• brave_llm_context_search

  • Pre-extracted web content optimized for AI agents, LLM grounding, and RAG pipelines.
  • Uses Brave's balanced context threshold mode in compact mode and disables Brave relevance filtering in full mode.
  • Inputs:
    • query (string): The search query. Maximum 400 characters and 50 words.
    • url (string, optional): Optional URL to target. When provided, query and URL are combined for retrieval and only snippets from this exact URL are returned.
    • count (number, optional, default 8): The maximum number of search results considered. Minimum 1, maximum 50.
    • maximumNumberOfUrls (number, optional, default 8): The maximum number of URLs to include in the response. Minimum 1, maximum 50.
    • maximumNumberOfTokens (number, optional, default 2048): The approximate maximum number of tokens in the returned context. Minimum 1024, maximum 32768.
    • maximumNumberOfSnippets (number, optional, default 16): The maximum number of snippets across all URLs. Minimum 1, maximum 100.
    • maximumNumberOfTokensPerUrl (number, optional, default 512): The maximum number of tokens per URL. Minimum 512, maximum 8192.
    • maximumNumberOfSnippetsPerUrl (number, optional, default 2): The maximum number of snippets per URL. Minimum 1, maximum 100.
    • responseMode (enum, optional, default compact): compact applies Brave's balanced relevance filtering plus local snippet filtering/truncation. full disables Brave's relevance filtering and returns raw snippets without local filtering or truncation.
    • maxSnippetChars (number, optional, default 400): Maximum characters per snippet in compact mode. Minimum 80, maximum 4000.
    • maxOutputChars (number, optional, default 8000): Approximate maximum serialized response size in compact mode. Minimum 1000, maximum 100000.