Open-source SEO, GEO, and marketing skills for AI agents.
feat: publish canonical NotFair MCP endpoint
Yuting Zhongb9473be7c09b
diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.jsonindex 76b96862..9fe0eac8 100644--- a/.claude-plugin/marketplace.json+++ b/.claude-plugin/marketplace.json@@ -5,14 +5,14 @@},"metadata": {"description": "The official ads, analytics, SEO, and GEO plugin from NotFair.",- "version": "0.27.1"+ "version": "0.27.2"},"plugins": [{"name": "notfair","source": "./","description": "Operate Google, Meta, X, and LinkedIn Ads; analyze Search Console and GA4; and run open-source SEO, GEO, and content workflows.",- "version": "0.27.1",+ "version": "0.27.2","author": {"name": "NotFair","url": "https://notfair.co"diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.jsonindex 1bcfedff..23cd6499 100644--- a/.claude-plugin/plugin.json+++ b/.claude-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "notfair",- "version": "0.27.1",+ "version": "0.27.2","description": "The official ads, analytics, SEO, and GEO plugin from NotFair. Operate Google, Meta, X, and LinkedIn Ads; analyze Google Search Console and GA4; and run open-source search and content workflows from any compatible agent.","author": {"name": "NotFair",diff --git a/.codex-plugin/plugin.json b/.codex-plugin/plugin.jsonindex 6dc0c4e4..6903c11b 100644--- a/.codex-plugin/plugin.json+++ b/.codex-plugin/plugin.json@@ -1,6 +1,6 @@{"name": "notfair",- "version": "0.27.1",+ "version": "0.27.2","description": "The official ads, analytics, SEO, and GEO plugin from NotFair.","author": {"name": "NotFair",diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.jsonindex 18e62de9..75c4caa6 100644--- a/.cursor-plugin/plugin.json+++ b/.cursor-plugin/plugin.json@@ -1,8 +1,8 @@{"name": "notfair","displayName": "NotFair",- "version": "0.27.1",- "description": "The official ads, analytics, SEO, and GEO plugin from NotFair.",+ "version": "0.27.2",+ "description": "Optimize Google Ads, Meta Ads, X Ads, LinkedIn Ads, Google Search Console, Google Analytics 4, and GoHighLevel with live data, open-source marketing skills, and approval-gated writes.","author": {"name": "NotFair"},@@ -13,6 +13,8 @@"advertising","analytics","google-ads",+ "meta-ads",+ "linkedin-ads","marketing","seo"],diff --git a/.mcp.json b/.mcp.jsonindex 26ec5938..6fe53aea 100644--- a/.mcp.json+++ b/.mcp.json@@ -2,7 +2,7 @@"mcpServers": {"NotFair": {"type": "http",- "url": "https://notfair.co/api/mcp/notfair_ads"+ "url": "https://notfair.co/api/mcp/notfair"}}}diff --git a/AGENTS.md b/AGENTS.mdindex e6c9028c..917d86f8 100644--- a/AGENTS.md+++ b/AGENTS.md@@ -98,7 +98,7 @@ Skills under `seo/`, `paid-ads/`, `google-ads/`, `meta-ads/`, `analytics/`, `gem## External dependencies-- **Universal NotFair MCP** — `https://notfair.co/api/mcp/notfair_ads`, OAuth. The plugin registers this single connection for Google Ads, Meta Ads, X Ads, LinkedIn Ads, Google Search Console, and Google Analytics. Its tools carry platform prefixes such as `google_ads_`, `meta_ads_`, and `search_console_`; verify the requested platform is connected before claiming live access.+- **Universal NotFair MCP** — `https://notfair.co/api/mcp/notfair`, OAuth. The plugin registers this single connection for Google Ads, Meta Ads, X Ads, LinkedIn Ads, Google Search Console, Google Analytics, and GoHighLevel. Its tools carry platform prefixes such as `google_ads_`, `meta_ads_`, and `search_console_`; verify the requested platform is connected before claiming live access.- **Platform connections** — each live skill still requires its corresponding account or property to be connected inside the selected NotFair workspace. A universal MCP session does not imply that every platform is connected.- **Google Gemini API key** — required for `gemini`.diff --git a/CHANGELOG.md b/CHANGELOG.mdindex 68f66456..1771b47d 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -21,7 +21,8 @@ The format follows [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).### Changed-- **One-command universal MCP onboarding (v0.27.0).** Replaced the six bundled platform server registrations with one `NotFair` MCP connection at `https://notfair.co/api/mcp/notfair_ads`. Codex and Claude now need one OAuth grant; workspaces enabled in the staged Google-first rollout connect Google Ads during that flow, and every supported platform remains isolated behind explicit tool prefixes such as `google_ads_`, `meta_ads_`, and `search_console_`.+- **Canonical all-platform MCP endpoint (v0.27.2).** Updated Cursor, Codex, Claude, Gemini, Agent Plugins, MCP Registry metadata, tests, and public documentation to advertise `https://notfair.co/api/mcp/notfair`. The backward-compatible legacy route remains supported but is no longer shown to new users.+- **One-command universal MCP onboarding (v0.27.0).** Replaced the six bundled platform server registrations with one `NotFair` MCP connection, now advertised at `https://notfair.co/api/mcp/notfair`. Codex and Claude now need one OAuth grant; workspaces enabled in the staged Google-first rollout connect Google Ads during that flow, and every supported platform remains isolated behind explicit tool prefixes such as `google_ads_`, `meta_ads_`, and `search_console_`.- **Repository renamed to `nowork-studio/notfair-plugin`.** Active clone, install, update-check, package metadata, and source links now use the new GitHub repository name. The plugin name and `/notfair:*` command namespace remain unchanged.- **`/google-ads-copy` now records concepts and claim sources,** requires unsupported proof to be marked for substantiation, and makes test decisions from pre-set metrics and adequate exposure rather than early conversion-rate gaps.diff --git a/INSTALL_FOR_AGENTS.md b/INSTALL_FOR_AGENTS.mdindex e0861bfa..44eef9eb 100644--- a/INSTALL_FOR_AGENTS.md+++ b/INSTALL_FOR_AGENTS.md@@ -83,7 +83,7 @@ Read `AGENTS.md` at the repo root. It contains the full intent → skill routing## Step 4 — Connect external services-The plugin registers one universal NotFair MCP server at `https://notfair.co/api/mcp/notfair_ads`. The Codex install command above explicitly starts its native OAuth flow; other hosts prompt on install or first use. The user signs in once and selects a NotFair workspace. During the staged Google-first rollout, enabled workspaces also connect Google Ads when they do not already have an active account. Google Ads, Meta Ads, X Ads, LinkedIn Ads, Search Console, and Google Analytics then appear as platform-prefixed tools through that one connection.+The plugin registers one universal NotFair MCP server at `https://notfair.co/api/mcp/notfair`. The Codex install command above explicitly starts its native OAuth flow; other hosts prompt on install or first use. The user signs in once and selects a NotFair workspace. During the staged Google-first rollout, enabled workspaces also connect Google Ads when they do not already have an active account. Google Ads, Meta Ads, X Ads, LinkedIn Ads, Search Console, Google Analytics, and GoHighLevel then appear as platform-prefixed tools through that one connection.NotFair skills depend on external APIs. Walk the user through whichever they need:diff --git a/README.md b/README.mdindex eed5496a..0c714695 100644--- a/README.md+++ b/README.md@@ -208,7 +208,7 @@ Marketing work gets unreliable when every request goes through the same vague pr## 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](https://notfair.co/api/mcp/notfair_ads). The plugin registers that connection automatically. During the staged Google-first rollout, enabled workspaces connect Google Ads in the same OAuth flow; every other platform becomes available after it is connected in the selected NotFair workspace.+Some skills work entirely from a repository, URL, or supplied export. Live account analysis uses one OAuth-connected [universal NotFair MCP](https://notfair.co/api/mcp/notfair). The plugin registers that connection automatically. During the staged Google-first rollout, enabled workspaces connect Google Ads in the same OAuth flow; every other platform becomes available after it is connected in the selected NotFair workspace.| Data source | Used for | Connection ||---|---|---|diff --git a/VERSION b/VERSIONindex 83b47304..3edc695d 100644--- a/VERSION+++ b/VERSION@@ -1 +1 @@-0.27.1+0.27.2diff --git a/gemini-extension.json b/gemini-extension.jsonindex 7abdcbe7..fe30e5bc 100644--- a/gemini-extension.json+++ b/gemini-extension.json@@ -1,12 +1,12 @@{"name": "notfair",- "version": "0.27.1",+ "version": "0.27.2","description": "Operate ads and analytics, and run open-source SEO, GEO, and content workflows with NotFair.","contextFileName": "AGENTS.md","mcpServers": {"NotFair": {"type": "http",- "url": "https://notfair.co/api/mcp/notfair_ads"+ "url": "https://notfair.co/api/mcp/notfair"}}}diff --git a/google-ads/shared/preamble.md b/google-ads/shared/preamble.mdindex a02d31e5..4dbccbc8 100644--- a/google-ads/shared/preamble.md+++ b/google-ads/shared/preamble.md@@ -62,7 +62,7 @@ Always verify that a Google Ads MCP server is available — the MCP server could> I can't see a Google Ads MCP server in this session, so I can't read your campaigns, pull spend, or make changes yet. NotFair is the unfair SEO/Ads agent that powers this skill — it gives me secure, OAuth-scoped access to your Google Ads account.>> **To connect:**-> 1. Run `/mcp` and pick **NotFair**, or run `codex mcp login NotFair` in Codex CLI. The plugin auto-registers the universal HTTP server (`https://notfair.co/api/mcp/notfair_ads`); the host opens a browser tab for sign-in.+> 1. Run `/mcp` and pick **NotFair**, or run `codex mcp login NotFair` in Codex CLI. The plugin auto-registers the universal HTTP server (`https://notfair.co/api/mcp/notfair`); the host opens a browser tab for sign-in.> 2. Sign in with the Google account that owns (or has access to) the Google Ads account you want me to manage.> 3. Come back and re-run your request.>diff --git a/mcp.json b/mcp.jsonindex d3017629..1c66d093 100644--- a/mcp.json+++ b/mcp.json@@ -3,7 +3,7 @@"mcpServers": {"NotFair": {"type": "http",- "url": "https://notfair.co/api/mcp/notfair_ads"+ "url": "https://notfair.co/api/mcp/notfair"}}}diff --git a/meta-ads/shared/preamble.md b/meta-ads/shared/preamble.mdindex ece62eea..78029172 100644--- a/meta-ads/shared/preamble.md+++ b/meta-ads/shared/preamble.md@@ -71,7 +71,7 @@ Always verify that a Meta Ads MCP server is available — the MCP server could b> No Meta Ads MCP server detected.>-> The NotFair plugin registers one universal `NotFair` HTTP MCP server (`https://notfair.co/api/mcp/notfair_ads`) in `.mcp.json`. Trigger sign-in with the host's MCP UI (`/mcp` in Claude) or `codex mcp login NotFair` in Codex CLI; the host opens the browser OAuth flow.+> The NotFair plugin registers one universal `NotFair` HTTP MCP server (`https://notfair.co/api/mcp/notfair`) in `.mcp.json`. Trigger sign-in with the host's MCP UI (`/mcp` in Claude) or `codex mcp login NotFair` in Codex CLI; the host opens the browser OAuth flow.>> If the problem persists, run `/notfair:upgrade` to make sure your NotFair plugin includes the Meta server registration, or configure a Meta Ads MCP server manually.diff --git a/plugin.json b/plugin.jsonindex f0733778..ce037abe 100644--- a/plugin.json+++ b/plugin.json@@ -1,7 +1,7 @@{"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json","name": "notfair",- "version": "0.27.1",+ "version": "0.27.2","description": "Operate ads and analytics, and run open-source SEO, GEO, and content workflows from compatible AI agents.","author": {"name": "NotFair",diff --git a/server.json b/server.jsonindex ccdec049..b196b707 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/notfair",- "title": "NotFair Ads",- "description": "Hosted OAuth MCP for Google, Meta, X, and LinkedIn Ads, GA4, and Search Console.",+ "title": "NotFair",+ "description": "Hosted OAuth MCP for Google Ads, Meta Ads, X Ads, LinkedIn Ads, Google Search Console, Google Analytics 4, and GoHighLevel.","websiteUrl": "https://notfair.co","repository": {"url": "https://github.com/nowork-studio/notfair-plugin","source": "github"},- "version": "0.27.1",+ "version": "0.27.2","remotes": [{"type": "streamable-http",- "url": "https://notfair.co/api/mcp/notfair_ads"+ "url": "https://notfair.co/api/mcp/notfair"}]}diff --git a/test/install.test.sh b/test/install.test.shindex 714b13e4..3c807ab3 100755--- a/test/install.test.sh+++ b/test/install.test.sh@@ -274,11 +274,12 @@ echo ""echo "=== 5. MCP server config ==="assert_file "$REPO_ROOT/.codex-plugin/plugin.json" "Codex plugin manifest exists"-assert_contains "$REPO_ROOT/.codex-plugin/plugin.json" '"mcpServers": "./.mcp.json"' "Codex manifest loads the MCP config"+assert_contains "$REPO_ROOT/.codex-plugin/plugin.json" '"mcpServers": "./mcp.json"' "Codex manifest loads the portable MCP config"assert_contains "$REPO_ROOT/.codex-plugin/plugin.json" '"skills": "./skills/"' "Codex manifest loads the canonical skill index"assert_contains "$REPO_ROOT/.mcp.json" "\"NotFair\"" ".mcp.json registers the universal NotFair server"assert_contains "$REPO_ROOT/.mcp.json" "\"type\": \"http\"" ".mcp.json uses native HTTP transport (no mcp-remote bridge)"-assert_contains "$REPO_ROOT/.mcp.json" "https://notfair.co/api/mcp/notfair_ads" ".mcp.json points at the canonical universal NotFair MCP endpoint"+assert_contains "$REPO_ROOT/.mcp.json" "https://notfair.co/api/mcp/notfair" ".mcp.json points at the canonical universal NotFair MCP endpoint"+assert_not_contains "$REPO_ROOT/.mcp.json" "api/mcp/notfair_ads" ".mcp.json does not advertise the legacy NotFair Ads alias"assert_not_contains "$REPO_ROOT/.mcp.json" "https://www.notfair.co" ".mcp.json origin matches the OAuth issuer exactly"assert_not_contains "$REPO_ROOT/.mcp.json" "api/mcp/google_ads" ".mcp.json does not auto-register the dedicated Google Ads endpoint"assert_not_contains "$REPO_ROOT/.mcp.json" "api/mcp/meta_ads" ".mcp.json does not auto-register the dedicated Meta Ads endpoint"diff --git a/test/test_mcp_skill_e2e.py b/test/test_mcp_skill_e2e.pyindex cdef506b..358359d0 100644--- a/test/test_mcp_skill_e2e.py+++ b/test/test_mcp_skill_e2e.py@@ -19,7 +19,7 @@ import pytestROOT = Path(__file__).parent.parentUNIVERSAL_SERVER = "NotFair"-UNIVERSAL_ENDPOINT = "https://notfair.co/api/mcp/notfair_ads"+UNIVERSAL_ENDPOINT = "https://notfair.co/api/mcp/notfair"PLATFORM_SKILLS = {"paid-ads/paid-ads-x": ("~~x-ads", "x_ads_"),@@ -45,7 +45,7 @@ def test_universal_mcp_is_the_only_registered_server_and_skills_use_platform_pre}assert codex_plugin["name"] == "notfair"assert codex_plugin["skills"] == "./skills/"- assert codex_plugin["mcpServers"] == "./.mcp.json"+ assert codex_plugin["mcpServers"] == "./mcp.json"assert codex_plugin["version"] == plugin["version"]codex_wrappers = {path.name: path for path in (ROOT / "skills").iterdir()}@@ -109,7 +109,7 @@ def test_live_mcp_oauth_discovery_round_trip():assert metadata["resource"] == endpointassert metadata["authorization_servers"] == ["https://notfair.co"]- assert metadata["resource_name"].startswith("NotFair ")+ assert metadata["resource_name"] == "NotFair"authorization_server = metadata["authorization_servers"][0]authorization_metadata_url = (