AdsAgent

io.github.nowork-studioPublished by GitHub account nowork-studiov0.2.23Updated Nov 2, 2026

Google Ads analysis and operations — read performance, manage keywords, bids, and campaigns.

The publisher's own server: AdsAgent — Google Ads MCP

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Remote OAuth-connected MCP server for Google Ads work: read campaign performance and manage keywords, bids, budgets and campaigns.

What you can do
  • Review Google Ads campaign performance, search terms and change history
  • Manage supported keywords, bids, budgets, negatives and campaigns
  • Audit account health, validate tracking and find wasted spend
  • Write RSA copy and plan sitelinks, callouts and other assets
  • Diagnose keyword-to-ad-to-landing-page relevance
When to use it
Useful when you want an assistant to audit a Google Ads account, explain where spend is being wasted, or make approved changes to keywords, bids and budgets without leaving the chat.
Requirements
A remote endpoint at adsagent.org over streamable HTTP, with OAuth sign-in required. No environment variables or headers are declared. Accounts become available after connecting them in the workspace selected during OAuth.
Before you install
The server can change live ad accounts, including bids, budgets, keywords and campaigns, so review proposed changes before approving them. OAuth grants access to connected advertising accounts, and tool arguments and results pass through the hosted service. Connect only the accounts you intend to use.

Installation

In SourceWeft

  1. Open AdsAgent in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.nowork-studio%2Fadsagent/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "adsagent": {
      "type": "http",
      "url": "https://adsagent.org/api/mcp"
    }
  }
}

README

NotFair Plugin

[License: MIT] [Discord]

Open-source SEO, GEO, and marketing skills for AI agents.

The NotFair Plugin gives Claude Code, Codex, Hermes, and other compatible agents practical marketing workflows they can follow—not another generic prompt collection. Use it to audit a site, investigate a traffic drop, analyze GA4 and Search Console, find wasted ad spend across Google, Meta, X, LinkedIn, Reddit, and TikTok, operate connected WordPress and GoHighLevel accounts, build campaign plans, and make reviewable changes.

Each skill has one discoverable skills/<name>/SKILL.md entry point. It loads a readable WORKFLOW.md in the category folder, with supporting references, scripts, and evals where needed. Inspect it, adapt it, or contribute a better workflow.

What your agent can do

AreaExamples
SEOFull-site and page audits, keyword research, content planning, technical SEO, schema, local SEO, international SEO, e-commerce SEO, and regression monitoring
GEO / AEOImprove content for citation and visibility in ChatGPT, Perplexity, Gemini, Claude, and Google AI Overviews
Paid mediaPlan, review, and optimize cross-channel campaigns with explicit budgets, measurement, and approval boundaries
Google AdsAudit accounts, analyze search terms, manage keywords and budgets, write RSA copy, plan assets, and diagnose landing pages
Meta AdsReview Facebook and Instagram performance, diagnose creative fatigue, assess audiences, and create evidence-based creative briefs
X AdsAnalyze campaigns and line items, review conversion performance, manage targeting and creative, and execute approved changes
LinkedIn AdsConnect B2B media to lead quality, analyze campaign groups and campaigns, and manage targeting, creative, conversions, and leads
Reddit AdsAnalyze campaigns, ad groups, and ads, review conversions and audiences, and execute approved Reddit Ads changes
TikTok AdsAnalyze connected TikTok advertisers, review delivery and creative performance, and execute approved campaign changes
WordPressRead and update connected WordPress content, media, comments, design, settings, plugins, and approved site changes
GoHighLevelRead contacts, conversations, opportunities, and calendars, then make only explicitly requested CRM changes
AnalyticsQuery live GA4 and Search Console data, compare complete periods, inspect URLs, manage sitemaps, and update supported measurement configuration
ContentTurn search demand into editorial plans, briefs, articles, landing pages, metadata, and structured data

The NotFair Plugin currently ships 48 skills across SEO, GEO, paid media, advertising platforms, analytics, WordPress, CRM, and cross-model review.

Quick start

Claude Code

Install the NotFair plugin from its marketplace:

text
/plugin marketplace add nowork-studio/notfair-plugin/plugin install notfair@nowork-studio

Then ask for the workflow you need:

text
/notfair:seo-analysis/notfair:geo-optimizer/notfair:google-ads-audit/notfair:meta-ads-creative/notfair:paid-ads-x/notfair:google-analytics/notfair:search-console

You can also use plain language:

Audit my site and tell me why organic traffic fell.

Find pages that could earn citations in AI answers.

Review last month's ad spend and show me the safest opportunities to improve ROAS.

Cursor

Install NotFair from Cursor's plugin marketplace. The plugin loads the open-source marketing skills in this repository and registers one hosted NotFair MCP connection. Complete the browser OAuth flow when Cursor prompts you, then ask Cursor to audit an ad account, analyze GA4 or Search Console, or run one of the SEO and GEO workflows listed below.

For local testing before the marketplace listing is available, clone this repository into Cursor's local plugin directory:

bash
git clone https://github.com/nowork-studio/notfair-plugin.git ~/.cursor/plugins/local/notfair

Restart Cursor after installing or updating the local plugin.

Kiro Powers

Install the public repository as a custom power from Kiro's Powers panel, or find NotFair in the Powers registry after its listing is approved. The root plugin.json and mcp.json follow the Agent Plugins 1.0 specification.

Gemini CLI

Install the extension directly from GitHub:

bash
gemini extensions install https://github.com/nowork-studio/notfair-plugin

The extension loads the repository guidance and the universal NotFair MCP. Run /mcp auth NotFair in Gemini CLI when authentication is requested.

Codex, Hermes, and other agents

Install the universal NotFair plugin directly through Codex:

bash
codex plugin marketplace add nowork-studio/notfair-plugin --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair

Codex installs the skills, registers one NotFair MCP connection, and opens its OAuth flow. If you prefer a workspace-local checkout, clone the repository and open it as a workspace; AGENTS.md maps marketing requests to the right skill.

bash
git clone https://github.com/nowork-studio/notfair-plugin.gitcd notfair-plugin

If the nowork-studio marketplace is already configured, refresh it instead:

bash
codex plugin marketplace upgrade nowork-studio --json && codex plugin add notfair@nowork-studio --json && codex mcp login NotFair

For host-specific setup, give your agent INSTALL_FOR_AGENTS.md, or paste:

text
Retrieve and follow the instructions at:https://raw.githubusercontent.com/nowork-studio/notfair-plugin/main/INSTALL_FOR_AGENTS.md

Guides and comparisons

Background reading on connecting ad accounts to AI agents and choosing a setup:

Why skills instead of one giant marketing agent?

Marketing work gets unreliable when every request goes through the same vague prompt. The NotFair Plugin splits the work into focused, testable procedures.

  • Specialized: each skill has a defined job, required inputs, decision rules, and output format.
  • Evidence-led: live-data workflows use Search Console, Google Analytics, Google Ads, Meta Ads, X Ads, LinkedIn Ads, Reddit Ads, TikTok Ads, WordPress, or GoHighLevel instead of guessing from generic best practices.
  • Safe by design: read-only review comes before mutation, paid-media changes stay explicit, and unsupported capabilities are never implied.
  • Host-agnostic: the canonical skills are plain files, not logic trapped inside one agent runtime.
  • Forkable: everything is MIT licensed, so teams can review and adapt the workflows to their own standards.

Skill catalog

SEO and GEO

SkillWhat it does
seo-analysisAudits a full site with Search Console and crawl data, then prioritizes the highest-impact fixes.
seo-pagePerforms a deep audit of one URL for intent, content, structure, and on-page SEO.
content-writerWrites or improves search-led articles, landing pages, and service pages.
content-plannerTurns Search Console opportunities into a prioritized, dated editorial calendar.
keyword-researchBuilds a keyword universe, classifies intent, and organizes topic clusters.
meta-tags-optimizerImproves titles, meta descriptions, Open Graph tags, and SERP click-through potential.
schema-markup-generatorCreates and validates JSON-LD structured data.
broken-link-checkerFinds broken internal and external links and reports site-health issues.
geo-optimizerAudits and rewrites content for citation in AI search and answer engines.
local-seoReviews Google Business Profile, local pages, NAP consistency, reviews, and local schema.
hreflang-internationalDiagnoses hreflang, canonical, language, and regional targeting problems.
sitemap-auditChecks XML sitemap structure, freshness, coverage, and URL validity.
image-seoReviews alt text, formats, compression, responsive images, CLS, and image discovery.
ecommerce-seoAudits product pages, category pages, variants, faceted navigation, and product schema.
programmatic-seoPlans useful templated pages at scale with demand, uniqueness, and indexation guardrails.
competitor-pagesCompares ranking pages and produces a practical SERP brief.
sxoConnects search visibility and SERP CTR to the post-click conversion experience.
seo-driftCreates a baseline and detects ranking, metadata, canonical, and indexation regressions.
backlink-auditReviews referring domains, anchor text, link risk, and internal-link opportunities.
setup-cmsLocal Application-Password / .env.local setup for SEO scripts against WordPress, Strapi, Contentful, or Ghost.

Paid media

SkillWhat it does
paid-adsRoutes broad paid-media questions to the right channel and workflow.
paid-ads-setupConnects accounts and captures business, economics, tracking, and budget context.
paid-ads-launchProduces a reviewable campaign or multi-channel experiment plan before spend begins.
paid-ads-reviewCreates comparable weekly or monthly scorecards and checks tracking health.
paid-ads-optimizeFinds waste and pacing problems, then proposes narrow, reversible changes.
paid-ads-creativeDevelops cross-channel concepts, claim ledgers, fatigue hypotheses, and test briefs.
paid-ads-xAudits and operates connected X Ads campaigns, line items, targeting, creative, audiences, and budgets.
paid-ads-linkedinAudits and operates connected LinkedIn Ads around qualified pipeline outcomes.
paid-ads-redditAudits and operates connected Reddit Ads campaigns, ad groups, ads, audiences, pixels, and budgets.
paid-ads-tiktokAudits and operates connected TikTok Ads delivery, creative, targeting, and budgets.
paid-ads-amazonPlans and reviews Amazon Ads with margin-aware ACoS guardrails.
paid-ads-chatgptDesigns bounded ChatGPT Ads experiments or reviews verified exports.
paid-ads-integrationsVerifies connector, account, and tool access before promising a capability.
paid-ads-guideExplains installation, supported platforms, limits, and troubleshooting.

Google Ads

SkillWhat it does
google-ads-auditScores account health, validates tracking, and finds wasted spend.
google-adsReviews performance and manages supported keywords, bids, budgets, negatives, and campaigns.
google-ads-copyWrites compliant RSA headlines and descriptions with test variants.
google-ads-assetsPlans sitelinks, callouts, snippets, image assets, and Performance Max briefs.
google-ads-landingDiagnoses keyword-to-ad-to-page relevance and landing-page quality.

Meta Ads

SkillWhat it does
meta-ads-auditAudits tracking, structure, creative health, audiences, spend efficiency, and scaling readiness.
meta-adsReviews Facebook and Instagram performance and executes supported campaign operations.
meta-ads-creativeProduces evidence-based concepts, copy angles, UGC briefs, and refresh experiments.

Analytics

SkillWhat it does
google-analyticsAnalyzes live GA4 acquisition, engagement, pages, events, and conversions and safely manages supported measurement configuration.
search-consoleAnalyzes live Search Console queries and pages, inspects URLs, and manages approved sitemap submissions.

WordPress

SkillWhat it does
wordpressOperates connected WordPress sites: content, media, comments, design, settings, plugins, themes, and approved HTML or admin changes.

CRM

SkillWhat it does
gohighlevelOperates connected GoHighLevel contacts, conversations, opportunities, calendars, and other approved CRM changes.

Cross-model review and maintenance

SkillWhat it does
geminiUses Google Gemini for a second opinion, adversarial challenge, or open consultation.
upgradeUpdates an installed NotFair plugin and summarizes what changed.

Live data and integrations

Some skills work entirely from a repository, URL, or supplied export. Live account analysis uses one OAuth-connected universal NotFair MCP. The plugin registers exactly one server named NotFair, shared by every supported platform.

The agent chooses tools from the live server's instructions and capability descriptions. Skills supply marketing workflows and evidence standards without hardcoding MCP tool names or call sequences. See the connection and upgrade guide for manual configuration and migration from older per-platform connections. Each platform becomes available after it is connected in the NotFair workspace selected during OAuth. Follow any account setup guidance returned by the server.

Data sourceUsed forConnection
Google Search ConsoleSearch performance, queries, pages, indexing, URL inspection, and sitemapsOne NotFair connection
Google Analytics 4Acquisition, engagement, landing pages, events, conversions, realtime, and measurement configurationOne NotFair connection
Google AdsCampaign performance, search terms, bids, budgets, keywords, and change historyOne NotFair connection
Meta AdsFacebook and Instagram campaigns, ad sets, creatives, and insightsOne NotFair connection
X AdsCampaigns, line items, performance, targeting, promoted posts, audiences, and approved mutationsOne NotFair connection
LinkedIn AdsCampaign groups, campaigns, creatives, analytics, targeting, conversions, and leadsOne NotFair connection
Reddit AdsCampaigns, ad groups, ads, reporting, audiences, pixels, funding instruments, and approved mutationsOne NotFair connection
TikTok AdsAdvertiser delivery, reporting, creative, targeting, and approved mutationsOne NotFair connection
WordPressConnected site content, media, comments, design, settings, plugins, themes, and approved mutationsOne NotFair connection
GoHighLevelContacts, conversations, opportunities, calendars, and approved CRM mutationsOne NotFair connection
Other CMS platformsLocal SEO-script content review in Strapi, Contentful, or Ghostsetup-cms Application Password / API token, not NotFair MCP
Google GeminiCross-model reviewGemini API key

Supported account operations come from the live connection. Changes must stay within the user's authorization and be verified against the resulting account state. Amazon and ChatGPT Ads remain planning or export-review workflows unless the current agent session exposes a verified connector. setup-cms is a local SEO-script credential wizard; live WordPress work uses /notfair:wordpress.

Privacy and support

The plugin connects to the declared NotFair MCP endpoint through browser OAuth. Requested tool arguments go to NotFair and results from connected providers return to your authorized AI client. See the privacy policy for storage, retention, and deletion details. Connect only the workspace and platform accounts you intend to use.

Optional local workflows run readable Python or shell scripts. Crawlers request the URLs you supply; direct Search Console scripts use your explicitly authorized Google Cloud login; CMS scripts use the site credentials you configure through setup-cms. Gemini review sends the selected review context to Google's Gemini CLI after its authentication setup. Choose these workflows explicitly, keep credentials out of reports and commits, and use the OAuth MCP for live platform work when it is available. There are no automatic plugin hooks or local MCP servers. The calendar viewer serves local planning data on loopback, and the optional update checker reads the public version file from GitHub.

The separate NotFair Next.js blog library now lives in its own public repository and is distributed through its GitHub releases. Its source and publishing workflow are no longer bundled in this AI-agent plugin. The retired NotFair CMO application is also no longer included.

Inside a skill, connectors use tool-agnostic placeholders such as ~~google-ads, ~~meta-ads, ~~x-ads, ~~linkedin-ads, ~~reddit-ads, ~~tiktok-ads, ~~search-console, ~~google-analytics, ~~wordpress, and ~~gohighlevel. The agent resolves each placeholder to a compatible tool available in the current session, so the workflow is not coupled to one MCP namespace.

How the repository is organized

text
notfair-plugin/├── AGENTS.md                    # intent-to-skill resolver for AI agents├── .claude-plugin/              # Claude Code plugin manifest├── paid-ads/                    # cross-channel planning, review, optimization├── google-ads/                  # audit, management, copy, assets, landing pages├── meta-ads/                    # audit, management, creative├── analytics/                   # Google Analytics and Search Console MCP workflows├── wordpress/                   # live WordPress MCP operator├── gohighlevel/                 # live GoHighLevel CRM MCP operator├── seo/                         # SEO, GEO, content, and technical-search skills├── gemini/                      # cross-model review├── test/                        # unit and LLM-judge evals└── skills/                      # shared entry points for every agent host

AGENTS.md is the universal entry point. It maps user intent to the canonical SKILL.md and documents the external dependency each workflow requires.

Contributing

Each skill lives in its own category folder:

text
seo/your-skill-name/├── WORKFLOW.md       # full instructions and frontmatter├── references/       # optional supporting knowledge└── scripts/          # optional deterministic tooling

When adding or changing a skill:

  1. Keep the workflow focused on one clear marketing job.
  2. Use imperative, testable instructions in WORKFLOW.md, and keep the entry point under skills/ in sync.
  3. Add or update eval coverage.
  4. Update AGENTS.md, the plugin manifest, VERSION, and CHANGELOG.md.

Open a pull request with one skill or one coherent improvement. See plugin development for repository conventions.

Community

License

MIT

Source: README.md at commit ed835f2

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v0.2.23LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Adsagent integrations

AdsAgent — Google Ads MCP

md.adsagentOfficial publisher

Hosted Google Ads MCP that lets an assistant read ad account data with OAuth and make writes through a prepare-then-confirm flow.

Streamable HTTPWeb executableAuth
Data & AnalyticsCredential requiredOct 24, 2026

AdsAgent — TikTok Ads MCP

md.adsagentOfficial publisher

A hosted TikTok Ads MCP server that lets an assistant read ad data with bounded queries and make changes through a prepare/confirm write flow, using OAuth.

Streamable HTTPWeb executableAuth
Business & CommerceCredential requiredOct 24, 2026

AdsAgent — Meta Ads MCP

md.adsagentOfficial publisher

A hosted Meta ads MCP server that lets an assistant read ad data and prepare and confirm ad changes under OAuth.

Streamable HTTPWeb executableAuth
Business & CommerceCredential requiredOct 24, 2026