The Broadstreet MCP lets AI apps like Claude, ChatGPT, Cursor and VS Code work directly with your Broadstreet inventory: networks, advertisers, campaigns, ads, zones and placements. You manage connections from Account → Connected Apps (the MCP page) in Broadstreet.
MCP (Model Context Protocol) is an open standard for connecting AI assistants to outside tools. Once connected, you can ask your AI app questions about your inventory or, with permission, have it make changes for you in plain language.
- Server URL:
https://my.broadstreetads.com/mcp - Works with: any app that supports MCP connectors
- Connection length: 30 days, then reconnect
What you can do
Every connected app can look up and report on inventory; apps with change access can also build and edit it.
| Area | Read (every app) | Change (with permission) |
|---|---|---|
| Networks | List networks you administer, search across inventory | — |
| Advertisers | List and view advertisers, pull advertiser stats, see advertiser admins | Create, update or clone advertisers; invite, update or remove advertiser admins |
| Campaigns | List and view campaigns, pull campaign stats | Create, update or clone campaigns (new campaigns start paused) |
| Advertisements | List and view ads and stencils, pull ad stats | Create image, HTML or stencil ads; update or clone ads |
| Zones | List and view zones, pull zone stats | Create or update zones |
| Placements | List which ads run in which zones | Add or remove placements |
| Reporting | Compare performance across ads, campaigns or zones | — |
| Targeting | Search geotargets | Apply geotargets through campaign or ad updates |
Most change actions support a preview (dry run) so you can see what will happen before anything is saved. Ad images must be public https URLs; files attached in a chat can’t be uploaded directly.
How to connect
Copy the server URL from the MCP page, add it to your AI app, then sign in to Broadstreet and approve access to the networks you administer.
Claude (claude.ai and desktop)
- Open Customize, then Connectors, and choose Add custom connector.
- Name it Broadstreet, paste the URL and select Connect.
- On Team and Enterprise plans, an Owner adds it first under Organization settings → Connectors.
Claude Code
claude mcp add --transport http broadstreet https://my.broadstreetads.com/mcpThen run /mcp to sign in.
ChatGPT
- In Settings, open Security and login and turn on Developer mode.
- Go to chatgpt.com/plugins and select the + button.
- Name it Broadstreet, paste the URL under Connection and create it.
- If you reconnect later to allow changes, select Refresh on the Broadstreet app so ChatGPT picks up the new tools.
Cursor
- Open Cursor Settings → MCP and add a new MCP server with the URL, or add it to
~/.cursor/mcp.json:
{
"mcpServers": {
"broadstreet": {
"url": "https://my.broadstreetads.com/mcp"
}
}
}- Select Connect next to broadstreet and sign in.
VS Code
- Run MCP: Add Server… from the Command Palette.
- Choose HTTP, paste the URL and name it broadstreet.
- Start the server when VS Code asks, then sign in.
Managing connections: connected apps appear under Your connected apps with their redirect host, connection date, last use and expiry. Select Disconnect to revoke access at any time.
Permissions and access levels
Apps get read-only access by default; change access is opt-in for each connection.
| Access level | What the app can do | How to get it |
|---|---|---|
| Read | View inventory and stats in the networks you administer | Default for every connection |
| Can change inventory | Also create and change inventory | Tick “Also let this app create and change inventory” on the approval screen |
- The change option only appears when changes through AI apps are turned on for your account.
- To upgrade an app you already connected, connect it again and tick the box.
- Apps with change access show a Can change inventory label in your connected apps list.
- Only approve a sign-in request you just started yourself.
Example prompts to try
Reporting (read access)
- “Which of my campaigns had the highest CTR last month?”
- “Compare impressions and clicks for my top five zones over the last 30 days.”
- “List every advertiser with a campaign ending this week.”
- “Which ads are placed in the homepage leaderboard zone right now?”
Building and editing (change access)
- “Create a new advertiser called Main Street Bakery with a campaign running November 1–30.”
- “Add an image ad to that campaign using this image URL and place it in the sidebar zone.”
- “Clone last year’s holiday campaign and update the dates for this year.”
- “Preview what would change if you paused every ad for Acme Co.”
FAQ and tips
How long does a connection last? 30 days. After that, connect again from your AI app. You can see each app’s expiry date on the MCP page.
Can I disconnect an app? Yes. Select Disconnect next to the app under Your connected apps. It loses access right away.
Which networks can the app see? Only the networks you administer and approve during sign-in.
My app can’t make changes. Why? It was likely connected read-only. Connect it again and tick “Also let this app create and change inventory.” In ChatGPT, select Refresh on the Broadstreet app afterward. If the option doesn’t appear, changes through AI apps aren’t turned on for your account yet.
Will a new campaign go live immediately? No. Campaigns created through the MCP start paused, so you can review them before launch.
Can I upload an image from my computer? Not directly. Host the image at a public https URL and give the app that link.
Tips
- Ask for a dry run before bulk changes.
- Name the network in your prompt if you administer more than one.
- Review the connected apps list periodically and disconnect anything you no longer use.