Skip to content

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.json
index 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.json
index 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.json
index 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.json
index 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.json
index 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.md
index 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.md
index 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.md
index 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.md
index 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/VERSION
index 83b47304..3edc695d 100644
--- a/VERSION
+++ b/VERSION
@@ -1 +1 @@
-0.27.1
+0.27.2
diff --git a/gemini-extension.json b/gemini-extension.json
index 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.md
index 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.json
index 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.md
index 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.json
index 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.json
index 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.sh
index 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.py
index cdef506b..358359d0 100644
--- a/test/test_mcp_skill_e2e.py
+++ b/test/test_mcp_skill_e2e.py
@@ -19,7 +19,7 @@ import pytest
ROOT = Path(__file__).parent.parent
UNIVERSAL_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"] == endpoint
assert 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 = (