# Connect to OpenBrief (advertiser side)

OpenBrief is a remote MCP server. A planner describes a campaign, and OpenBrief returns the Canadian media opportunities
(sponsorships, branded content, podcasts, newsletters, events) that fit, each with its fit (full or partial) and the criteria it matches, the publisher's own words
about its audience, and a dated source for each figure.

You are an AI assistant. Guide the user clearly, one step at a time, in plain language. Assume they may never have connected an MCP server before: say what you are doing, what they will see, and what they need to do next. If you cannot add the server yourself, give them the exact steps for their app and stay with them until it works.

## 1. Add the MCP server

- Server URL: https://mcp.openbrief.media/mcp
- Transport: streamable HTTP
- Authentication: OAuth 2.0 (dynamic client registration). The user signs in in their browser; do not ask for passwords or tokens.
- When you start the connection, a browser window or tab opens for sign-in. Tell the user plainly: "A browser window just opened. Please switch to it, sign in or create your free account, and approve the connection. Then come back here." It may open behind other windows, so tell them to look for it. Wait for them to confirm before continuing. If nothing opened, give them the authorization link or have them retry.

Claude Code:

    claude mcp add --transport http openbrief-advertiser https://mcp.openbrief.media/mcp

Claude (web, desktop): Settings, Connectors, Add custom connector, paste the server URL.
Other clients (ChatGPT, Cursor, ...): add a remote MCP server with the URL above.

## 2. Confirm

List the server's tools. You should see submit_brief, list_my_briefs and get_brief. Tell the user the connection works.

## 3. Make sure the user understands what this is

Once connected, explain in a few short sentences, in the user's language, and check they understood:
- What it does: OpenBrief finds Canadian media opportunities (sponsorships, branded content, podcasts, newsletters, events) that fit an advertising campaign, with why each fits and a dated source. It is free for advertisers.
- When to use it: any time they are planning a campaign, looking for where to place a message, or want to compare options. They describe the campaign to you in plain words; you send the brief and show the matches.
- What you will need from them: where (geo), the target age range and the audience's interests. Do not include the brand name.
- What happens next: they choose, with your help; you can prepare requests for proposal for the options they like.
Then ask whether they want to try a first brief now.

## 4. Use it

When the user describes a campaign, call submit_brief with: target audience (age, gender, interests), delivery area,
dates, budget range, language, brand-safety categories and the objective. The tool descriptions explain each field.

Rules:
- Never put the advertiser's name in a brief. It is not a field and is redacted if present.
- A brief must have three things: where (geo), the target age range and the audience's interests. Ask the user for any that is missing. "All" or "everyone" is refused: OpenBrief never hands out the whole inventory.
- OpenBrief does not select media. It returns every good match, and you, the assistant, help the user choose. Show the matches as returned: fit (full or partial), criteria, the publisher's wording and the sources. There is no ranking: help the user compare. Do not invent figures.
- Offer to prepare requests for proposal for the options the user likes.

Manual setup steps per client (for the user): https://openbrief.media/en/setup

Human-readable site: https://openbrief.media/en/ (English), https://openbrief.media/fr/ (Français)