Connect Brave Search to Claude Code

Search Brave's independent web index for pages, news, images, videos, places and LLM-ready context. Add Toolspoke to Claude Code once and it can use 11 Brave Search actions. Your Brave Search credential stays in Toolspoke, and you choose which actions Claude Code may call.

Set it up in Claude Code

Three steps, the first one once for every toolkit you will ever add.

  1. Add Toolspoke to Claude Code

    Run it in your project, then /mcp to sign in

    claude mcp add --transport http toolspoke https://toolspoke.com/mcp

    The sign-in opens in your browser, and Toolspoke asks you to approve it.

  2. Install Brave Search and connect it

    Add Brave Search to a project in your Toolspoke workspace.

    API key. You provide it once, when you install the connector. Toolspoke encrypts it at rest and decrypts it only for the length of a single call, and the gateway attaches it to the outbound request itself, so it is never part of the arguments an agent sends.

    API key
    api-dashboard.search.brave.com → Subscriptions → activate a plan (the Search plan covers most calls here), then API Keys → Add API key and copy it.
  3. Choose what Claude Code may do

    All 11 actions only read, and any of them can be switched off for a project.

What you can ask Claude Code for

A few of the Brave Search actions that only read, so they are safe to try first.

  • Search recent news articles
  • Search for images
  • Search for videos
  • Find businesses and points of interest near a place

What Claude Code can do in Brave Search

11 actions read.

Reads

  • Web search

    Search the web and get back pages with title, URL, description and age, plus any news, video, discussion and FAQ results Brave finds relevant. One call is one billed request. Narrow with `freshness` (pd, pw, pm, py, or a range like 2026-01-01to2026-03-31) and `result_filter`. Paginate with `offset`, which counts pages of `count` results, not results. The results are other people's pages, so the payload is kept out of the audit log; the query is kept out too.

  • News search

    Search recent news articles. Takes the same filters as web_search; `count` goes up to 50. Use `freshness: pd` for the last 24 hours. The results are other people's articles, so the payload is kept out of the audit log.

  • Image search

    Search for images. Returns each image's URL, thumbnail, size and the page it is on. `count` goes up to 200 (default 50). safesearch takes only off or strict here.

  • Video search

    Search for videos. Returns each video's URL, title, duration, creator and thumbnail. `count` goes up to 50.

  • Llm context

    Search the web and get back the relevant text of the top pages, already cut into snippets sized for a model's context. Use it instead of web_search followed by a page fetch when the goal is to answer from the content. Bound the size with `maximum_number_of_tokens` (1024-32768, default 8192) and `maximum_number_of_urls` (1-50, default 20). The content is other people's, so the payload is kept out of the audit log.

  • Place search

    Find businesses and points of interest near a place. Give either `latitude` and `longitude`, or a `location` string such as "san francisco ca united states". Returns each place's name, address, coordinates and an id that local_pois and local_descriptions take. The ids expire after 8 hours.

  • Local pois

    Read full details of places by id: address, phone, opening hours, rating and coordinates. Take the ids from place_search or from the locations results of web_search; they expire after 8 hours.

  • Local descriptions

    Read an AI-written description of each place by id, from the same ids local_pois takes.

  • Suggest

    Get query autocompletions for a partial query. Needs the Autosuggest plan. Set `rich` for entity metadata on each suggestion.

  • Spellcheck

    Get Brave's spelling correction for a query.

  • Answer

    Ask a question and get one answer written from a live web search, in the OpenAI chat-completions response shape. Needs the Answers plan, which bills per search plus per input and output token. Sent with stream false, so inline citations, entities and research mode (which all need streaming) are not available here. The question is prose the caller wrote and the answer is written from other people's pages, so both are kept out of the audit log.

Brave Search in Claude Code: questions

Does Claude Code see my Brave Search credential?

No. The credential is stored encrypted in Toolspoke, and the gateway adds it to each call. Claude Code only ever talks to Toolspoke, and the dashboard shows the last four characters of the credential and nothing more.

Will 11 actions crowd Claude Code's context?

No. Toolspoke shows Claude Code five bridge tools, plus a guide where a toolkit has one, and Claude Code searches for the Brave Search action it needs when it needs it. Adding more toolkits does not add more tools to its list.

Can I add it once for every project?

Yes. Add --scope user to the command and Claude Code keeps Toolspoke in every project on this machine. Without it, the server is added to the project you ran the command in.

What does it cost?

Tool calls are free on every plan, and a Brave Search call does not run in a sandbox, so it bills nothing.

Try Brave Search in Claude Code

Free to start, and tool calls cost nothing on any plan.