Brave Search

Performs web searches using the Brave Search API and returns comprehensive search results with rich metadata.

When to use:

• General web searches for information, facts, or current topics
• Location-based queries (restaurants, businesses, points of interest)
• News searches for recent events or breaking stories
• Finding videos, discussions, or FAQ content

Returns a JSON list of web results with title, description, and URL. When result_filter is empty, results may also contain FAQ, Discussions, News, and Video items.

Inputs:

- `query` (string, required) — Search query (max 400 chars, 50 words)
- `country` (CountryCode, optional, default: "US") — Country for results
- `search_lang` (SearchLang, optional, default: "en") — Search language
- `ui_lang` (UiLang, optional, default: "en-US") — UI language
- `count` (int, optional, default: 10) — Number of web results (1–20)
- `offset` (int, optional, default: 0) — Pagination offset (0–9)
- `safesearch` (SafeSearch, optional, default: "moderate") — Safe-search level
- `freshness` (string, optional) — Time filter: pd (day) pw (week) pm (month) py (year) or YYYY-MM-DDtoYYYY-MM-DD

output data schema:

{
  results: {
    summarizer_key: string | null;
    url: string | null;
    title: string | null;
    description: string | null;
    extra_snippets: string[] | null;
    question: string | null;
    answer: string | null

Searches for local businesses and places via the Brave Search API. Returns ratings, addresses, phone numbers, hours, and AI descriptions.

Access to enriched POI data requires a Brave Search API Pro plan; the tool gracefully falls back to web results if local data is unavailable.

Inputs:

- `query` (string, required) — Local search query, e.g. 'pizza near downtown Chicago'
- `count` (int, optional, default: 5) — Results to return (1–20)
- `country` (CountryCode, optional, default: "US") — Country code

output data schema:

Searches for videos via the Brave Search API. Returns titles, URLs, durations, view counts, creators, and thumbnails.

Inputs:

- `query` (string, required) — Video search query (max 400 chars, 50 words)
- `country` (CountryCode, optional, default: "US") — Country for results
- `search_lang` (SearchLang, optional, default: "en") — Search language
- `ui_lang` (UiLang, optional, default: "en-US") — UI language
- `count` (int, optional, default: 10) — Results to return (1–20)
- `offset` (int, optional, default: 0) — Pagination offset (0–9)
- `safesearch` (SafeSearch, optional, default: 

Searches for images via the Brave Search API. Returns direct image URLs, source pages, and dimensions. Images are returned as URLs — no base64 encoding.

Inputs:

- `query` (string, required) — Image search query (max 400 chars, 50 words)
- `country` (CountryCode, optional, default: "US") — Country for results
- `search_lang` (SearchLang, optional, default: "en") — Search language
- `count` (int, optional, default: 10) — Results to return (1–20)
- `safesearch` (SafeSearch, optional, default: "moderate") — Safe-search level
- `spellcheck` (bool, optional, default: true) — Spellcheck the query

Searches for current news articles via the Brave Search API. Returns headlines, sources, publication age, and descriptions.

Inputs:

- `query` (string, required) — News search query (max 400 chars, 50 words)
- `country` (CountryCode, optional, default: "US") — Country for results
- `search_lang` (SearchLang, optional, default: "en") — Search language
- `ui_lang` (UiLang, optional, default: "en-US") — UI language
- `count` (int, optional, default: 10) — Results to return (1–20)
- `offset` (int, optional, default: 0) — Pagination offset (0–9)
- `safesearch` (SafeSearch, optional, default: 

Retrieves points of interest (POIs) with structured business data via Brave's dedicated place-search endpoint. Returns addresses, hours, ratings, categories, and contact info.

Geographic context is required — provide latitude/longitude or a location string (e.g. 'san francisco ca united states').

Access requires a Brave Search API Pro plan.

Inputs:

- `query` (string, required) — Search query — shapes result type, e.g. 'coffee shops' or 'Eiffel Tower'
- `location` (string, optional) — Location context, e.g. 'san francisco ca united states' or 'tokyo japan'
- `latitude` (float, optional) — Latitude (-90 to 90)
- `longitude` (float, optional) — Longitude (-180 to 180)
- `radius` (int, optional) — Proximity bias in metres (not a hard cutoff)
- `count` (int, optional, default: 20) — Results to return (1–50)
- `country` (CountryCode, optional, default: 

Retrieves an AI-generated summary of web search results using Brave's Summarizer API.

Workflow: call search_web with summary=true first, then pass the returned summarizer_key to this tool.

Requires a Brave Search API Pro AI subscription.

Inputs:

- `key` (string, required) — Summarizer key from search_web called with summary=true
- `entity_info` (bool, optional, default: false) — Include related entity information

output data schema:

{
  text: string;
}

Retrieves pre-extracted, relevance-ranked web content using Brave's LLM Context API, optimised for AI agents, LLM grounding, and RAG pipelines.

Unlike a web search (links + short descriptions), this tool returns the actual substance of matching pages — text chunks, tables, code blocks — so the model can reason over it directly.

When to use:

• Grounding answers in fresh, relevant web content (RAG)
• Question answering and fact-checking against current sources
• Gathering source material without manually fetching pages

When relaying results in markdown environments, cite source URLs from the 'sources' map.

Inputs:

- `query` (string, required) — Search query (max 400 chars, 50 words)
- `country` (CountryCode, optional, default: "US") — Country for results
- `search_lang` (SearchLang, optional, default: "en") — Search language
- `count` (int, optional, default: 20) — Number of results to consider (1–50

Every tool returns the same top-level envelope. Only data varies per tool.

// Success
{
  "success": true,
  "statusCode": 200,
  "retriable": false,
  "retry_after_seconds": null,
  "error": null,
  "data": { ... }
}
 
// Error

These appear, with the same meaning, across most of the search tools:

• country (CountryCode) — "Country for results" (search_local and search_places phrase this as "Country code")
• search_lang (SearchLang) — Search language
• ui_lang (UiLang) — UI language
• safesearch (SafeSearch: off | moderate | strict) — Safe-search level
• spellcheck (bool) — Spellcheck the query
• (string) — Time filter: (day) / (week) / (month) / (year), or a custom range

1. Go to the Brave Search API dashboard
2. Sign up or log in, then subscribe to a plan (a free tier is available)
3. Open the API Keys section of the dashboard and create a new key (or use the one generated for you on signup)
4. Copy the generated key — you will only see it once

• Cause: API key not provided in request headers or incorrect format
• Solution:
  1. Verify Authorization: Bearer YOUR_API_KEY and X-Mewcp-Credential-Id: CREDENTIAL-ID headers are present
  2. Check API key is active in your MewCP account

• Cause: API calls have exceeded your request limits
• Solution:
  1. Check credit usage in your Curious Layer dashboard
  2. Upgrade to a paid plan or add credits for higher limits
  3. Contact support for credit adjustments

• Cause: No Brave Search credential linked to your account
• Solution:
  1. Go to Credentials in your MewCP dashboard
  2. Connect your Brave Search account (OAuth) or add your API key (static)
  3. Retry the request with the correct X-Mewcp-Credential-Id header

• Cause: JSON payload is invalid or missing required fields
• Solution:
  1. Validate JSON syntax before sending
  2. Ensure all required tool parameters are included
  3. Check parameter types match expected values

• Cause: Incorrect server name in the API endpoint
• Solution:
  1. Verify endpoint format: mewcp-brave-search/mcp/{tool-name}
  2. Use correct server name from documentation
  3. Check available servers in your Curious Layer account

• Cause: Upstream Brave Search API returned an error
• Solution:
  1. Check the Brave Search API's status page for ongoing incidents
  2. Verify your credential has the required permissions (some tools require a Pro plan)
  3. Review the error message for specific details

• Brave Search API Documentation — Official API reference
• FastMCP Docs — FastMCP specification
• FastMCP Credentials — FastMCP Credentials package for credential handling