# Configure Brave Search

Connect the Brave web-search API. Installing the Brave browser is not required.

## Prepare a subscription token

Sign in to the [Brave Search API console](https://api-dashboard.search.brave.com/app/keys), activate the appropriate API plan, and create a key under **API keys**. Use the Search API **Subscription Token**, not a browser-account password.

You need permission to create or edit tool configuration in the current MOI workspace. If the entry is missing or access is denied, contact the workspace administrator rather than using another person's account.

## Configure MOI

1. Open **Resource Center → Tools → Brave Search** and select **Configure API Key**.
2. Paste the raw token into the required **Subscription Token** field and save.
3. Test the connection. You do not need to configure the `X-Subscription-Token` header manually.

## Validate agent use

After saving, reopen the configuration to confirm it persists and run **Test connection**. Then [bind the capability to the target agent](../bind-tools.md), selecting the intended connection wherever an instance selector is provided. Inspect an actual tool call and compare its result with the target platform. A configured badge or a plausible answer alone is insufficient.

Ask for a public document with source links and confirm in the call record that Brave search executed.

## Troubleshoot

| Symptom | Check |
| --- | --- |
| No usable key | The activated plan is for Search API rather than another Brave product |
| 401 or 403 | Token validity and API-account status |
| 429 or quota error | Provider limits and usage; retry according to those limits |

- [Brave Search API authentication](https://api-dashboard.search.brave.com/documentation/guides/authentication)
- [All tool configuration guides](index.md)