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.
Add Toolspoke to Claude Code
Run it in your project, then /mcp to sign in
claude mcp add --transport http toolspoke https://toolspoke.com/mcpThe sign-in opens in your browser, and Toolspoke asks you to approve it.
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.
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.
Brave Search in your other apps
Try Brave Search in Claude Code
Free to start, and tool calls cost nothing on any plan.