Vibe's MCP server lets you connect AI assistants like Claude to your Vibe account so you can ask questions and pull campaign data directly from your AI tool — without switching tabs.

Who is this for?

Self-serve advertisers who use an MCP-compatible AI assistant such as Claude, ChatGPT, Cursor, etc.

What you can do with Vibe MCP

View campaign performance (any reporting metric or dimension)
List active campaigns, strategies, advertisers, and creatives
Pull reporting data for specific date ranges, dimensions, and filters
Look up TV inventory, geographic regions, and platform business rules

What you can't do yet

Create or edit live campaigns
Upload creatives
Modify budgets or targeting on published campaigns

Before you start

You'll need:

You need a Vibe account with access to at least one advertiser.

Setup instructions

Claude Desktop

Open Claude Desktop → Settings → Developer → Edit Config
Add this to claude_desktop_config.json:

{
  "mcpServers": {
    "vibe": {
      "url": "https://api.vibe.co/mcp"
    }
  }
}

3. Restart Claude Desktop.

Claude Code

Run:

claude mcp add --transport http vibe https://api.vibe.co/mcp

2. Restart Claude Code and type /mcp to verify. On first use, you'll be sent to vibe.co to sign in.

Claude.ai (web)

Pro and Max plans: Settings → Connectors → Add custom connector → enter https://api.vibe.co/mcp. You'll be prompted to sign in to Vibe.
2. Team and Enterprise plans: An admin needs to add the connector at the org level first (Organization settings → Connectors → Add → Custom → Web → enter https://api.vibe.co/mcp). Once added, each user connects individually under Customize → Connectors.

What you can ask Claude

"Pull campaign performance for [advertiser] this week"
"What strategies are running on [campaign]? Show me the targeting details"
"Check the approval status of our latest creatives"
"Query impressions and spend for [campaign] in May"
"List all active campaigns for [advertiser]"

Claude uses Vibe automatically when your question calls for it. You can also prompt explicitly: "Using Vibe, show me…"

Current limits

Vibe MCP is read-first today. Claude can query, inspect, and prepare drafts, but cannot yet:

Create or edit live (published) campaigns
Upload creatives
Modify budgets or targeting on published campaigns

Draft campaign upserts are supported.

Available tools

Each tool is published with MCP tool annotations that describe its behavior to clients. All Vibe tools declare openWorldHint: false — they only interact with your Vibe account data, not external systems.

Tool name	Title	What it does	Annotations
`query_metrics`	Query Metrics	Query reporting metrics (spend, impressions, reach, etc.), grouped by dimensions like date, campaign, or state.	`readOnlyHint: true`
`list_advertisers`	List Advertisers	List advertisers in your tenant and find their IDs.	`readOnlyHint: true`
`list_campaigns`	List Campaigns	List campaigns with optional filters (delivery state, lifecycle status, goal, publication date).	`readOnlyHint: true`
`get_campaign_details`	Get Campaign Details	Get campaign metadata: name, status, dates, budget, and goal.	`readOnlyHint: true`
`list_strategies`	List Strategies	List strategies inside a campaign.	`readOnlyHint: true`
`get_strategy_details`	Get Strategy Details	Get detailed strategy info including targeting, bidding, and creatives.	`readOnlyHint: true`
`get_advertiser_details`	Get Advertiser Details	Get advertiser info: website, industry, apps, campaign count.	`readOnlyHint: true`
`list_creatives`	List Creatives	List video creatives with optional filters.	`readOnlyHint: true`
`get_creative_details`	Get Creative Details	Get creative approval status, duration, and active-campaign usage.	`readOnlyHint: true`
`search_regions`	Search Regions	Search geographic regions (states, cities, metros, counties, congressional districts) and return codes usable in filters and targeting.	`readOnlyHint: true`
`list_tv_inventory`	List TV Inventory	List TV inventory items (apps, channels, sports leagues) from the global catalog.	`readOnlyHint: true`
`get_business_rules`	Get Business Rules	Retrieve Vibe platform documentation and best-practice guides for a knowledge domain.	`readOnlyHint: true`
`upsert_campaign`	Upsert Draft Campaign	Create or update a draft campaign and its strategies. Cannot modify published or archived campaigns.	`readOnlyHint: false`, `destructiveHint: true`, `idempotentHint: false`

Per the MCP specification, these are hints — they describe expected behavior but are not enforced guarantees.

Troubleshooting

"Server not found" / "Connection failed"

Verify the URL is exactly https://api.vibe.co/mcp.
Confirm your client supports HTTP (Streamable HTTP) transport — Vibe MCP does not support stdio.

"401 Unauthorized" / "Invalid API key"

Confirm X-API-KEY is set and matches a key from Settings → Developer tools → API Keys.
Check the key hasn't been revoked.

"403 Forbidden" / "Tenant mismatch"

Confirm X-Vibe-Tenant matches the tenant that owns the API key.
For X-Vibe-Advertiser-Ids, use * or comma-separated advertiser IDs the key has access to.