AdsAgent Skill Pack (docs)
OfficialThis is a docs-only AdsAgent skill-pack MCP server for browsing public skill documentation and locating hosted ads MCP endpoints; it does not run ads or proxy Meta/Google/TikTok APIs.
list_skills: list public skills with IDs, descriptions, and first headings.get_skill: retrieve a skill’sSKILL.mdand optional skill-local reference Markdown files.get_hosted_mcp_urls: return hosted Meta, Google Ads, and TikTok MCP URLs requiring AdsAgent OAuth.get_pack_readme: return the pack version and README identity excerpt.Safety scope: reads local
skills/and repo docs only; rejects unknown skill IDs/path traversal and does not connect to ads platforms.
Provides tools for querying Google Ads customers, MCC, Search, PMax, and performance data via the Google Ads API, enabling insights and operational workflows.
Allows managing Meta advertising through tools for insights, ad copy, campaign creation, and performance analysis across connected Meta products.
Allows reading TikTok performance metrics and safely preparing native creative, campaign, and ad-group append workflows.
AdsAgent Tri-Channel Plugin
MCP here means Model Context Protocol (the Claude/Cursor tool-calling standard). It does not mean Multi-Channel Platform.
Public skill pack and plugin for AdsAgent tri-channel hosted MCP: Meta, Google Ads, and TikTok. It supports ChatGPT, Claude, Codex, and Cursor.
Directory SEO one-liner: AdsAgent is a hosted Meta Ads MCP (Model Context Protocol) plus Google Ads & TikTok MCP — connect Claude/Cursor via adsagent.md/connect.
Install:
Claude plugin:
claude plugin marketplace add adsagents/adsagent-ai-skillsthenclaude plugin install adsagent@adsagentCursor plugin: install AdsAgent from Cursor Marketplace (this repo's
.cursor-plugin/+mcp.json)Dashboard fallback: AdsAgent dashboard -> Settings -> MCP Access -> Copy install prompt (clients without plugin support)
Supported clients:
Client | How it uses this repo | Status |
Claude (Code, Desktop, Cowork) |
| Listed in the Claude plugin directory; also installable from this repo's marketplace |
ChatGPT | The same | Skills supported |
Codex | Plugin marketplace ( | Submitted |
Cursor |
| Current version listed on Cursor Directory and MCP Market |
Skills describe client-independent behavior. Install steps differ per client and live in Installation.
Distribution split (important):
Surface | What it is | This repo? |
Claude plugin (self-hosted marketplace) | Skills at | Yes |
Cursor plugin (marketplace manifest) | Skills + | Yes |
Anthropic Connectors Directory | Hosted MCP server listing only | No — separate submission on |
Official GitHub repo: github.com/adsagents/adsagent-ai-skills
Website: adsagent.md
Official links hub: adsagent.md/connect
Skill pack landing page: adsagent.md/skills
Support: support@adsagent.md
Privacy: AdsAgent Privacy Policy
Also listed on Product Hunt, Cursor Directory, and MCP Market.
Current contract version: 0.7.88. The plugin slug is adsagent (marketplace key adsagent).
Claude, Codex, Cursor, and Glama read this repository root. Skills live only in skills/. Marketplace source is ./. Cursor reads .cursor-plugin/plugin.json and root mcp.json. Glama builds from the root Dockerfile and root skills/.
For contributor cloud environments, provision uv in the image and run the
bundled bash scripts/cloud-agent-setup.sh; see
cloud setup. Plugin users do not run this setup.
New Meta connections default to the v2 product profile; all three hosted endpoints
negotiate modern MCP 2026-07-28 stateless discovery while retaining supported
legacy initialize clients.
Version history lives in CHANGELOG.md.
The local helper scripts/update_reminder.py compares strict semantic versions and stores only bounded version/timestamp state in ~/.cache/adsagent-ai-skills/update-reminder-v1.json. Pass --cache-dir to choose another directory. Cache failure never blocks MCP work.
What This Is
A public Claude plugin marketplace package: behavior skills in
skills/plus the hosted MCP URLs in.mcp.json. Directory review scans the whole repository.A behavior guide for Claude Code, Cursor, Codex, and other MCP-aware clients.
A reliability and safety layer that tells agents when to retry, when to wait, and when to stop.
A versioned GitHub distribution for AdsAgent user onboarding and agent behavior guidance.
A data-minimization contract for AI agents that should not scan AdsAgent like a raw database.
Optionally, a Glama-deployable AdsAgent Skill Pack (docs) stdio MCP that lists and reads public
skills/Markdown. See docs/glama-release.md.
Related MCP server: adkit
What This Is Not
Not the hosted AdsAgent Meta, Google Ads, or TikTok MCP backend. The optional Docker/Glama image only serves this repository's public docs; ads tools remain on the HTTP URLs in
mcp.jsonand require AdsAgent OAuth.Not the Anthropic Connectors Directory MCP listing (that is registered separately on the hosted servers).
Not a complete MCP tool reference.
Not an SDK.
Not a local transport relay for ads APIs.
Not a disclosure of AdsAgent backend routes, schemas, database tables, or internal diagnostics.
For Claude Code plugin installs, OAuth MCP setup comes from this repo's .mcp.json.
For clients without plugin support, the AdsAgent dashboard install prompt remains
the manual fallback:
AdsAgent dashboard -> Settings -> MCP Access -> Copy install promptUse that copied prompt only for a manual connection when the account exposes MCP Access. Installed Claude plugins already include the three URLs. The setup skill guides users from a missing connection through authorization to their original advertising task.
Connect After Installing
Start with the channel you need. Installing the skill pack does not authorize an advertising account, and a Meta task does not require Google or TikTok setup.
Client | Connect the requested channel |
Claude web, Desktop, or Cowork | Open Settings -> Connectors and use the installed AdsAgent connection's Connect action. If only skills were installed, add a custom connector using the hosted URL below. Complete browser OAuth. |
Claude Code | Open |
Cursor | Authenticate the requested bundled server in MCP settings. |
Other MCP clients | Add the requested hosted HTTP URL with OAuth, or use the account's dashboard install prompt. |
Channel | Hosted MCP URL |
Meta |
|
Google Ads |
|
TikTok |
|
Then ask: "Check my Google Ads connection and help me finish any missing authorization, then show yesterday's campaign performance." Substitute your channel and task. AdsAgent checks that channel, supplies a browser link when needed, waits for you to finish, and resumes the same task. For a connection check alone, it reports the result without starting a report.
Each server has its own OAuth authorization. Use the same AdsAgent login in the browser and client; never copy an OAuth token between the three URLs.
For multiple OAuth tenants on one server, each workflow retains its selected connection through approval, confirmation, task queries and retries. Selection uses an explicit account choice, uniquely verified object ownership, or the sole available connection; ambiguous choices need one account question. See multi-tenant routing for the installed policy and optional client-adapter dispatch guard.
Platform authorization and initial asset/history sync are separate steps; "connected" does not mean history is loaded or ads are ready to launch.
Claude connection controls are documented in the official custom connector guide and Claude Code MCP guide.
Official MCP Registry manifests
Three hosted-server manifests record the existing md.adsagent/* entries in the
official MCP Registry, first published on 2026-08-18.
Version 1.0.0 was verified active/latest on 2026-10-09; these files are snapshots,
not pending publications. GitHub first-time directory inclusion remains under
manual review. The public skills, guides and connection configurations are MIT;
the hosted advertising backends are proprietary.
Included Skills
Skill | Purpose |
| Route AdsAgent requests to setup, reliability, approvals, insights, create, or manage workflows. |
| Connect the requested MCP, complete platform authorization, verify usable account scope, and resume the original task. |
| Inspect alerts, request an alert refresh, and explain supported MCP Events or retired integrations. |
| Shared prepare, approval, and confirm rules: |
| Respect retry, backoff, session refresh, and concurrency limits. |
| Run a user-requested deep diagnosis (account health check) across channels, explain the structured report, and route its recommendations through prepare and approval. |
| Design, create, verify, update, pause, and delete agent-owned scheduled tasks without confusing reminders with execution proof. |
| Ask performance and MMP questions without overloading the server. |
| Create, copy, and change Meta campaigns, ad sets, and ads (unified update, ad copy read and edit) with confirmation and operator-review safety. |
| Ask Google Ads customer, MCC, Search, PMax, and performance questions through Google Ads MCP. |
| Create Google Ads campaigns (Search, PMax, Display, Shopping, Demand Gen, App); location and language are required; real writes only on test accounts in test flows. |
| Change existing Google Ads budgets, bidding, status, schedules, ad text, assets, conversions, experiments, and recommendations through prepare and confirm. |
| Read TikTok performance and safely prepare native creative, campaign, and ad-group append workflows. |
Progressive Disclosure
Agent clients load every Skill description for discovery, but should load only
the selected SKILL.md body. Each entrypoint is intentionally small and links
to local reference files that are read only when the selected workflow needs
those details.
The files under docs/ are human-facing product and operator documentation.
They are not automatic agent context and are not part of Skill reference
traversal. Agent behavior contracts live under skills/ and are reached from
the selected SKILL.md.
Agent Output Contract
Agents using AdsAgent should answer in Markdown by default:
## Answer
One-sentence answer.
## Scope
- Date:
- Entity:
- Grouping:
- Attribution / channel:
## Results
| Metric | Value |
| --- | ---: |
## Notes
- Data freshness:
- Limits or missing fields:
- Next safe action:Do not dump JSON, CSV, hidden diagnostics, raw rows, or every returned field into chat. Clean the response into operator-facing tables and short bullets. If forensic raw inspection is needed, create an operator handoff instead of making raw rows the agent answer.
Semi-Black-Box Policy
Tool names are public. This repository intentionally documents outcomes and agent behavior, not the complete internal interface: no schemas, descriptions, or risk-control limits. Agents should:
Use installed skills for behavior and live MCP tool schemas for request fields. Never fetch remote behavioral instructions.
Use available tools through the authenticated MCP session.
Avoid guessing hidden payload fields.
Avoid probing rejected requests.
Stop on operator-review responses and ask the AdsAgent operator to inspect internal diagnostics.
Use the smallest safe data plan before making calls.
Prefer grouped summaries and cleaned breakdowns over raw rows.
The external agent contract is: ask clear questions, respect limits, follow advertised approval requirements, and use client OAuth plus returned platform authorization links.
Official Source And Rights
This repository contains only the client-readable behavior pack. AdsAgent server source, credentials, schemas, routing logic, and operational diagnostics are not distributed here.
This skill pack is licensed under the MIT License. See LICENSE and NOTICE.md. Official releases come from this repository; a fork or modified package must not imply endorsement, affiliation, or support by adsagents LLC.
Privacy and workflow effects
The AdsAgent Privacy Policy describes the hosted service's data collection, use, retention, and support process. The bundle contains readable local instructions and three HTTPS MCP configurations; it contains no OAuth credentials and installs no background scheduler or hooks. Authenticate through the MCP client's OAuth flow. Send only parameters needed for the user's selected advertising task. Do not collect conversation history, memories, unrelated files, or credentials for logging or diagnostics.
Google Ads guidance covers reads. Meta and TikTok capabilities vary by account and advertised tool. Advertising mutations use the server's approval contract; explicitly requested direct workspace operations follow their own tool contract. Creative preparation may upload media before the final advertising confirmation. An authorized notification scan changes alerts and may generate MCP Events for existing subscriptions. Current Meta no longer configures email, Feishu, Telegram, or Meta Ads Webhooks through this pack. Scheduled workflows use an available host scheduler and require user intent.
Example Prompts
Use AdsAgent to list my connected Meta products, Google Ads customers, or TikTok advertisers, then ask which scope's today data I want to inspect.For Google Ads, inspect agent_method_profile, pick an enabled non-manager customer, and use one cached insights_query_consistent request when the profile is advertised.For TikTok, inspect agent_method_profile and use one insights_query_consistent scopes request when advertised; otherwise use the native batch overview fallback.Prepare a copy of this winning Meta ad into the target account, but ask me for confirmation before creating anything.Group these distinct Meta Ads by language into the requested Campaign and AdSet layout. Prepare one grouped_plan, show every settings_source_ad_id and geography override, and wait for my approval before confirming once.More examples are in docs/examples.md.
Validation
Run the local release contract and tests:
python scripts/validate_tri_channel_pack.py
python -m pytest -qBefore merging a release head, publish the git tag and GitHub release for
that head's tree, then run bin/check-skillpack-release-tag in
adsagent-ops with this clone and the head. The check passes only when the
tag named in release-manifest.json is already published and the tag's
tree is the same as the head. Sync clients fetch that tagged manifest, so
a head that names an unpublished tag must not be merged. This repository
does not contact GitHub.
The blocking checks are offline: skill structure, the tool reference contract
(contracts/public-tool-references.json), and the list of deprecated tools
(contracts/deprecated-tools.json), which skills and docs must not mention.
python scripts/validate_public_tool_manifests.pyWhether the skills still match the services is compared outside this repository. That comparison only warns and does not block a merge or a release.
Installation
This repo ships as the adsagent Claude plugin (skills + .mcp.json MCP URLs).
The GitHub repository name stays adsagent-ai-skills.
Claude Code (recommended)
claude plugin marketplace add adsagents/adsagent-ai-skills
claude plugin install adsagent@adsagentUpdate an existing user-scope install:
claude plugin update --scope user adsagent@adsagentIf claude plugin list shows duplicate local and user installs, keep user scope:
claude plugin uninstall --scope local adsagent@adsagentStart a fresh Claude Code session after installing or updating.
Cloud / Cowork preinstall (settings snippet)
{
"extraKnownMarketplaces": {
"adsagent": {
"source": {
"source": "github",
"repo": "adsagents/adsagent-ai-skills"
}
}
},
"enabledPlugins": ["adsagent@adsagent"]
}After install, authenticate only the MCP servers needed for your task. In
Claude Code use /mcp; in Claude web/Desktop or Cowork use Settings -> Connectors.
Do not add headers.Authorization to .mcp.json; OAuth must remain the auth path.
Migrating from legacy plugin slugs
Older installs used adsagent-ai-skills@adsagent-ai-skills or
adsagent-meta-ai-skills@adsagent-meta-ai-skills. The marketplace declares a
rename to adsagent@adsagent. After migrating, remove legacy duplicates:
claude plugin uninstall --scope user adsagent-ai-skills@adsagent-ai-skills
claude plugin uninstall --scope user adsagent-meta-ai-skills@adsagent-meta-ai-skillsCodex CLI
codex plugin marketplace add adsagents/adsagent-ai-skills
codex plugin add adsagent@adsagentRefresh:
codex plugin marketplace upgrade adsagentStart a fresh Codex session after installing or upgrading.
Git fallback and other Agent-Skills-compatible clients
The skills in skills/ use the standard Agent Skills layout
(skills/<name>/SKILL.md with YAML frontmatter). Clients that only consume skills
(without the plugin MCP bundle) can clone manually:
git clone https://github.com/adsagents/adsagent-ai-skills.git ~/.codex/skills/adsagent-ai-skillsThose clients still need a separate MCP connection (dashboard install prompt or Connectors Directory). The plugin path is the one-step skills + MCP bundle.
For a manual client, use hosted OAuth or, when available to your account, AdsAgent's dashboard install prompt:
Settings -> MCP Access -> Copy install promptPaste the copied prompt into a fresh chat when the plugin bundle is not used. The prompt provides hosted HTTP MCP URLs for:
Meta default: https://adsagent.md/mcp/v2
Meta legacy fallback: https://adsagent.md/mcp
Google Ads: https://google.adsagent.md/mcp
TikTok: https://tiktok.adsagent.md/mcpImportant Runtime Rules
Hosted HTTP MCP only for ads work.
Use
https://adsagent.md/mcp/v2for new Meta connections;/mcpis the legacy fallback.Do not run or relay the hosted AdsAgent ads MCP locally. The optional
skill_pack_mcpimage is a docs-only reader of this repository; it is not an ads backend.Do not use a local relay unless the AdsAgent dashboard explicitly says to.
Cache connection setup where the client supports it.
Keep per-token MCP concurrency bounded.
Respect
Retry-After.Parse
Retry-Afterfrom the HTTP header, top-leveldata, or JSON-RPCerror.data.Honor
mcp_concurrency_limitedwith wait plus jitter.Honor
mcp_fanout_detectedby switching to the platform batch overview tool instead of retrying the blocked single-scope request.When
agent_method_profile.profile_id=adsagent_agent_methods_v1and its consistent read is present in the client-local catalog, use oneinsights_query_consistentrequest withscopeor orderedscopesfor all three platforms.Without that profile, or when its advertised read is missing only from the client-local catalog, use the profile's named native fallback or the documented server-side tools: Meta/TikTok
insights_query_batch_overview, Googlegoogle_ads_insights_overview_batch. Do not report a server registration failure from a local selector miss.Query aggregated data first and never infer cross-platform capability parity from a shared tool name.
Report server-computed totals from the response; do not sum currently visible rows.
Trust totals only when
meta.complete=true; missing scopes are unknown, never zero.Poll queued tasks to
terminal=trueand return the artifact link instead of raw CSV.Poll queued work directly with
tasks_get_status(task_ref=...)when the server advertises direct task refs.QuickCreate confirm tokens are single-use and expire after 15 minutes. Check
expires_at; afterconfirm_token_invalid, prepare again, show the new summary, and obtain fresh explicit approval.Poll Meta creation tasks with
tasks_get_status(task_ref=..., response_mode=compact). Onno_create_permission, direct the user to/dashboard/assets/fb-users; never change customer permissions or replay the failed creation automatically.Avoid raw-row reads in normal user conversations.
Use Markdown tables for numbers.
Confirm before ad creation or modification.
Use
grouped_planfor multiple distinct source Ads; never emulate it through a client-side series of copy mutations.Stop on operator-review errors.
When an error includes
support_ref, preserve and show it verbatim for support. It is not authorization; never invent, modify, enumerate, or replace it with tokens, request bodies, or logs.
Links
Official website: https://adsagent.md
Official repository: https://github.com/adsagents/adsagent-ai-skills
Support: support@adsagent.md
Public onboarding path: https://adsagent.md/docs/mcp-onboarding
Glama / Docker docs MCP
The root Dockerfile builds AdsAgent Skill Pack (docs) — a stdio MCP that
exposes list_skills, get_skill, get_hosted_mcp_urls, and get_pack_readme.
The image command is python -m skill_pack_mcp --root /app. Without --root,
the server uses the directory that contains the skill_pack_mcp package.
glama.json only names maintainers; Glama starts the Dockerfile command.
Glama Build → Make Release scores that docs server. It does not replace
https://adsagent.md/mcp/v2, https://google.adsagent.md/mcp, or
https://tiktok.adsagent.md/mcp. Details: docs/glama-release.md.
License
MIT. See LICENSE.
Available Tools
4 toolsget_hosted_mcp_urlsA
Return AdsAgent hosted HTTP MCP URLs from this repo's mcp.json.
Use this when a client needs the real Meta, Google Ads, or TikTok ads MCP endpoints. Those services require AdsAgent OAuth on the hosted URLs.
This docs server does not implement ads tools, does not accept tokens, and does not proxy those endpoints. Copy the https URLs into an MCP client and authenticate against AdsAgent hosted services.
Inputs: no named parameters.
get_pack_readmeA
Return this skill-pack VERSION and a README.md identity excerpt.
Use this to confirm pack version and the public 'what this is / is not' wording, including that a Glama or Docker image of this repo is not the hosted AdsAgent ads backend.
The excerpt stops before the per-skill table. It does not include secrets.
Inputs: no named parameters.
get_skillA
Return one skill's SKILL.md and optional named reference files.
Use this after list_skills when you need the full public instructions for a single skill. Pass references only for Markdown files that live in that skill folder (progressive-disclosure contracts).
Rejects unknown skill ids and any path that leaves the skill directory. This is documentation retrieval, not a live ads API.
Inputs: skill_id (required), references.
list_skillsA
List public AdsAgent skills shipped in this repository.
Use this first when you need a catalog of documentation skills (router, setup, reliability, notifications, scheduled tasks, Meta, Google Ads, TikTok) before opening a specific SKILL.md.
Returns each skill id, YAML frontmatter description, and first Markdown heading. This tool only reads local files under skills/. It does not connect to Meta, Google Ads, or TikTok and does not run campaigns.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clear, distinct responsibility: list_skills catalogs available skills, get_skill retrieves a specific skill's documentation, get_pack_readme returns pack identity/version, and get_hosted_mcp_urls exposes hosted endpoint URLs. There is no meaningful overlap or ambiguity between them.
Tool names follow a predictable verb_noun pattern: get_* for single-item retrieval and list_skills for collection retrieval. The naming is consistent, descriptive, and easy to infer.
Four tools is well-scoped for a documentation/skill-pack server. Each tool earns its place and covers a necessary retrieval function without unnecessary bloat.
The tool surface covers the full documentation workflow: discover available skills, fetch individual skill details, confirm pack identity/version, and retrieve hosted MCP URLs. There are no obvious dead ends for the stated documentation-only purpose.
Maintenance
Related MCP Connectors
Analyze, edit and launch Meta (Facebook and Instagram) ads from Claude, ChatGPT, Cursor or Codex. Query insights and campaign health, change budgets, bids, status and targeting with undo, bulk-launch many ads across campaigns and ad sets from a live ad's settings, and duplicate by post to keep social proof. Choose per ad account what the agent may do and what waits in the Agent Inbox for approval. Requires a paid Ads Uploader account with MCP access.
Run Meta, Google, TikTok, LinkedIn, Microsoft, Reddit, X and Pinterest ads from your AI agent.
Hosted Google Ads MCP for Claude and ChatGPT. Preview every write. No developer token.
Open-source ad agent for LinkedIn Ads and Google Ads. Drafts campaigns, audiences and reports.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for AI agents to manage ad campaigns across Google, Meta, LinkedIn, Microsoft, Reddit, TikTok, and more21618 npm21MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to create, manage, and automate Meta (Facebook/Instagram) ads campaigns via the Marketing API, with safe defaults and AI-generated creative.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI clients to read Meta Ads performance with breakdowns and diagnostics and to create, update, or pause campaigns, ad sets, ads, creatives, audiences, and catalogs, with every write requiring explicit user approval. Runs as a hosted, OAuth-authenticated remote server with no local install.1MIT
- AlicenseCqualityBmaintenanceEnables any MCP-compatible AI client to manage Reddit Ads accounts through the Reddit Ads API v3, creating, updating, deleting and reporting on campaigns, ad groups, ads, creatives, targeting, audiences, catalogs and conversions. It handles browser-based OAuth login, pagination, token refresh and rate-limit backoff automatically.11417 npm2MIT