Skip to content

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

feat: migrate AdsAgent → NotFair MCP server (v0.15.0)

Yuting Zhong4c11b523f35b
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json
index a32c7e45..547ea2f5 100644
--- a/.claude-plugin/marketplace.json
+++ b/.claude-plugin/marketplace.json
@@ -5,14 +5,14 @@
},
"metadata": {
"description": "The official Google Ads + SEO + GEO plugin from AdsAgent. SEO, GEO, and Google Ads skills for Claude Code.",
- "version": "0.14.0"
+ "version": "0.15.0"
},
"plugins": [
{
"name": "toprank",
"source": "./",
"description": "The official Google Ads + SEO + GEO plugin from AdsAgent. SEO analysis, Google Ads management, keyword research, content optimization, schema markup, meta tags optimization, broken link checker, single-page deep audit, and Generative Engine Optimization for AI search.",
- "version": "0.14.0",
+ "version": "0.15.0",
"author": {
"name": "AdsAgent",
"url": "https://adsagent.org"
diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json
index a6a80175..a48b7648 100644
--- a/.claude-plugin/plugin.json
+++ b/.claude-plugin/plugin.json
@@ -1,6 +1,6 @@
{
"name": "toprank",
- "version": "0.14.0",
+ "version": "0.15.0",
"description": "The official Google Ads + SEO + GEO plugin from AdsAgent. SEO analysis, Google Ads management, keyword research, content optimization, schema markup tools, broken link checker, single-page deep audit, and Generative Engine Optimization (GEO) for AI search engines — powered by Google Search Console and Google Ads APIs.",
"author": {
"name": "AdsAgent",
diff --git a/.mcp.json b/.mcp.json
index 6aa29964..8b78c2d8 100644
--- a/.mcp.json
+++ b/.mcp.json
@@ -1,13 +1,8 @@
{
"mcpServers": {
- "adsagent": {
- "command": "npx",
- "args": [
- "-y", "mcp-remote",
- "https://adsagent.org/api/mcp",
- "--transport", "http-first",
- "--header", "Authorization:Bearer ${ADSAGENT_API_KEY}"
- ]
+ "notfair": {
+ "type": "http",
+ "url": "https://notfair.co/api/mcp"
}
}
}
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e59666f2..24acfd96 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,22 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
---
+## [0.15.0] — 2026-04-28
+
+### Changed
+- **MCP server moved from AdsAgent to NotFair** — endpoint migrated from `https://adsagent.org/api/mcp` to `https://notfair.co/api/mcp`. The plugin's `.mcp.json` is updated automatically when you upgrade; restart Claude Code to pick up the new server.
+- **Auth scheme switched from API key to native OAuth 2.1** — `ADSAGENT_API_KEY` is no longer required, and the `mcp-remote` (npx) bridge has been removed. `.mcp.json` now uses Claude Code's native HTTP transport (`"type": "http"`); on first connection Claude Code opens a browser tab for OAuth sign-in to NotFair and stores the token in your OS keychain. You can remove `ADSAGENT_API_KEY` from `~/.claude/settings.json` once the new server is connected.
+- **Local namespace renamed `.adsagent` → `.notfair`** — affects the global config dir (`~/.adsagent/` → `~/.notfair/`), the project config file (`.adsagent.json` → `.notfair.json`), and the project data dir (`.adsagent/` → `.notfair/`). The shared preamble runs a one-time atomic `mv` migration on first invocation; if both old and new paths exist (partial state from a manual move), it stops and asks you to reconcile rather than risk losing writes. **Update your `.gitignore` if you were ignoring `.adsagent.json` / `.adsagent/`.**
+- **Tool prefix renamed `mcp__adsagent__*` → `mcp__notfair__*`** — driven by the `.mcp.json` server-name change. The shared preamble's MCP detection prefers the new prefix but still detects the legacy one (and the legacy `mcp__claude_ai_AdsAgent__*` connector) so skills keep working through the rename window. If you're on a session that hasn't restarted yet, the preamble nudges you to restart Claude Code once.
+- **MCP registry identifier renamed `io.github.nowork-studio/adsagent` → `io.github.nowork-studio/notfair`** — for users who consume the standalone MCP server directly (Claude Desktop, Cursor, Inspector, custom agents). Bumped the published server version to 0.3.0 to reflect the rename.
+
+### Migration notes
+- The shared preamble handles `.adsagent` → `.notfair` filesystem migration automatically — no manual steps for global users.
+- Users who ran "save this account for this project only" will have their project-level config (`.adsagent.json` and the `.adsagent/` data dir) renamed in place on next skill invocation.
+- OAuth tokens are stored in the OS keychain (Keychain on macOS, Credential Manager on Windows, Secret Service on Linux). On first connection to the new endpoint you'll see a browser tab for sign-in; tokens refresh automatically afterwards.
+
+---
+
## [0.14.0] — 2026-04-27
### Added
diff --git a/CLAUDE.md b/CLAUDE.md
index 0f48b8dc..07d92584 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -19,7 +19,7 @@ This code ships to real users. Sycophancy and rubber-stamping cost us credibilit
- Home of the `toprank` plugin — the public artifact customers install.
- Contains skills under `google-ads/`, `seo/`, `gemini/`, and `toprank-upgrade-skill/`.
- Registered via `.claude-plugin/plugin.json` (skills list) and `.claude-plugin/marketplace.json` (plugin metadata).
-- Paired with the AdsAgent MCP server (`https://www.adsagent.org`) for Google Ads write operations, and with Google Search Console for SEO reads.
+- Paired with the NotFair MCP server (`https://notfair.co/api/mcp`, OAuth, formerly hosted at adsagent.org) for Google Ads write operations, and with Google Search Console for SEO reads.
## Critical: this ships to users
diff --git a/README.md b/README.md
index 3d5a1562..ef3fcb36 100644
--- a/README.md
+++ b/README.md
@@ -127,7 +127,7 @@ Run these two commands in Claude Code:
That's it. All skills are now available as `/toprank:*` commands.
-**Google Ads (optional):** Connect your account at [adsagent.org](https://www.adsagent.org) (free API key) — setup instructions are provided there.
+**Google Ads (optional):** The first time Claude Code connects to the NotFair MCP server, it opens a browser tab and asks you to sign in to [notfair.co](https://notfair.co) — authorize once and the token is stored in your OS keychain. No API key to copy, no `mcp-remote` bridge to install.
### Manual Install
@@ -227,9 +227,9 @@ toprank/
The Google Ads surface is also available as a standalone remote MCP server — use it from any MCP client (Claude Desktop, Cursor, Inspector, your own agent) without installing the Toprank CLI plugin.
-- **Registry name:** `io.github.nowork-studio/adsagent` (verify: `curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=adsagent"`)
-- **Endpoint:** `https://adsagent.org/api/mcp` (streamable HTTP)
-- **Auth:** OAuth (Claude Connector) or Bearer token — get one at [adsagent.org/connect](https://adsagent.org/connect)
+- **Registry name:** `io.github.nowork-studio/notfair` (verify: `curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=notfair"`)
+- **Endpoint:** `https://notfair.co/api/mcp` (streamable HTTP)
+- **Auth:** OAuth 2.1 with dynamic client registration — your MCP client opens a browser tab to sign in at [notfair.co](https://notfair.co) on first use; the token is stored locally (OS keychain in Claude Code)
The server exposes ~100 Google Ads tools across reads (performance, search terms, impression share, keyword ideas, GAQL), writes (pause/enable, bid and budget updates, keyword and negative list management, campaign creation), and a `runScript` tool that fans out up to 20 GAQL queries in parallel for open-ended analytical questions. Source for the hosted server lives in [`nowork-studio/ads-agent`](https://github.com/nowork-studio/ads-agent).
@@ -241,14 +241,14 @@ Toprank skills reference external tools using the `~~category` placeholder patte
| Category | Placeholder | Default Server | Alternatives |
|----------|-------------|---------------|--------------|
-| Google Ads | `~~google-ads` | [AdsAgent MCP](https://www.adsagent.org) (`mcp__adsagent__*`) | Google Ads MCP (`mcp__google_ads_mcp__*`) |
+| Google Ads | `~~google-ads` | [NotFair MCP](https://notfair.co) (`mcp__notfair__*`; legacy `mcp__adsagent__*` still detected during the rename window) | Google Ads MCP (`mcp__google_ads_mcp__*`) |
| Search Console | `~~search-console` | gcloud CLI + Search Console API | Any GSC-compatible MCP server |
| CMS | `~~cms` | Direct API (WordPress REST, Strapi, Contentful, Ghost) | Any CMS MCP server |
Skills use conditional blocks based on available tools. If a connector is not available, the skill gracefully degrades — for example, `seo-analysis` can still run a technical crawl without GSC data.
**Setup:**
-- **Google Ads:** See `google-ads/shared/preamble.md`. Get a free API key from [adsagent.org](https://www.adsagent.org), set `ADSAGENT_API_KEY`, and the `.mcp.json` auto-configures the MCP server.
+- **Google Ads:** See `google-ads/shared/preamble.md`. The `.mcp.json` registers `https://notfair.co/api/mcp` as a native HTTP MCP server; on first connection Claude Code opens a browser for OAuth sign-in to [notfair.co](https://notfair.co) and stores the token in your OS keychain — no environment variable, no bridge subprocess.
- **Search Console:** See `seo/shared/preamble.md`. Requires Google Cloud SDK, Search Console API enabled, and OAuth login.
- **CMS:** Run `/toprank:setup-cms` to configure WordPress, Strapi, Contentful, or Ghost.
diff --git a/VERSION b/VERSION
index a803cc22..a5510516 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.14.0
+0.15.0
diff --git a/gemini/SKILL.md b/gemini/SKILL.md
index 155d6874..4143b5db 100644
--- a/gemini/SKILL.md
+++ b/gemini/SKILL.md
@@ -84,9 +84,9 @@ Determine what kind of changes are being reviewed. Check in this order:
### 2a — Check for Google Ads changes
Look for signs of Ads-related work in the current conversation context:
-- Recent MCP tool calls to `mcp__adsagent__*` or `mcp__google_ads_mcp__*`
+- Recent MCP tool calls to `mcp__notfair__*` (or legacy `mcp__adsagent__*`) or `mcp__google_ads_mcp__*`
- Discussion of campaigns, keywords, bids, budgets, ad copy, negative keywords
-- Files like `.adsagent/change-log.json` or Ads-related config changes
+- Files like `.notfair/change-log.json` (or legacy `.adsagent/change-log.json`) or Ads-related config changes
If found, set `CHANGE_TYPE=google-ads`.
diff --git a/google-ads/ads/evals/evals.json b/google-ads/ads/evals/evals.json
index 94849ffb..6a448543 100644
--- a/google-ads/ads/evals/evals.json
+++ b/google-ads/ads/evals/evals.json
@@ -4,11 +4,11 @@
{
"id": 1,
"prompt": "Can you help me manage my Google Ads?",
- "expected_output": "The skill checks for the AdsAgent MCP server connection, then resolves config from the 3-tier chain (project .adsagent.json > Claude project adsagent.json > global ~/.adsagent/config.json), then checks for an accountId. It should not attempt to pull campaign data before completing the onboarding flow.",
+ "expected_output": "The skill checks for the NotFair MCP server connection, then resolves config from the 3-tier chain (project .notfair.json > Claude project notfair.json > global ~/.notfair/config.json), then checks for an accountId. It should not attempt to pull campaign data before completing the onboarding flow.",
"files": [],
"expectations": [
"The skill attempts to verify MCP server connectivity before pulling data",
- "The skill resolves apiKey from the 3-tier config chain (project > claude-project > global)",
+ "The skill resolves accountId from the 3-tier config chain (project > claude-project > global); auth is handled by Claude Code's native HTTP+OAuth transport, not by an API key in config",
"The skill checks for accountId before making campaign API calls",
"If any setup step is missing, the skill guides the user through resolution before proceeding"
]
diff --git a/google-ads/shared/preamble.md b/google-ads/shared/preamble.md
index f14b9c76..58b34d8d 100644
--- a/google-ads/shared/preamble.md
+++ b/google-ads/shared/preamble.md
@@ -1,6 +1,6 @@
# Google Ads Shared Preamble
-Every google-ads skill reads this before doing anything else. It handles updates, API key verification, MCP detection, config resolution, and onboarding in one place — so individual skills don't repeat this logic.
+Every google-ads skill reads this before doing anything else. It handles updates, legacy-path migration, MCP detection, config resolution, and onboarding in one place — so individual skills don't repeat this logic.
## Step 0: Check for toprank updates
@@ -16,79 +16,103 @@ If the output contains `JUST_UPGRADED <old> <new>`: mention "toprank upgraded fr
If neither: continue to Step 1 silently.
-## Step 1: Verify API key — BLOCKING
+## Step 1: Migrate legacy `.adsagent` paths (one-time, silent)
-The MCP server authenticates via the `ADSAGENT_API_KEY` environment variable, which Claude Code injects from `~/.claude/settings.json`. Without it, no MCP tools will work — so this check must happen before anything else.
+The MCP server moved from AdsAgent to NotFair. Existing users may have config and data under `.adsagent`-named paths from before the rename — move it to the new `.notfair` namespace before reading config so all subsequent steps see consistent state. If the new path already exists, **do not overwrite** — flag the conflict and stop.
-**You MUST execute this step. Do NOT skip it. Do NOT check environment variables — you MUST read the file.**
+Run this as a single bash block (atomic `mv`, refuses to overwrite, no-op when nothing to migrate):
-1. Use the Read tool to read `~/.claude/settings.json`.
-2. Parse the JSON and check if `env.ADSAGENT_API_KEY` exists and is a non-empty string.
-
-**If the key exists and is non-empty:** proceed to Step 2 silently.
-
-**If the key is missing, the `env` object doesn't exist, or the file doesn't exist:** you MUST stop and do the following — do NOT proceed to any other step, do NOT fulfill the user's request:
-
-1. Output this message and STOP (do not call any tools, do not continue — just output this text and end your turn):
-
- > To use Google Ads features, you need an AdsAgent API key.
- > Sign up at [adsagent.org](https://adsagent.org) to get your key, then paste it below.
-
-2. When the user replies with their key, read `~/.claude/settings.json` again (use `{}` if it doesn't exist). Deep-merge the key into the existing JSON — preserve all existing top-level fields and all existing keys within the `env` object. Only add/overwrite `ADSAGENT_API_KEY`:
- ```json
- {
- "...existing fields preserved...",
- "env": {
- "...existing env vars preserved...",
- "ADSAGENT_API_KEY": "<the key the user provided>"
- }
- }
- ```
- Write the updated JSON back to `~/.claude/settings.json` using the Write tool.
+```bash
+_NF_MIGRATED=()
+_NF_CONFLICTS=()
+
+_nf_move() {
+ local src="$1" dst="$2"
+ if [ -e "$src" ] || [ -L "$src" ]; then
+ if [ -e "$dst" ] || [ -L "$dst" ]; then
+ _NF_CONFLICTS+=("$src → $dst (target already exists)")
+ else
+ mv "$src" "$dst" && _NF_MIGRATED+=("$src → $dst")
+ fi
+ fi
+}
+
+# Global config + data directory
+_nf_move "$HOME/.adsagent" "$HOME/.notfair"
+
+# Project-level config + data directory (in the current working directory)
+_nf_move "$(pwd)/.adsagent.json" "$(pwd)/.notfair.json"
+_nf_move "$(pwd)/.adsagent" "$(pwd)/.notfair"
+
+# Claude-project-level config (slug = CWD with '/' replaced by '-')
+_NF_SLUG=$(pwd | sed 's|/|-|g')
+_nf_move "$HOME/.claude/projects/$_NF_SLUG/adsagent.json" \
+ "$HOME/.claude/projects/$_NF_SLUG/notfair.json"
+
+if [ ${#_NF_MIGRATED[@]} -gt 0 ]; then
+ echo "MIGRATED:"
+ for m in "${_NF_MIGRATED[@]}"; do echo " - $m"; done
+fi
+if [ ${#_NF_CONFLICTS[@]} -gt 0 ]; then
+ echo "CONFLICTS:"
+ for c in "${_NF_CONFLICTS[@]}"; do echo " - $c"; done
+fi
+```
-3. Tell the user the key has been saved. Note: the MCP server won't pick up the new key until Claude Code restarts. If MCP tools fail in Step 3, advise the user to restart Claude Code and re-run their command. Then proceed to Step 2.
+- **Output contains `MIGRATED:`** — briefly tell the user "Migrated your AdsAgent config to the new NotFair location (`.adsagent` → `.notfair`)", then continue to Step 2.
+- **Output contains `CONFLICTS:`** — both the legacy and new paths exist for at least one item; the user has partial state from a previous migration attempt. Show the conflicts and tell the user to manually reconcile (typically: inspect both, keep the newer `.notfair` copy, delete the stale `.adsagent` copy). **Stop here** until they resolve it — running with split state will silently lose writes.
+- **Empty output** — nothing to migrate; continue to Step 2 silently.
## Step 2: Resolve config
Read config from three locations and merge fields (first non-null, non-empty-string value wins per field):
-1. **Project-level** — `.adsagent.json` in the repository root (Claude Code's working directory)
-2. **Claude project-level** — `~/.claude/projects/{project-path}/adsagent.json` (where `{project-path}` is the CWD-based path Claude Code uses for project memory, e.g. `-Users-alice-repos-petshop`)
-3. **Global fallback** — `~/.adsagent/config.json`
+1. **Project-level** — `.notfair.json` in the repository root (Claude Code's working directory)
+2. **Claude project-level** — `~/.claude/projects/{project-path}/notfair.json` (where `{project-path}` is the CWD-based path Claude Code uses for project memory, e.g. `-Users-alice-repos-petshop`)
+3. **Global fallback** — `~/.notfair/config.json`
Each file uses the same schema: `{ "accountId": "..." }`. Fields merge up the chain — a project file with only `accountId` inherits from global.
-The API key is stored separately in `~/.claude/settings.json` under `env.ADSAGENT_API_KEY` (not in config files — the MCP server reads it from the environment).
+The MCP server authenticates via OAuth 2.1 — Claude Code's native HTTP transport opens a browser for sign-in on first use and stores the token in the OS keychain (Keychain on macOS, Credential Manager on Windows, Secret Service on Linux). No API key, no `mcp-remote` bridge, no env vars to manage.
### Resolved data directory
Data files (business-context, personas, change-log, account-baseline) are stored project-locally when a project-level config exists:
-- If `.adsagent.json` exists in the current working directory → `{data_dir}` = `.adsagent/` (relative to project root)
-- Otherwise → `{data_dir}` = `~/.adsagent/` (the Claude project-level config alone doesn't trigger project-local data — only a `.adsagent.json` in the repo does)
+- If `.notfair.json` exists in the current working directory → `{data_dir}` = `.notfair/` (relative to project root)
+- Otherwise → `{data_dir}` = `~/.notfair/` (the Claude project-level config alone doesn't trigger project-local data — only a `.notfair.json` in the repo does)
-Create `{data_dir}` if it doesn't exist. Ensure `~/.adsagent/` also exists (needed for the global config file regardless of `{data_dir}`). Throughout this document and all skills, `{data_dir}` refers to this resolved directory.
+Create `{data_dir}` if it doesn't exist. Ensure `~/.notfair/` also exists (needed for the global config file regardless of `{data_dir}`). Throughout this document and all skills, `{data_dir}` refers to this resolved directory.
-**Important:** If using project-local storage (`.adsagent/`), ensure `.adsagent.json` and `.adsagent/` are in the project's `.gitignore` — they contain business-sensitive data that should not be committed.
+**Important:** If using project-local storage (`.notfair/`), ensure `.notfair.json` and `.notfair/` are in the project's `.gitignore` — they contain business-sensitive data that should not be committed.
Continue to Step 3 (MCP detection always runs).
## Step 3: MCP Server Detection
-Always verify that a Google Ads MCP server is available — the MCP server could be down or misconfigured even with a valid API key and saved accountId.
+Always verify that a Google Ads MCP server is available — the MCP server could be down, unauthorized, or misconfigured even with a saved accountId.
+
+1. Check for NotFair tools. The MCP server may be exposed under several different tool-name prefixes depending on the host (and during the AdsAgent → NotFair rename, both old and new prefixes may briefly coexist):
+ - `mcp__notfair__*` — Claude Code CLI (toprank plugin default, current)
+ - `mcp__claude_ai_NotFair__*` — Claude Desktop / claude.ai plugin connector (current)
+ - `mcp__adsagent__*` — Claude Code CLI (legacy, pre-rename plugin)
+ - `mcp__claude_ai_AdsAgent__*` — Claude Desktop / claude.ai (legacy connector name)
+ - any other prefix matching `mcp__.*([Nn]ot[Ff]air|[Aa]ds[Aa]gent)__` (future hosts)
+
+ **How to detect:** scan your available tool list for any tool whose name ends in `listConnectedAccounts`. Take everything before `listConnectedAccounts` as the detected prefix. If multiple candidates exist, prefer them in this order: `mcp__notfair__` > `mcp__claude_ai_NotFair__` > `mcp__adsagent__` > `mcp__claude_ai_AdsAgent__` > any other match. Call `listConnectedAccounts` using that detected prefix, and save both the result and the prefix itself for reuse in Steps 4 and 5.
+
+ **Legacy-prefix migration nudge:** if the chosen prefix is `mcp__adsagent__` or `mcp__claude_ai_AdsAgent__` (i.e. a legacy AdsAgent variant) and no current `mcp__notfair__*` / `mcp__claude_ai_NotFair__*` tools are visible, briefly tell the user once:
+
+ > Detected the legacy AdsAgent MCP server. The plugin has been renamed to NotFair — please **restart Claude Code** to pick up the new server registration (`mcp__notfair__*`). Continuing with the legacy server for this session.
-1. Check for AdsAgent tools. The AdsAgent MCP server may be exposed under several different tool-name prefixes depending on the host:
- - `mcp__adsagent__*` — Claude Code CLI (toprank plugin default)
- - `mcp__claude_ai_AdsAgent__*` — Claude Desktop / claude.ai plugin connector
- - any other prefix matching `mcp__.*[Aa]ds[Aa]gent__` (future hosts)
+ Then proceed normally — the legacy server still works (it points at the new notfair.co URL after the recent endpoint update); only the tool-name prefix is stale.
- **How to detect:** scan your available tool list for any tool whose name ends in `listConnectedAccounts`. Take everything before `listConnectedAccounts` as the detected prefix. If multiple candidates exist, prefer them in this order: `mcp__adsagent__` > `mcp__claude_ai_AdsAgent__` > any other AdsAgent match. Call `listConnectedAccounts` using that detected prefix, and save both the result and the prefix itself for reuse in Steps 4 and 5.
-2. If no AdsAgent variant exists, check for Google's official MCP: look for tools matching `mcp__google_ads_mcp__*`.
+2. If no NotFair/AdsAgent variant exists, check for Google's official MCP: look for tools matching `mcp__google_ads_mcp__*`.
3. If none exists, guide the user:
> No Google Ads MCP server detected.
>
-> Your API key is configured, but the MCP server may not have started. Try restarting Claude Code — the toprank plugin's .mcp.json will auto-configure the server using your key.
+> The MCP server may not have connected, or the OAuth sign-in didn't complete. Try restarting Claude Code — the toprank plugin's .mcp.json registers the `notfair` HTTP MCP server, and Claude Code will open a browser tab for OAuth sign-in to NotFair on first connection. You can also trigger sign-in manually with `/mcp`.
>
> If the problem persists, check your MCP server settings or configure a Google Ads MCP server manually.
@@ -100,9 +124,9 @@ If `accountId` was already resolved in Step 2, skip to Step 5. Otherwise, contin
Use the `listConnectedAccounts` result from Step 3 (do not call it again):
-1. **One account** → save automatically to the highest-priority config file that already exists (project > claude-project > global; if none exist yet, save to `~/.adsagent/config.json`), tell the user which was selected
+1. **One account** → save automatically to the highest-priority config file that already exists (project > claude-project > global; if none exist yet, save to `~/.notfair/config.json`), tell the user which was selected
2. **Multiple accounts** → show numbered list, ask user to pick, save choice to the same location
-3. **Zero accounts** → direct to [adsagent.org](https://www.adsagent.org) to connect one
+3. **Zero accounts** → direct to [notfair.co](https://notfair.co) to connect one
### Switching accounts
@@ -110,18 +134,20 @@ If the user explicitly asks to switch accounts, run `listConnectedAccounts`, let
> "Save this account for this project only, or globally?"
-- **Project** → write `accountId` to `.adsagent.json` in the current working directory (create the file if needed)
-- **Global** → write `accountId` to `~/.adsagent/config.json`
+- **Project** → write `accountId` to `.notfair.json` in the current working directory (create the file if needed)
+- **Global** → write `accountId` to `~/.notfair/config.json`
## Step 5: Calling tools
Use whichever MCP server prefix was detected in Step 3:
-- **AdsAgent MCP via Claude Code CLI:** `mcp__adsagent__<toolName>`
-- **AdsAgent MCP via Claude Desktop / claude.ai plugin:** `mcp__claude_ai_AdsAgent__<toolName>`
+- **NotFair MCP via Claude Code CLI (current):** `mcp__notfair__<toolName>`
+- **NotFair MCP via Claude Desktop / claude.ai plugin (current):** `mcp__claude_ai_NotFair__<toolName>`
+- **Legacy AdsAgent MCP via Claude Code CLI (pre-rename):** `mcp__adsagent__<toolName>`
+- **Legacy AdsAgent MCP via Claude Desktop / claude.ai plugin:** `mcp__claude_ai_AdsAgent__<toolName>`
- **Google's official MCP:** `mcp__google_ads_mcp__<toolName>`
-Always call tools under the exact prefix detected in Step 3 — do not hardcode `mcp__adsagent__`. Pass `accountId` from the resolved config (Step 2) to every tool call (except `listConnectedAccounts`).
+Always call tools under the exact prefix detected in Step 3 — do not hardcode `mcp__notfair__` or `mcp__adsagent__`. Pass `accountId` from the resolved config (Step 2) to every tool call (except `listConnectedAccounts`).
### Reads vs. writes
diff --git a/server.json b/server.json
index fc1dd735..4a1f64b5 100644
--- a/server.json
+++ b/server.json
@@ -1,18 +1,18 @@
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
- "name": "io.github.nowork-studio/adsagent",
- "title": "AdsAgent",
- "description": "Google Ads analysis and operations — read performance, manage keywords, bids, and campaigns.",
- "websiteUrl": "https://adsagent.org",
+ "name": "io.github.nowork-studio/notfair",
+ "title": "NotFair",
+ "description": "Google Ads MCP - analyze performance, manage keywords, bids, and campaigns.",
+ "websiteUrl": "https://notfair.co",
"repository": {
"url": "https://github.com/nowork-studio/toprank",
"source": "github"
},
- "version": "0.2.23",
+ "version": "0.3.0",
"remotes": [
{
"type": "streamable-http",
- "url": "https://adsagent.org/api/mcp"
+ "url": "https://notfair.co/api/mcp"
}
]
}
diff --git a/test/install.test.sh b/test/install.test.sh
index 1dc6c9fd..7ab789f7 100755
--- a/test/install.test.sh
+++ b/test/install.test.sh
@@ -151,8 +151,10 @@ assert_file "$REPO_ROOT/seo/shared/preamble.md" "SEO shared preamble exists"
for skill in ads ads-audit ads-copy; do
assert_contains "$REPO_ROOT/google-ads/$skill/SKILL.md" "../shared/preamble.md" \
"$skill references shared preamble"
+ assert_not_contains "$REPO_ROOT/google-ads/$skill/SKILL.md" "mcp__notfair__listConnectedAccounts" \
+ "$skill does not inline MCP detection (notfair prefix)"
assert_not_contains "$REPO_ROOT/google-ads/$skill/SKILL.md" "mcp__adsagent__listConnectedAccounts" \
- "$skill does not inline MCP detection"
+ "$skill does not inline MCP detection (legacy adsagent prefix)"
done
# SEO skills that need GSC reference the shared preamble
@@ -166,9 +168,9 @@ done
echo ""
echo "=== 5. MCP server config ==="
-assert_contains "$REPO_ROOT/.mcp.json" "adsagent" ".mcp.json has adsagent server"
-assert_contains "$REPO_ROOT/.mcp.json" "mcp-remote" ".mcp.json uses mcp-remote"
-assert_contains "$REPO_ROOT/.mcp.json" "ADSAGENT_API_KEY" ".mcp.json references API key env var"
+assert_contains "$REPO_ROOT/.mcp.json" "\"notfair\"" ".mcp.json registers the notfair server (tool prefix mcp__notfair__*)"
+assert_contains "$REPO_ROOT/.mcp.json" "\"type\": \"http\"" ".mcp.json uses native HTTP transport (no mcp-remote bridge)"
+assert_contains "$REPO_ROOT/.mcp.json" "notfair.co/api/mcp" ".mcp.json points at NotFair MCP endpoint"
# ─── Test 6: Connectors section in README ─────────────────────