Connect to AI agents

Wire AdCrunch into Claude, Cursor, and ChatGPT via the MCP server. Tool reference and recipes.

Auth & scopes

  • Auth & scopes
    How OAuth works for the MCP server, scopes granted, token lifecycle, revocation.

Overview

  • What is MCP
    How the Model Context Protocol lets AI agents query AdCrunch in natural language.

Recipes

Set up your AI client

  • Claude Desktop
    Install the AdCrunch MCP server in Claude Desktop and authorize your organization.
  • Claude Code
    Install the AdCrunch MCP server in Claude Code and authorize your organization.
  • Cursor
    Install the AdCrunch MCP server in Cursor and authorize your organization.
  • ChatGPT
    Install AdCrunch as a custom MCP connector in ChatGPT.

Tool reference

  • list_advertisers
    List the advertisers (ad accounts) in your organization, optionally filtered by provider.
  • list_campaigns
    List campaigns for one advertiser, optionally filtered by status or date.
  • list_ad_groups
    List ad groups under one campaign or one advertiser.
  • list_ads
    List ads under one ad group or one campaign.
  • query_insights
    Aggregate spend / impressions / clicks / conversions over a date range, by entity.
  • search_ads
    Search the shared competitor ad-library corpus with structured filters and/or a free-text semantic query.
  • request_crawl
    Subscribe your organization to a Crawl Target so the AdCrunch Library starts pulling that brand or keyword.
  • skill_list
    List your organization's ad-ops playbooks (Skills) by slug, name, and description.
  • skill_get
    Fetch one ad-ops playbook (Skill) by slug, including its full instructions and current revision.
  • skill_create
    Create a new ad-ops playbook (Skill) in your organization from an agent session.
  • skill_update
    Update an ad-ops playbook (Skill), guarded by base_revision so concurrent edits aren't clobbered.
  • skill_delete
    Delete an ad-ops playbook (Skill), guarded by base_revision.