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, LinkedIn, and Reddit 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 — create, edit, and publish campaigns, ad sets, ads, keywords, audiences, and Google conversion uploads. 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. Google conversions upload sends event rows directly and uses validateOnly:true for dry runs. 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

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

Launch browser-based AdKit setup flows. Requires projectId from adkit_projects. Returns dashboard URLs the user can open.

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, LinkedIn, and Microsoft, plus drafts), "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

Beta. Upload one file to Meta, Google, TikTok, LinkedIn, X, or Studio from a host-provided attachment, public HTTPS URL, or completed temporary upload. X currently supports JPEG and PNG images. When no attachment or public URL exists, a requested upload URL fills the same role. Base64 payloads and local file paths are not accepted. Report upload failures with adkit_feedback.

adkit_upload_file