Brandwave/Docs

MCP Server#

The Brandwave MCP server connects Brandwave to AI assistants like Claude Desktop, Cursor, and Windsurf. Once connected, your assistant can help find activities, manage campaigns, track performance, and answer questions about your creator marketing data in natural language.

Server URL#

text
https://mcp.gobrandwave.com

Connecting your client#

Add the Brandwave MCP server to your client's configuration. Your client will ask you to sign in to Brandwave the first time you connect.

json
{
  "mcpServers": {
    "brandwave": {
      "url": "https://mcp.gobrandwave.com/mcp"
    }
  }
}

Sign in securely#

When you first connect, your client opens a browser window so you can sign in to Brandwave. After that, the client remembers the connection and keeps it refreshed.

Choosing a workspace

If you belong to multiple organizations, Brandwave uses your active organization by default. Tell your assistant which workspace to use when you want to work in a different one.

What your assistant can do#

Brandwave gives your client a few built-in helpers as soon as it connects. Most people will not run these directly; your AI assistant uses them to understand your Brandwave account and choose the right task.

text
1. Check Brandwave context
2. Find Brandwave tasks
3. Review task details
4. Run a Brandwave task
5. Check connection

Built-in assistant helpers#

These helpers are available as soon as your client connects. They let your assistant check the current Brandwave context, find available tasks, and run the task you ask for.

Check Brandwave context#

Shows which Brandwave user and workspaces are connected, so your assistant can answer questions in the right workspace.

Helper name: get-current-brandwave-context

Reads dataSafe to repeat

Find Brandwave tasks#

Finds the Brandwave tasks your assistant can help with. You can narrow the list by area or by search words.

Helper name: discover-brandwave-capabilities

Reads dataSafe to repeat

Review task details#

Shows what one Brandwave task does and what details it needs before it runs.

Helper name: describe-brandwave-action

Reads dataSafe to repeat

Run a Brandwave task#

Runs one Brandwave task and returns the result or a clear validation error.

Helper name: execute-brandwave-action

Check connection#

Checks that Brandwave is connected and reachable.

Helper name: ping

Reads dataSafe to repeat

Browse the task pages for example prompts and details your assistant may need.

Next steps#

AI assistant tasks

Browse Brandwave areas your assistant can help with.

TypeScript SDK

Use the SDK directly for programmatic access.