AdKit - Ads Manager

Browse 500k+ ads from over 1000 advertisers across Meta, Google, and LinkedIn. Discover proven ads, research competitors, and add new advertisers to track. Covers the public ad library only; the user's own campaigns live in adkit_manage.

adkit_library

AI ad generation workspace. Create ad briefs, generate images (create/clone/resize/edit), list ad media, inspect media items, and share briefs. Use entity "ads" + action "generate" to generate images. Omit id to auto-create an ad, or provide id to add variants to an existing ad. To use a user's own photo as a clone/edit reference: entity:"media" action:"request_upload_url" → PUT file bytes → pass { type:"temporary_upload", id:<uploadId> } in generate references. Has no live campaign data, spend, or performance reporting; that data lives in adkit_manage. Studio ads are creative drafts, not launched ads.

adkit_studio

Manage AND report on Meta, Google, TikTok, Reddit, X, LinkedIn, Microsoft, and ChatGPT Ads. Reporting & analytics — campaign performance, results, spend, ROAS, impressions, clicks, conversions, CPC/CPA: use entity:"results" (Google also supports action:"placements" and "search-terms"). Answers "how are my ads doing" / "what's my spend" / "show campaign performance". Management — connect project accounts and create, edit, or publish supported ad resources. ChatGPT Ads supports normalized account assignment; its advertiser operations use entity:"platform-api-request". Coverage differs per platform — the exact entities, actions, and params for each platform are documented under adkit_help({ path: "manage <platform>" }). Most mutations create drafts by default; publish:true sends changes live and requires explicit user approval. Use AdKit field names in params (not raw platform fields); pass full request bodies as top-level data. Use platformOverrides for raw fields on supported resources. Unsupported native platform resources and workflows are reachable via the raw platform API: entity:"platform-api-request" action:"mutate" (project opt-in); adkit_feedback is the channel for reporting these AdKit gaps. File uploads: entity:"media" action:"request_upload_url" → PUT the bytes → reference the returned uploadId. For creatives/variants/images inside an ad set, use entity:"ads".

adkit_manage

Read connected Google Analytics 4 properties and run native read-only reports. For actions and report fields, call adkit_help({ path: "integrations ga4" }).

adkit_integrations

Onboarding only. Records that this agent successfully used AdKit after setup. Intended solely for setup and connection verification, at the user's explicit request.

adkit_checkin

Return project context, connected platforms, assigned ad accounts, and Studio setup. Requires projectId from adkit_projects.

adkit_status

List or create the user's AdKit projects. Returns the projectId that most other AdKit tools (manage, library, studio, status, setup) require as input. List results include the user's accessible workspaces.

adkit_projects

Report an AdKit bug, confusing behavior, missing capability, or product feedback. Fire-and-forget: it never blocks the user's task. Fields, filled with whatever is known: - intent: what the user was trying to accomplish. - error: the exact error text, code, or HTTP status. - context: {"toolPath": "adkit_manage meta campaigns create", "platform": "meta", "accountId": "..."}. Do not include secrets, tokens, request/response bodies, uploaded files, or personal data.

adkit_feedback

Use when the user wants to connect an ad platform (Meta, Google Ads, ...). Returns the link they open to sign in and pick an ad account. Requires projectId from adkit_projects.

adkit_setup

Discover the AdKit MCP contract with progressive drill-down. Top-level paths: "manage" (campaigns, accounts, and reporting across Meta, Google, TikTok, Reddit, X, and LinkedIn, plus Microsoft and ChatGPT Ads raw access and drafts), "integrations" (read-only GA4 data), "library" (browse ads, advertisers, and inspiration boards), and "studio" (AI static ad generation). Start with adkit_help() for the root overview, or drill down like adkit_help({ path: "manage google campaigns create" }). A keyword search with q, e.g. adkit_help({ q: "keyword planner" }) → "manage google research keywords", covers the full command catalog: a capability missing from one drill-down path may still exist under another.

adkit_help