Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Adzviser MCP connector

OAuth 2.1/DCR MarketingAnalytics

Connect to Adzviser MCP to query real-time marketing analytics across 46+ platforms - Google Ads, Facebook Ads, GA4, TikTok, LinkedIn, and more - from a...

Adzviser MCP connector

  1. Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Add your Scalekit credentials to your .env file. 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>
  3. Register your Adzviser MCP credentials with Scalekit so it handles the token lifecycle. You do this once per environment.

    Dashboard setup steps

    Adzviser MCP uses Dynamic Client Registration (DCR) — no client ID or secret is required. The only step is creating a connection in Scalekit and authorizing your Adzviser account.

    1. Create a connection in Scalekit

      • In the Scalekit dashboard, go to AgentKitConnectionsCreate Connection.
      • Search for Adzviser MCP and click Create.
      • Note the Connection name — use this as connection_name in your code (e.g., adzvisermcp).
    2. Authorize your Adzviser account

      Generate an authorization link and open it in a browser to complete the Adzviser OAuth flow.

      The user is redirected to Adzviser to sign in and grant access. Scalekit stores the token and injects it automatically into every tool call — no further configuration is needed.

  4. quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    const scalekit = new ScalekitClient(
    process.env.SCALEKIT_ENV_URL,
    process.env.SCALEKIT_CLIENT_ID,
    process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    const connector = 'adzvisermcp'
    const identifier = 'user_123'
    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Adzviser MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    // Make your first call
    const result = await actions.executeTool({
    connector,
    identifier,
    toolName: 'adzvisermcp_list_metrics_and_breakdowns_activecampaign',
    toolInput: {},
    })
    console.log(result)

Connect this agent connector to let your agent:

  • Data retrieve reporting — Retrieve real-time reporting data from marketing channels like Google Ads, Facebook Ads and Google Analytics
  • List workspace, metrics fb page, metrics and breakdowns zoho — Retrieve a list of workspaces that have been created by the user and their data sources, such as Google Ads, Facebook Ads accounts connected with each

List workspaces

Use adzvisermcp_list_workspace to retrieve the workspaces the user has configured, along with their connected ad platform accounts.

const result = await actions.executeTool({
connectionName: 'adzvisermcp',
identifier: 'user_123',
toolName: 'adzvisermcp_list_workspace',
toolInput: {},
});
console.log(result);

Discover available metrics for a platform

Before querying data, call a list_metrics_and_breakdowns_* tool to discover valid metric and breakdown names for your target platform.

// Discover Google Ads metrics and breakdowns
const fields = await actions.executeTool({
connectionName: 'adzvisermcp',
identifier: 'user_123',
toolName: 'adzvisermcp_list_metrics_and_breakdowns_google_ads',
toolInput: {},
});
console.log(fields);

Retrieve reporting data across platforms

Use adzvisermcp_retrieve_reporting_data to pull structured analytics from one or more connected platforms. Pass an adzviser_request object to specify metrics, breakdowns, date ranges, and filters. Most use cases work without this parameter — Adzviser auto-fetches data from all connected accounts.

const report = await actions.executeTool({
connectionName: 'adzvisermcp',
identifier: 'user_123',
toolName: 'adzvisermcp_retrieve_reporting_data',
toolInput: {
adzviser_request: {
google_ads_request: {
metrics: ['Clicks', 'Impressions', 'Cost'],
breakdowns: ['Campaign Name'],
date_ranges: [{ start_date: '2024-01-01', end_date: '2024-01-31' }],
},
},
},
});
console.log(report);

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

adzvisermcp_list_metrics_and_breakdowns_activecampaign # Get the list of selectable ActiveCampaign metrics, such as Contacts, Sends, Opens, Clicks, and breakdowns like Campaign Name, List Name etc. 0 params

Get the list of selectable ActiveCampaign metrics, such as Contacts, Sends, Opens, Clicks, and breakdowns like Campaign Name, List Name etc.

adzvisermcp_list_metrics_and_breakdowns_adroll # Get the list of selectable AdRoll metrics, such as Impressions, Clicks, Spend, Conversions, and breakdowns like Campaign Name, Ad Group, Creative etc. 0 params

Get the list of selectable AdRoll metrics, such as Impressions, Clicks, Spend, Conversions, and breakdowns like Campaign Name, Ad Group, Creative etc.

adzvisermcp_list_metrics_and_breakdowns_amazon_ads # Get the list of selectable Amazon Ads metrics like Purchases, Spend etc. and breakdowns like Campaign name, Keyword text, and ASIN etc. 0 params

Get the list of selectable Amazon Ads metrics like Purchases, Spend etc. and breakdowns like Campaign name, Keyword text, and ASIN etc.

adzvisermcp_list_metrics_and_breakdowns_amazon_seller # Get the list of selectable Amazon Seller Central metrics like Item price, Orders shipped, etc. and breakdowns like ASIN, Order channel, and Product name etc. 0 params

Get the list of selectable Amazon Seller Central metrics like Item price, Orders shipped, etc. and breakdowns like ASIN, Order channel, and Product name etc.

adzvisermcp_list_metrics_and_breakdowns_apple_ads # Get the list of selectable Apple Ads (Apple Search Ads) metrics, such as Impressions, Taps, Installs, Spend, and breakdowns like Campaign Name, Ad Group, Keyword etc. 0 params

Get the list of selectable Apple Ads (Apple Search Ads) metrics, such as Impressions, Taps, Installs, Spend, and breakdowns like Campaign Name, Ad Group, Keyword etc.

adzvisermcp_list_metrics_and_breakdowns_bigcommerce # Get the list of selectable BigCommerce metrics like Orders, Revenue, Items sold, and breakdowns like Product name, Customer email, and Order status etc. 0 params

Get the list of selectable BigCommerce metrics like Orders, Revenue, Items sold, and breakdowns like Product name, Customer email, and Order status etc.

adzvisermcp_list_metrics_and_breakdowns_bing_ads # Get the list of selectable Bing Ads metrics like Impressions, Cost, Clicks, etc. and breakdowns like Campaign name, Keyword, and Device type etc. 0 params

Get the list of selectable Bing Ads metrics like Impressions, Cost, Clicks, etc. and breakdowns like Campaign name, Keyword, and Device type etc.

adzvisermcp_list_metrics_and_breakdowns_bing_webmaster # Get the list of selectable Bing Webmaster metrics like Clicks, Impressions, CTR, and breakdowns like Query, Page URL, and Country etc. 0 params

Get the list of selectable Bing Webmaster metrics like Clicks, Impressions, CTR, and breakdowns like Query, Page URL, and Country etc.

adzvisermcp_list_metrics_and_breakdowns_callrail # Get the list of selectable CallRail metrics like Total calls, Answered calls, Call duration, and breakdowns like Tracking number, Source, and Campaign etc. 0 params

Get the list of selectable CallRail metrics like Total calls, Answered calls, Call duration, and breakdowns like Tracking number, Source, and Campaign etc.

adzvisermcp_list_metrics_and_breakdowns_cm360 # Get the list of selectable Campaign Manager 360 (CM360) metrics, such as Impressions, Clicks, Conversions, and breakdowns like Campaign Name, Site, Placement etc. 0 params

Get the list of selectable Campaign Manager 360 (CM360) metrics, such as Impressions, Clicks, Conversions, and breakdowns like Campaign Name, Site, Placement etc.

adzvisermcp_list_metrics_and_breakdowns_dv360 # Get the list of selectable Display & Video 360 (DV360) metrics, such as Impressions, Clicks, Revenue, and breakdowns like Campaign Name, Insertion Order, Line Item etc. 0 params

Get the list of selectable Display & Video 360 (DV360) metrics, such as Impressions, Clicks, Revenue, and breakdowns like Campaign Name, Insertion Order, Line Item etc.

adzvisermcp_list_metrics_and_breakdowns_fb_ads # Get the list of selectable Facebook Ads metrics, such as Spend, CPC, Clicks, and breakdowns such as Gender, Country, and Device etc. If workspace_name is provided, custom conversions for that workspace will be included in the metrics list. 1 param

Get the list of selectable Facebook Ads metrics, such as Spend, CPC, Clicks, and breakdowns such as Gender, Country, and Device etc. If workspace_name is provided, custom conversions for that workspace will be included in the metrics list.

Name Type Required Description
workspace_name string optional Optional workspace name to retrieve custom conversions for the Facebook Ads account in that workspace. If not provided, only standard metrics and breakdowns are returned.
adzvisermcp_list_metrics_and_breakdowns_fb_post # Get the list of selectable Facebook Post/Video metrics like Post likes, Post total reactions, etc. and breakdowns like Post message, Post image URL, etc. 0 params

Get the list of selectable Facebook Post/Video metrics like Post likes, Post total reactions, etc. and breakdowns like Post message, Post image URL, etc.

adzvisermcp_list_metrics_and_breakdowns_ga4 # Get the list of selectable Google Analytics metrics such as Active users, New users, Sessions, and breakdowns like Account name, Session medium, and Country etc. 0 params

Get the list of selectable Google Analytics metrics such as Active users, New users, Sessions, and breakdowns like Account name, Session medium, and Country etc.

adzvisermcp_list_metrics_and_breakdowns_google_ads # Get the list of selectable Google Ads metrics, such as Cost, Roas, Impressions, and breakdowns like Device, Keyword Text, and Campaign Name etc. 0 params

Get the list of selectable Google Ads metrics, such as Cost, Roas, Impressions, and breakdowns like Device, Keyword Text, and Campaign Name etc.

adzvisermcp_list_metrics_and_breakdowns_google_my_business # Get the list of selectable Google My Business metrics, such as Total views, Phone calls, Bookings, and breakdowns like Location name, Website URL, and Address lines etc. 0 params

Get the list of selectable Google My Business metrics, such as Total views, Phone calls, Bookings, and breakdowns like Location name, Website URL, and Address lines etc.

adzvisermcp_list_metrics_and_breakdowns_hubspot # Get the list of selectable HubSpot metrics like Contacts, Leads, etc. and breakdowns like Company name, Contact email, and Deal ID etc. 0 params

Get the list of selectable HubSpot metrics like Contacts, Leads, etc. and breakdowns like Company name, Contact email, and Deal ID etc.

adzvisermcp_list_metrics_and_breakdowns_ig_post # Get the list of selectable Instagram Post metrics such as Post Comments, Post Follows, Post Likes, and breakdowns like Media URL, Media Caption, and Media Product Type etc. 0 params

Get the list of selectable Instagram Post metrics such as Post Comments, Post Follows, Post Likes, and breakdowns like Media URL, Media Caption, and Media Product Type etc.

adzvisermcp_list_metrics_and_breakdowns_ig_profile # Get the list of selectable Instagram Profile metrics like Profile Follower, Profile Impressions, etc., and breakdowns like Profile ID, Profile Name, and Profile Website etc. 0 params

Get the list of selectable Instagram Profile metrics like Profile Follower, Profile Impressions, etc., and breakdowns like Profile ID, Profile Name, and Profile Website etc.

adzvisermcp_list_metrics_and_breakdowns_klaviyo # Get the list of selectable Klaviyo metrics, such as Emails recipients, Received SMS, and breakdowns like Campaign name, Flow name, and Person first name etc. 0 params

Get the list of selectable Klaviyo metrics, such as Emails recipients, Received SMS, and breakdowns like Campaign name, Flow name, and Person first name etc.

adzvisermcp_list_metrics_and_breakdowns_linkedin_ads # Get the list of selectable LinkedIn Ads metrics, such as Impressions, Reach, Total spent, and breakdowns like Device, Placement, and Campaign name etc. 0 params

Get the list of selectable LinkedIn Ads metrics, such as Impressions, Reach, Total spent, and breakdowns like Device, Placement, and Campaign name etc.

adzvisermcp_list_metrics_and_breakdowns_linkedin_company_page # Get the list of selectable LinkedIn Page metrics, such as Content comments, Lifetime followers, Page views, and breakdowns like Content text, and Content URL etc. 0 params

Get the list of selectable LinkedIn Page metrics, such as Content comments, Lifetime followers, Page views, and breakdowns like Content text, and Content URL etc.

adzvisermcp_list_metrics_and_breakdowns_mailchimp # Get the list of selectable Mailchimp metrics, such as Emails sent, Open rate (%), Total clicks, and breakdowns like Campaign name, List name, and Member email etc. 0 params

Get the list of selectable Mailchimp metrics, such as Emails sent, Open rate (%), Total clicks, and breakdowns like Campaign name, List name, and Member email etc.

adzvisermcp_list_metrics_and_breakdowns_marketo # Get the list of selectable Marketo metrics, such as Leads Created, Emails Sent, and breakdowns like Program Name, Campaign Name etc. 0 params

Get the list of selectable Marketo metrics, such as Leads Created, Emails Sent, and breakdowns like Program Name, Campaign Name etc.

adzvisermcp_list_metrics_and_breakdowns_matomo # Get the list of selectable Matomo metrics, such as Visits, Pageviews, Bounce Rate, and breakdowns like Page URL, Referrer, Country etc. 0 params

Get the list of selectable Matomo metrics, such as Visits, Pageviews, Bounce Rate, and breakdowns like Page URL, Referrer, Country etc.

adzvisermcp_list_metrics_and_breakdowns_merchant_center # Get the list of selectable Merchant Center metrics, such as Impressions, Clicks, Conversions, and breakdowns like Title, Brand, and Availability etc. 0 params

Get the list of selectable Merchant Center metrics, such as Impressions, Clicks, Conversions, and breakdowns like Title, Brand, and Availability etc.

adzvisermcp_list_metrics_and_breakdowns_omnisend # Get the list of selectable Omnisend metrics, such as Emails Sent, Open Rate, Click Rate, and breakdowns like Campaign Name, Automation Name etc. 0 params

Get the list of selectable Omnisend metrics, such as Emails Sent, Open Rate, Click Rate, and breakdowns like Campaign Name, Automation Name etc.

adzvisermcp_list_metrics_and_breakdowns_pinterest_ads # Get the list of selectable Pinterest Ads metrics, such as Impressions paid, Cost, Video views, and breakdowns like Ad group name, and Targeting location etc. 0 params

Get the list of selectable Pinterest Ads metrics, such as Impressions paid, Cost, Video views, and breakdowns like Ad group name, and Targeting location etc.

adzvisermcp_list_metrics_and_breakdowns_pinterest_organic # Get the list of selectable Pinterest Organic metrics like Pin impressions, Saves, Clicks, and breakdowns like Pin title, Board name, and Pin URL etc. 0 params

Get the list of selectable Pinterest Organic metrics like Pin impressions, Saves, Clicks, and breakdowns like Pin title, Board name, and Pin URL etc.

adzvisermcp_list_metrics_and_breakdowns_pipedrive # Get the list of selectable Pipedrive metrics, such as Deals Won, Revenue, Activities, and breakdowns like Pipeline, Deal Owner, Stage etc. 0 params

Get the list of selectable Pipedrive metrics, such as Deals Won, Revenue, Activities, and breakdowns like Pipeline, Deal Owner, Stage etc.

adzvisermcp_list_metrics_and_breakdowns_reddit_ads # Get the list of selectable Reddit Ads metrics like Impressions, Clicks, Spend, and breakdowns like Campaign name, Ad group name, and Subreddit etc. 0 params

Get the list of selectable Reddit Ads metrics like Impressions, Clicks, Spend, and breakdowns like Campaign name, Ad group name, and Subreddit etc.

adzvisermcp_list_metrics_and_breakdowns_sa360 # Get the list of selectable Search Ads 360 (SA360) metrics, such as Impressions, Clicks, Cost, Conversions, and breakdowns like Campaign Name, Ad Group, Keyword etc. 0 params

Get the list of selectable Search Ads 360 (SA360) metrics, such as Impressions, Clicks, Cost, Conversions, and breakdowns like Campaign Name, Ad Group, Keyword etc.

adzvisermcp_list_metrics_and_breakdowns_salesforce # Get the list of selectable Salesforce metrics like Opportunity count, Leads, etc. and breakdowns like Opportunity name, Campaign name, etc. 0 params

Get the list of selectable Salesforce metrics like Opportunity count, Leads, etc. and breakdowns like Opportunity name, Campaign name, etc.

adzvisermcp_list_metrics_and_breakdowns_search_console # Get the list of selectable Google Search Console metrics like Clicks, Positions, etc. and breakdowns like Landing page, and Search query etc. 0 params

Get the list of selectable Google Search Console metrics like Clicks, Positions, etc. and breakdowns like Landing page, and Search query etc.

adzvisermcp_list_metrics_and_breakdowns_shopify # Get the list of selectable Shopify metrics, such as Gross sales, Returns, Shipping, and breakdowns like Customer first name, Product SKU, and Order ID etc. 0 params

Get the list of selectable Shopify metrics, such as Gross sales, Returns, Shipping, and breakdowns like Customer first name, Product SKU, and Order ID etc.

adzvisermcp_list_metrics_and_breakdowns_snapchat_ads # Get the list of selectable Snapchat Ads metrics such as Impressions, Cost, Leads, and breakdowns like DMA, Ad type, and Campaign name etc. 0 params

Get the list of selectable Snapchat Ads metrics such as Impressions, Cost, Leads, and breakdowns like DMA, Ad type, and Campaign name etc.

adzvisermcp_list_metrics_and_breakdowns_spotify_ads # Get the list of selectable Spotify Ads metrics, such as Impressions, Clicks, Spend, Listens, and breakdowns like Campaign Name, Ad Set, Ad Format etc. 0 params

Get the list of selectable Spotify Ads metrics, such as Impressions, Clicks, Spend, Listens, and breakdowns like Campaign Name, Ad Set, Ad Format etc.

adzvisermcp_list_metrics_and_breakdowns_sprout_social # Get the list of selectable Sprout Social metrics, such as Impressions, Engagements, Followers, and breakdowns like Profile, Network, Post Type etc. 0 params

Get the list of selectable Sprout Social metrics, such as Impressions, Engagements, Followers, and breakdowns like Profile, Network, Post Type etc.

adzvisermcp_list_metrics_and_breakdowns_threads_insights # Get the list of selectable Threads Insights metrics like Views, Likes, Replies, Reposts, and breakdowns like Post text, Post ID, and Media type etc. 0 params

Get the list of selectable Threads Insights metrics like Views, Likes, Replies, Reposts, and breakdowns like Post text, Post ID, and Media type etc.

adzvisermcp_list_metrics_and_breakdowns_tiktok_ads # Get the list of selectable TikTok Ads metrics, such as Clicks, CPM, Cost, and breakdowns like Campaign name, Gender, and Age etc. 0 params

Get the list of selectable TikTok Ads metrics, such as Clicks, CPM, Cost, and breakdowns like Campaign name, Gender, and Age etc.

adzvisermcp_list_metrics_and_breakdowns_tiktok_organic # Get the list of selectable TikTok Organic metrics like Video views, Likes, Comments, Shares, and breakdowns like Video title, Video ID, and Create time etc. 0 params

Get the list of selectable TikTok Organic metrics like Video views, Likes, Comments, Shares, and breakdowns like Video title, Video ID, and Create time etc.

adzvisermcp_list_metrics_and_breakdowns_trade_desk # Get the list of selectable Trade Desk metrics, such as Impressions, Clicks, Spend, Conversions, and breakdowns like Campaign Name, Ad Group, Creative etc. 0 params

Get the list of selectable Trade Desk metrics, such as Impressions, Clicks, Spend, Conversions, and breakdowns like Campaign Name, Ad Group, Creative etc.

adzvisermcp_list_metrics_and_breakdowns_woo_commerce # Get the list of selectable WooCommerce metrics, such as Gross sales, Returns, Items sold, and breakdowns like Order number, Billing first name, and Shipping phone etc. 0 params

Get the list of selectable WooCommerce metrics, such as Gross sales, Returns, Items sold, and breakdowns like Order number, Billing first name, and Shipping phone etc.

adzvisermcp_list_metrics_and_breakdowns_x_ads # Get the list of selectable X Ads (Twitter Ads) metrics like Impressions, Clicks, Spend, and breakdowns like Campaign name, Ad group name, and Placement etc. 0 params

Get the list of selectable X Ads (Twitter Ads) metrics like Impressions, Clicks, Spend, and breakdowns like Campaign name, Ad group name, and Placement etc.

adzvisermcp_list_metrics_and_breakdowns_youtube # Get the list of selectable YouTube metrics like Video views, Likes, Comments, etc. and breakdowns like Video ID, Video title, and Channel name etc. 0 params

Get the list of selectable YouTube metrics like Video views, Likes, Comments, etc. and breakdowns like Video ID, Video title, and Channel name etc.

adzvisermcp_list_metrics_and_breakdowns_zoho # Get the list of selectable Zoho CRM metrics like Leads, Deals, Contacts, and breakdowns like Lead source, Deal stage, and Account name etc. 0 params

Get the list of selectable Zoho CRM metrics like Leads, Deals, Contacts, and breakdowns like Lead source, Deal stage, and Account name etc.

adzvisermcp_list_metrics_fb_page # Get the list of selectable Facebook Page Insights metrics, such as Total likes, Total reach, Total page views etc. 0 params

Get the list of selectable Facebook Page Insights metrics, such as Total likes, Total reach, Total page views etc.

adzvisermcp_list_workspace # Retrieve a list of workspaces that have been created by the user and their data sources, such as Google Ads, Facebook Ads accounts connected with each. 0 params

Retrieve a list of workspaces that have been created by the user and their data sources, such as Google Ads, Facebook Ads accounts connected with each.

adzvisermcp_retrieve_reporting_data # Retrieve real-time reporting data from marketing channels like Google Ads, Facebook Ads and Google Analytics. Returns structured data that you can analyze, compare, calculate, and summarize. 1 param

Retrieve real-time reporting data from marketing channels like Google Ads, Facebook Ads and Google Analytics. Returns structured data that you can analyze, compare, calculate, and summarize.

Name Type Required Description
adzviser_request object optional Optional structured request body specifying platforms, metrics, breakdowns, date ranges, and filters for the report.