AdsGPT

AdsGPT for AI clients

Create, review and optimize ad campaigns from your AI client on the ad platforms your organization connected to AdsGPT, such as Google Ads. This package adds two things to Claude, Codex and Grok:

• The AdsGPT MCP server, which reads and changes your ad accounts with your AdsGPT account.
• The AdsGPT skills, the instructions that guide the model through each task: how to create a campaign with the platform's creation tool, how to write ads within each format's limits, how to review and optimize spend, and the rules of each platform and campaign type.

The MCP server works without the skills; the skills make the model ask the right questions and get each campaign right at the first attempt.

You need an AdsGPT account with an ad account connected. A new campaign is created paused unless you ask otherwise, and every tool that changes something says so, so your client can ask for your approval before it runs.

Install

Claude Code

/plugin marketplace add adsgpt-dev/agent-plugins
/plugin install adsgpt@adsgpt

Then run /mcp, choose plugin:adsgpt:adsgpt and sign in with your AdsGPT account.

Claude (web and desktop)

In Customize > Plugins, add the marketplace adsgpt-dev/agent-plugins and install AdsGPT. Then connect the AdsGPT server from the plugin's Connectors tab and sign in.

Codex and the ChatGPT desktop app

codex plugin marketplace add adsgpt-dev/agent-plugins

Then open /plugins in Codex, or the plugins of the ChatGPT desktop app, install AdsGPT from adsgpt and start a new session. Sign in with your AdsGPT account when the client asks.

Grok

Add the marketplace adsgpt-dev/agent-plugins and install adsgpt from adsgpt. Grok signs in with your AdsGPT account on first use.

What it runs, sends and reads

• On your machine, nothing. The package has no scripts, hooks, commands or binaries: only the skills, which are Markdown the model reads, the manifest of each client and the address of the MCP server. The skills bring no instructions from anywhere else.
• One remote server, https://mcp.adsgpt.dev, over HTTPS (.mcp.json). Your client signs in with OAuth 2.1 and keeps the token; it asks for ads:read and, the first time a tool changes something, for ads:write.
• What reaches the server: the calls your client's model makes to its tools, with their inputs, such as an account id, the report and period you ask for, a new campaign with its budget, targeting and ads, ad texts, image URLs, YouTube links or a landing page URL. Never your conversation.
• What the server does with them: it reads and changes the ad accounts your organization connected to AdsGPT, through each platform's API, and keeps a log of every change in your AdsGPT organization. It downloads the images you give by URL to check them and uploads to the ad account those it lacks, and opens each landing page a change sends, to check that it works.

The privacy policy says what AdsGPT stores and shares.

Tools

Tool	What it does	Changes something
list_accounts	Lists the connected ad accounts and the platforms you can connect.	No
google_ads_report	Reports an account's performance, budgets, recommendations, policy issues and changes.	No
google_ads_compare_periods	Compares a period with the one before, with what moved the most and the changes made.	No
google_ads_get_campaign	Reads a campaign with the sections a change needs, from its structure to its targeting.	No
google_ads_get_ads	Reads ads with their texts, images and Google's approval.	No
google_ads_list_assets	Lists the images and videos of an account.	No
google_ads_list_negative_keyword_lists	Lists the shared negative keyword lists of an account.	No
google_ads_research_keywords	Finds keyword ideas with their monthly searches and bids, from words or a page.	No
google_ads_forecast_keywords	Forecasts the clicks, cost and conversions of keywords for a bid and a budget.	No
google_ads_search_targeting	Finds locations, languages, interests, audiences and topics by name.	No
google_ads_create_campaign	Creates a campaign of any type with its budget, targeting and ads, paused unless you ask otherwise.	Yes
google_ads_create_ad_group	Creates an ad group with its first ad and, on Search, its keywords.	Yes
google_ads_create_ad	Creates an ad in an ad group.	Yes
google_ads_create_asset_group	Creates a Performance Max asset group.	Yes
google_ads_create_conversion_action	Creates a conversion action.	Yes
google_ads_create_negative_keyword_list	Creates a shared negative keyword list, optionally applied to campaigns.	Yes
google_ads_upload_images	Uploads images to an account's library.	Yes
google_ads_add_keywords	Adds keywords to an ad group.	Yes
google_ads_add_negative_keywords	Adds negative keywords to a campaign or a shared list.	Yes
google_ads_attach_negative_keyword_list	Applies a shared negative keyword list to campaigns.	Yes
google_ads_add_extensions	Adds sitelinks, callouts, snippets, a phone, the business name or a logo.	Yes
google_ads_add_targeting	Adds locations, languages, audiences and other targeting.	Yes
google_ads_set_targeting	Replaces a campaign's ad schedule or device bid adjustments, or an ad group's demographics.	Yes
google_ads_add_labels	Adds labels to campaigns, ad groups or ads.	Yes
google_ads_update_budget	Changes a campaign's budget.	Yes
google_ads_update_status	Pauses or enables campaigns, ad groups, asset groups, ads, keywords or extensions.	Yes
google_ads_update_bid_strategy	Changes a campaign's bid strategy and its target.	Yes
google_ads_update_campaign_settings	Changes a campaign's name, dates, networks, tracking, conversion goals and other settings.	Yes
google_ads_update_ad_group	Changes an ad group's name, bid, rotation, tracking or audience.	Yes
google_ads_update_ad	Changes a search ad's texts or landing page.	Yes
google_ads_update_asset_group	Changes a Performance Max asset group's assets, landing page or audience signal.	Yes
google_ads_update_keywords	Changes keywords' bids or landing pages.	Yes
google_ads_update_conversion_action	Changes a conversion action's name, category, counting, value or status.	Yes
google_ads_apply_recommendations	Applies Google's recommendations.	Yes
google_ads_dismiss_recommendations	Dismisses Google's recommendations.	Yes
google_ads_remove_keywords	Removes keywords.	Yes
google_ads_remove_negative_keywords	Removes negative keywords.	Yes
google_ads_remove_extensions	Unlinks extensions; their assets stay in the library.	Yes
google_ads_remove_targeting	Removes locations, audiences and other targeting.	Yes
google_ads_remove_labels	Removes labels.	Yes
google_ads_remove_campaigns_groups_or_ads	Removes campaigns, ad groups, asset groups or ads for good.	Yes

The google_ads_* tools appear only when your organization connected Google Ads.

Skills

Skill	What it covers
adsgpt-agent	The rules of any request about your ad accounts.
adsgpt-create-campaign	Creating a campaign, from the objective to the campaign created.
adsgpt-google-ads	Google Ads: its tools, reports, objectives and campaign types.
adsgpt-write-ads	Writing ad copy from the brand's facts, within each format's limits.
adsgpt-optimize	Reviewing performance and improving spend.

About this folder

AdsGPT publishes this plugin from its own repository: the skills here are a copy, replaced on each release. Report problems in the issues of adsgpt-dev/agent-plugins.

License

MIT (LICENSE).