Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to the Adzviser MCP server

Vendor MCP
Open markdown

The Adzviser MCP connector routes your AI agent's tool calls to Adzviser's own MCP server through Scalekit. Each user signs in to Adzviser once, and Scalekit stores and refreshes their tokens, so your agent never handles credentials. It comes with 63 tools.

Tools
63
What they doRead · write · destructive
63 · 0 · 063 read0 write0 destructive
Users sign in with
OAuth app
Scalekit's or your own

What you can do

  • Pull marketing reports: retrieve live performance data from ad, analytics, CRM, email, and ecommerce channels for analysis
  • Explore available metrics: list selectable metrics and breakdowns for platforms like Google Ads, Facebook Ads, GA4, and Shopify
  • List workspaces: see each workspace and the ad accounts and data sources connected to it

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv

  2. Set your credentials

    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. Create the Adzviser MCP connection

    In AgentKit > Connections, create an Adzviser MCP connection. The name you give it is the connection_name your code passes. See Configure connections.

    Scalekit credentials are available for Adzviser MCP server, so you don't need to register an OAuth app. To show your own app on the consent screen, use your own credentials instead.

    Use your own OAuth app

    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 AgentKit → Connections → Create 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. 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.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)
    const rl = createInterface({ input: process.stdin, output: process.stdout })
    await rl.question('Press Enter after authorizing...')
    rl.close()
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'adzvisermcp_list_countries_fb_ad_library',
      toolInput: {},
    })
    console.log(result)
    Terminal window
    npx tsx quickstart.mts

    Each user signs in once. See Authorize a user for the full flow and statuses.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • adzvisermcp_list_countries_fb_ad_libraryGet the list of available countries/regions for Facebook (Meta) Ad Library searches.Read-only

    List Available Countries for Facebook Ad Library

    Get the list of available countries/regions for Facebook (Meta) Ad Library searches. Use these regions when composing a meta_ad_library_request in the retrieve_reporting_data tool.

    Inputs

    This tool takes no inputs.

  • adzvisermcp_list_countries_google_ads_transparencyGet the list of available countries/regions for Google Ads Transparency Center searches.Read-only

    List Available Countries for Google Ads Transparency Center

    Get the list of available countries/regions for Google Ads Transparency Center searches. Use these regions when composing a google_ads_transparency_request in the retrieve_reporting_data tool.

    Inputs

    This tool takes no inputs.

  • adzvisermcp_list_metrics_and_breakdowns_activecampaignGet the list of selectable ActiveCampaign metrics, such as Contacts, Sends, Opens, Clicks, and breakdowns like Campaign Name, List Name etc.Read-only

    ActiveCampaign Metrics and Breakdowns

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

    Inputs

    This tool takes no inputs.

  • adzvisermcp_list_metrics_and_breakdowns_adobe_analyticsGet the list of selectable Adobe Analytics 2.0 metrics like Page views, Visits, Visitors, and breakdowns like Page, Browser, and Device type etc.Read-only

    Adobe Analytics 2.0 Metrics and Breakdowns

    Get the list of selectable Adobe Analytics 2.0 metrics like Page views, Visits, Visitors, and breakdowns like Page, Browser, and Device type etc.

    Inputs

    This tool takes no inputs.

  • adzvisermcp_list_metrics_and_breakdowns_adrollGet the list of selectable AdRoll metrics, such as Impressions, Clicks, Spend, Conversions, and breakdowns like Campaign Name, Ad Group, Creative etc.Read-only

    AdRoll Metrics and Breakdowns

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

    Inputs

    This tool takes no inputs.

  • adzvisermcp_list_metrics_and_breakdowns_amazon_adsGet the list of selectable Amazon Ads metrics like Purchases, Spend etc.Read-only

    Amazon Ads Metrics and Breakdowns

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

    Inputs

    This tool takes no inputs.

  • adzvisermcp_list_metrics_and_breakdowns_amazon_dspGet selectable Amazon DSP metrics and breakdowns for amazon_dsp_request.Read-only

    List Metrics And Breakdowns Amazon Dsp

    Get selectable Amazon DSP metrics and breakdowns for amazon_dsp_request. Discover valid field names before requesting reports.

    Inputs

    This tool takes no inputs.

  • adzvisermcp_list_metrics_and_breakdowns_amazon_sellerGet the list of selectable Amazon Seller Central metrics like Item price, Orders shipped, etc.Read-only

    Amazon Seller Metrics and Breakdowns

    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.

    Inputs

    This tool takes no inputs.

Workflows

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({
  connector: '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({
  connector: '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({
  connector: '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);
All 87 in Marketing