The Vibe MCP connector routes your AI agent's tool calls to Vibe's own MCP server through Scalekit. Each user signs in to Vibe once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 24 tools.
- Tools
- 24
- What they doRead · write · destructive
- 20 · 0 · 420 read0 write4 destructive
- Users sign in with
- OAuth
- OAuth app
- Your own Vibe MCP server app
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Vibe MCP connection
In AgentKit > Connections, create a Vibe MCP connection and copy its redirect URI. The name you give it is the
connection_nameyour code passes. See Configure connections.Register an OAuth app
Vibe MCP server connections use your own OAuth app. Register one with Vibe MCP server and add the redirect URI you copied.
Then enter the app's Client ID and Client Secret on the Vibe MCP connection.
Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'vibemcp'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Vibe MCP:', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'vibemcp_list_advertisers',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "vibemcp"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Vibe MCP:", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="vibemcp_list_advertisers",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user signs in once. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolvibemcp_get_activity_logReturns the change history (who changed what, and when) for the given records.Read-onlyGet Activity Log
Returns the change history (who changed what, and when) for the given records. You only have access to change history from 2026-05-21 onward.
Inputs
modelsarrayrequired- The entity types whose change history to fetch. By default the change history of each selected model's nested sub-records are included too; see `includeNestedRecords`.
actionsstring- Narrow to only creations and/or deletions of records (e.g. creatives added to or removed from a campaign). Omit to include all changes, including field updates.
fromstring- Filter changes on or after this date (inclusive), format "YYYY-MM-DD".
includeNestedRecordsboolean- Whether to also include changes to records nested under the selected models (e.g. CAMPAIGN also returns changes to its strategies, their creatives and targeting audiences, and its experiments). Keep the default (true): most edits to an entity are actually made on its nested records, so leaving them out will miss real changes. Only set false when the user explicitly wants changes to the named entity itself, excluding its children.default
true limitstring- Max number of changes to return, most recent first.default
25 scopesstring- Restrict results to records tied to these entities. Selected models unrelated to every listed entity are excluded. Omit to return history for ALL records of the selected models.
sourcesstring- Filter by one or more sources that made the change: APP (a user in the Vibe web app), AGENT (the in-app Vibe AI agent), PUBLIC_API (an external caller via the public API), MCP (an external AI agent or automation via the MCP), SYSTEM (an automated Vibe action with no human involved).
tostring- Filter changes on or before this date (inclusive), format "YYYY-MM-DD".
vibemcp_get_advertiser_detailsGet detailed advertiser information including website URL, industry, apps, and campaign count.Read-onlyGet Advertiser
Get detailed advertiser information including website URL, industry, apps, and campaign count. Use this when the user asks about a specific advertiser beyond just its name. Returns an error if the advertiser ID does not exist or the caller lacks access.
Inputs
advertiserIdstringrequired- The advertiser ID to look up
vibemcp_get_business_rulesLoad platform documentation for a knowledge domain.Read-onlyGet Business Rules
Load platform documentation for a knowledge domain. Call when Vibe-specific rules or best practices apply to what you are about to do or explain.
Inputs
domainstringrequired- The knowledge domain to retrieve:
Use `getting_started` for Platform basics, account setup, and FAQ.
Use `campaign_setup` for Campaign configuration, goals, targeting, creatives, and prerequisites.
Use `pixel_tracking_reporting` for Pixel setup, conversion tracking, and reporting.
Use `integrations` for Shopify, Google Analytics, Klaviyo, HubSpot, and other platform integrations.
Use `billing_support` for Billing, payments, account management, and support topics.
Use `campaign_optimization_playbook` for Optimization strategies, budget allocation, pacing, and performance best practices.
Use `awareness_playbook` for Brand awareness, reach, frequency, and ad recall best practices.one of
getting_startedcampaign_setuppixel_tracking_reportingintegrationsbilling_supportcampaign_optimization_playbookawareness_playbook
vibemcp_get_campaign_detailsGet campaign metadata including name, status, start/end dates, budget, and goal.Read-onlyGet Campaign
Get campaign metadata including name, status, start/end dates, budget, and goal. Use this when the user asks about a specific campaign. Returns an error if the campaign ID does not exist or the caller lacks access. Includes the link to the campaign summary page on the Vibe dashboard, where the user can modify or publish a campaign.
Inputs
campaignIdstringrequired- The campaign ID to look up
vibemcp_get_creative_detailsGet detailed creative information including approval status, duration, and whether it is used in an active campaign.Read-onlyGet Creative
Get detailed creative information including approval status, duration, and whether it is used in an active campaign. Use this when the user asks about a specific creative. Returns an error if the creative ID does not exist or the caller lacks access.
Inputs
creativeIdstringrequired- The video creative ID to look up
vibemcp_get_strategy_detailsGet detailed strategy information including targeting, bidding, and creatives.Read-onlyGet Strategy
Get detailed strategy information including targeting, bidding, and creatives. Use this when the user asks about a specific strategy's configuration or targeting setup. Returns an error if the strategy ID does not exist or the caller lacks access.
Inputs
strategyIdstringrequired- The strategy ID to look up
vibemcp_list_advertisersList advertisers for the current tenant.Read-onlyList Advertisers
List advertisers for the current tenant. Use this to find advertiser names and IDs when the user asks about a specific advertiser or when you need to disambiguate.
Inputs
searchstring- Search by advertiser name. Space-separated keywords return results that match any of them (better for broad searches). Keywords inside double quotes match the exact phrase (better for exact searches). Prefer a single call with multiple keywords over multiple separate tool calls.
vibemcp_list_campaignsList campaigns for the current tenant with optional filters, the most recently updated first.Read-onlyList Campaigns
List campaigns for the current tenant with optional filters, the most recently updated first. Each campaign includes a displayStatus showing its current state as seen in the dashboard (e.g., Delivering, Paused, Upcoming, Completed, Draft, Archived, Blocked). Use the state filter for delivery states (DELIVERING, PAUSED, UPCOMING, COMPLETED, etc.). Use campaignStatus for lifecycle stages (DRAFT, PUBLISHED, ARCHIVED). Pass goal when the user mentions or implies a campaign objective (e.g., "lead campaign" → LEADS, "awareness campaign" → AWARENESS). Use publishedAfter/publishedBefore for publication date ranges.
Inputs
advertiserIdstring- Filter by advertiser ID
campaignStatusstring- Filter by lifecycle status (DRAFT, PUBLISHED, ARCHIVED). Use DRAFT when user asks about draft campaigns. Most other user queries should use the state filter instead.
goalstring- Filter by campaign goal (e.g. AWARENESS, TRAFFIC, RETARGETING).
limitstring- Max results to return.default
50 publishedAfterstring- Filter campaigns published on or after this date in format "YYYY-MM-DD" (e.g. "2025-03-01").
publishedBeforestring- Filter campaigns published on or before this date in format "YYYY-MM-DD" (e.g. "2025-03-31").
searchstring- Search by campaign or advertiser name. Space-separated keywords return results that match any of them (better for broad searches). Keywords inside double quotes match the exact phrase (better for exact searches). Prefer a single call with multiple keywords over multiple separate tool calls.
statestring- Filter by delivery state (DELIVERING, PAUSED, UPCOMING, COMPLETED, BLOCKED, etc.). Use when the user asks about delivering, paused, upcoming, or completed campaigns.
vibemcp_list_company_list_audiencesList company list audiences for a given advertiser, sorted by most recently created, with their status and size.Read-onlyList Company List Audiences
List company list audiences for a given advertiser, sorted by most recently created, with their status and size. A company list audience reaches employees of the companies the advertiser uploaded. Use this to find the company list audience IDs to fill `targetingCompanyListAudiences`.
Inputs
advertiserIdstringrequired- The advertiser ID to list company list audiences for.
vibemcp_list_creativesList video creatives for the current tenant with optional filters.Read-onlyList Creatives
List video creatives for the current tenant with optional filters. Use this when the user asks about their creatives, creative status, or wants to see what ads they have.
Inputs
advertiserIdstring- Filter by advertiser ID
labelstring- Filter creatives that have at least one label containing the given creative label name.
limitstring- Max results to return.default
50 searchstring- Search by creative name. Space-separated keywords return results that match any of them (better for broad searches). Keywords inside double quotes match the exact phrase (better for exact searches). Prefer a single call with multiple keywords over multiple separate tool calls.
statusesstring- Filter creatives that have one of the given computed creative statuses. Pass all but BLOCKED for creatives usable inside a campaign.
vibemcp_list_crm_audiencesList CRM audiences for a given advertiser, sorted by most recently created.Read-onlyList CRM Audiences
List CRM audiences for a given advertiser, sorted by most recently created. Use this to find the CRM audience IDs to fill `targetingCrmAudiences`.
Inputs
advertiserIdstringrequired- The advertiser ID to list CRM audiences for.
vibemcp_list_firmographic_audiencesList firmographic audiences for a given advertiser, sorted by most recently created, with their status and size.Read-onlyList Firmographic Audiences
List firmographic audiences for a given advertiser, sorted by most recently created, with their status and size. A firmographic audience reaches employees of companies matching company and job criteria. Use this to find the firmographic audience IDs to fill `targetingFirmographicAudiences`.
Inputs
advertiserIdstringrequired- The advertiser ID to list firmographic audiences for.
vibemcp_list_lookalike_audiencesList lookalike audiences for a given advertiser, sorted by most recently created, with the seed audiences each one expands from.Read-onlyList Lookalike Audiences
List lookalike audiences for a given advertiser, sorted by most recently created, with the seed audiences each one expands from. Use this to find the lookalike audience IDs to fill `targetingLookalikeAudiences`.
Inputs
advertiserIdstringrequired- The advertiser ID to list lookalike audiences for.
vibemcp_list_public_audiencesList public audiences (powered by Walmart) also known as "In-Market & Interests", optionally filtered by a keyword in the name/category path or by audience type.Read-onlyList Public Audiences
List public audiences (powered by Walmart) also known as "In-Market & Interests", optionally filtered by a keyword in the name/category path or by audience type. Use the IDs to fill `targetingPublicAudiencesControls` or `targetingPublicAudiencesSuggestions` in strategy targeting. Some Walmart audiences are coming soon: they are hidden from this list until they are available.
Inputs
audienceTypestring- Only display audiences of this type. `PERSONA`: who a household is (life stage, lifestyle, seasonal moments). `RECENT_BUYERS`: households who have recently purchased within a category. `IN_MARKET`: households with high intent to purchase within a category. `DEMOGRAPHIC`: demographic information about households.
limitstring- Max audiences to return.default
50 searchstring- Search by name or by its category path. Space-separated keywords return results that match any of them (better for broad searches). Keywords inside double quotes match the exact phrase (better for exact searches). Prefer a single call with multiple keywords over multiple separate tool calls.
vibemcp_list_strategiesList strategies for a campaign.Read-onlyList Strategies
List strategies for a campaign. Use this when the user asks about strategies in a campaign, or when you need to find strategy IDs.
Inputs
campaignIdstringrequired- The campaign ID to list strategies for
vibemcp_list_tv_inventoryList TV inventory items (apps, channels, sports leagues) from the global catalog, optionally filtered by a name search.Read-onlyList TV Inventory
List TV inventory items (apps, channels, sports leagues) from the global catalog, optionally filtered by a name search. Use this to find catalog IDs or names, either for channels or live sports.
Inputs
inventoryTypestringrequired- Which subset of the catalog to list: APPS_AND_CHANNELS for streaming apps and TV channels, LIVE_SPORTS for sports leagues/programs. When selecting a channel for `create_or_update_campaign`, pass `inventoryType` matching the strategy `targetingTvInventoryTypeControl` (APPS_AND_CHANNELS or LIVE_SPORTS) as only one can be selected for a given strategy.one of
APPS_AND_CHANNELSLIVE_SPORTS limitstring- Max results to return.default
100 searchstring- Search by inventory item name. Space-separated keywords return results that match any of them (better for broad searches). Keywords inside double quotes match the exact phrase (better for exact searches). Prefer a single call with multiple keywords over multiple separate tool calls.
vibemcp_list_url_matching_audiencesList URL matching audiences for a given advertiser, sorted by most recently modified.Read-onlyList URL Matching Audiences
List URL matching audiences for a given advertiser, sorted by most recently modified. A URL matching audience targets users by the URLs they visited (data coming from Vibe pixel), and is shown as Web Traffic in the Audience Manager. Use this to fill `targetingUrlMatchingAudienceIdIncludedControls`, `targetingUrlMatchingAudienceIdIncludedSuggestions` and `targetingUrlMatchingAudienceIdExcludedControls`.
Inputs
advertiserIdstringrequired- The advertiser ID to list URL matching audiences for.
vibemcp_query_metricsQuery reporting metrics from the data warehouse.Read-onlyQuery Metrics
Query reporting metrics from the data warehouse. Use this to get campaign performance data, spend, impressions, and other metrics. You can group by dimensions (DATE, CAMPAIGN_NAME, STATE, etc.) and filter by advertiser or campaign. If user asks about platform, depending on context it could mean DEVICE_SCREEN_TYPE or INVENTORY_CHANNEL_NAME. The query is already scoped by tenant id, no need to pass it. Use the user-friendly names for the dimensions and metrics, not the capitalized technical names.
Inputs
dateRangeobjectrequired- Both start and end are inclusive. For "last N days", exclude today: start = today minus N, end = yesterday.
metricsarrayrequired- Metrics to retrieve.
orderByobjectrequired- No description.
advertiserIdstring- No description.
attributionWindowstring- No description.
campaignIdstring- No description.
dimensionsstring- Dimensions to group by. Omit if you need to return aggregate metrics over the date range.
filtersstring- No description.
limitnumber- No description.
timeGranularitystring- Time bucketing granularity when grouping by date. Required when the DATE dimension is included. Use DAY for daily trends, WEEK for weekly, MONTH for monthly, QUARTER for quarterly, YEAR for annual. Defaults to DAY if omitted with DATE dimension.
vibemcp_search_help_centerAnswer a general knowledge question from the live Vibe Help Center: how something works, what a term means, or what the policy is.Read-onlySearch Help Center
Answer a general knowledge question from the live Vibe Help Center: how something works, what a term means, or what the policy is.
Inputs
questionstringrequired- The question to answer, self-contained, with pronouns and references resolved.
searchPhrasestringrequired- Keyword search phrase that will return the top articles matching: 2-6 words of Vibe product vocabulary, not the user's sentence. Matching is keyword-based, so the words must appear in the article.
vibemcp_search_locationsSearch for geographic locations by name.Read-onlySearch Locations
Search for geographic locations by name. Returns matching states, cities, metro areas, counties, or congressional districts with the exact code to use in query_metrics filters, and with the exact ID to use in strategy targeting controls. Use this when the user mentions a geographic location and you need the correct filter value.
Inputs
inputstringrequired- Geographic name to search for. Space-separated keywords return results that match any of them (better for broad searches). Keywords inside double quotes match the exact phrase (better for exact searches). Prefer a single call with multiple keywords over multiple separate tool calls. Acronyms match multi-word names by word initials (e.g. 'nc' matches 'North Carolina').
limitstring- Max results to return.default
100 location_typesstring- Filter to restrict results to specific location types
vibemcp_create_or_update_campaignCreate or update a campaign and its strategies.DestructiveCreate or Update Campaign
Create or update a campaign and its strategies. This tool does not publish draft campaigns. Use list_* and get_* tools to search for entity IDs or details when needed. Refuse to modify a campaign that has been archived, this can only be done manually via the dashboard. On validation failures, fix the offending fields and retry. Returns an error if one of the entities referenced in the input does not exist or the caller lacks access. Do not retry if the approval is rejected. For optimization recommendations, `get_business_rules` covers them with domain `campaign_optimization_playbook`.
Inputs
campaignobjectrequired- # Campaign Input Instructions ## Prerequisites - DRAFT campaigns are fully editable. PUBLISHED campaigns can be edited with restrictions (see "Updating a published campaign"). ARCHIVED/DELETED campaigns are read-only. - A campaign must have at least one strategy ## Creating a campaign - Include all fields where the description mentions "Required on create". ## Updating a campaign - The campaign and strategies may have changed since your last calls, therefore only include fields that need to change. Omit every other field, or set to null, to leave them unchanged. ### Updating a published campaign The following restrictions apply both the dashboard and this tool: - Allowed: rename, optimization goal, attribution window, pause/resume (the `active` field on the campaign or a strategy), strategy budgets/bids/targeting/creatives/end dates, and adding new strategies. - Not allowed: changing the campaign advertiser/goal, changing an existing strategy budget type or start date, deleting strategies.
vibemcp_prepare_creative_uploadPrepare a direct MP4 upload for an advertiser.DestructivePrepare Creative Upload
Prepare a direct MP4 upload for an advertiser. Post a multipart form directly to uploadUrl using every returned field and a file part, then call upload_creative with source.type="upload" and the returned uploadId. The video must be 100 KiB to 500 MiB and use Content-Type video/mp4. If campaignId is supplied, omit strategyIds only when the campaign has exactly one active strategy.
Inputs
advertiserIdstringrequired- Advertiser UUID that will own the creative.
campaignIdstring- Campaign UUID to attach the creative to after creation.
isAiGeneratedVideoboolean- Whether an AI system generated the video.default
false strategyIdsstring- Strategy UUIDs within campaignId. Omit only when the campaign has exactly one strategy.
vibemcp_publish_campaignPublish a draft campaign.DestructivePublish Campaign
Publish a draft campaign. Only call this after explicit user confirmation, because publishing is a non-reversible user-facing action that starts ad delivery and spend. On validation failures, do not retry but instead explain the errors in a user-friendly way and suggest modifications. Returns an error if the campaign is not in draft, if it does not exist, or if the caller lacks access.
Inputs
campaignIdstringrequired- The ID of the DRAFT campaign to publish
vibemcp_upload_creativeUpload an MP4 into an advertiser creative library.DestructiveUpload Creative
Upload an MP4 into an advertiser creative library. For source.type="upload": finalize a direct upload prepared with prepare_creative_upload after posting the multipart form. Repeat with this source type while status is processing.For source.type="url": provide a public HTTPS MP4. The first call queues asynchronous ingestion and immediately returns status="processing" with uploadId; poll only with source.type="upload" and that uploadId afterward. Polling returns status="failed" with a safe error if ingestion fails. Each URL submission creates a new upload. For both source types, this returns a stable creativeId after existing CTV validation succeeds and optionally attaches it to campaign strategies.
Inputs
advertiserIdstringrequired- Advertiser UUID that will own the creative.
namestringrequired- Creative name shown in the advertiser library.
sourceobjectrequired- No description.
campaignIdstring- Campaign UUID to attach the creative to after creation.
isAiGeneratedVideoboolean- Whether an AI system generated the video.default
false strategyIdsstring- Strategy UUIDs within campaignId. Omit only when the campaign has exactly one strategy.
No tools match.