diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 8ca4331..174f38b 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -3,7 +3,7 @@ "name": "synter", "displayName": "Synter", "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", - "version": "1.2.1", + "version": "1.3.0", "license": "MIT", "author": { "name": "Synter", diff --git a/.cursor-mcp.json b/.cursor-mcp.json index b865a6c..eafd066 100644 --- a/.cursor-mcp.json +++ b/.cursor-mcp.json @@ -2,7 +2,8 @@ "mcpServers": { "synter": { "type": "http", - "url": "https://mcp.synterai.com" + "url": "https://mcp.synterai.com", + "description": "Synter Advertising Platform MCP: cross-channel ad reporting and management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." } } } diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index e07ddcb..0c36156 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -6,13 +6,13 @@ }, "metadata": { "description": "Synter's official plugin marketplace. The AI Agent Operator for Ads.", - "version": "1.2.1" + "version": "1.3.0" }, "plugins": [ { "name": "synter", "source": ".", - "logo": "assets/logo.png", + "logo": "assets/logo-opaque.png", "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution." } ] diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index bf7e256..95e808a 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -1,9 +1,9 @@ { "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json", "name": "synter", - "displayName": "Synter", - "version": "1.2.1", - "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", + "displayName": "Synter: Google Ads, Meta, LinkedIn, Reddit, X, TikTok & Microsoft Ads", + "version": "1.3.0", + "description": "Report on and plan ad campaigns across 9 verified platforms: Google Ads, Meta (Facebook & Instagram), LinkedIn, Microsoft (Bing) Ads, Reddit, Snapchat, StackAdapt, TikTok, and X (Twitter; performance reporting on X and TikTok may require platform exports) from one browser OAuth connection. Reads cost credits; campaign changes require a paid plan and your approval, and nothing spends without it.", "author": { "name": "Synter", "email": "joel@synterai.com" @@ -11,20 +11,67 @@ "homepage": "https://synterai.com", "repository": "https://github.com/Synter-Media-AI/plugin", "license": "MIT", - "logo": "assets/logo.png", + "logo": "assets/logo-opaque.png", + "category": "integrations", "keywords": [ - "ads", - "advertising", - "campaigns", - "audiences", - "media-buying", - "creative", - "roas", + "synter", + "synter ads", + "synterai", + "google ads", "google-ads", + "adwords", + "performance max", + "pmax", + "search ads", + "meta ads", + "facebook ads", + "instagram ads", "meta-ads", + "linkedin ads", "linkedin-ads", - "mcp", - "synter" + "b2b ads", + "reddit ads", + "reddit-ads", + "x ads", + "twitter ads", + "x-ads", + "tiktok ads", + "tiktok-ads", + "microsoft ads", + "bing ads", + "microsoft advertising", + "microsoft-ads", + "snapchat ads", + "snap ads", + "stackadapt", + "programmatic", + "programmatic advertising", + "native ads", + "ppc", + "paid media", + "paid social", + "paid search", + "media buying", + "campaign management", + "ad reporting", + "ad optimization", + "roas", + "cpa", + "cross-channel advertising", + "advertising", + "marketing", + "mcp" + ], + "tags": [ + "advertising", + "marketing", + "ppc", + "paid-social", + "paid-search", + "programmatic", + "analytics", + "campaigns", + "mcp" ], "skills": "./skills/", "agents": "./agents/", diff --git a/.mcp.json b/.mcp.json index c3ae094..eafd066 100644 --- a/.mcp.json +++ b/.mcp.json @@ -3,7 +3,7 @@ "synter": { "type": "http", "url": "https://mcp.synterai.com", - "description": "Synter Advertising Platform MCP \u2014 cross-channel ad management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." + "description": "Synter Advertising Platform MCP: cross-channel ad reporting and management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." } } } diff --git a/CHANGELOG.md b/CHANGELOG.md index 7c7e76b..4e4db99 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,13 @@ # Changelog +## [1.3.0] - Unreleased + +- Update Cursor Marketplace manifest with verified platform coverage across Google Ads, Meta, LinkedIn, Reddit, X, TikTok, Microsoft Ads, Snapchat, and StackAdapt. +- Clarify in Cursor Marketplace manifest that reads cost credits and that performance reporting on X and TikTok may require platform exports. +- Add `assets/logo-opaque.png` (1024x1024 solid #070806 dark background) for the Cursor Marketplace listing while preserving canonical `assets/logo.png`. +- Replace legacy syntermedia.ai domain references with synterai.com across user-facing documentation, submission evidence, and endpoint configuration. +- Align MCP HTTP client configurations across Cursor and Claude to the canonical `https://mcp.synterai.com` endpoint. + ## [1.2.1] - Unreleased - Add a portable OpenAI package targeting the existing Synter Ads MCP draft, diff --git a/CLAUDE_COMMUNITY_SUBMISSION.md b/CLAUDE_COMMUNITY_SUBMISSION.md index 7201ce2..04d952e 100644 --- a/CLAUDE_COMMUNITY_SUBMISSION.md +++ b/CLAUDE_COMMUNITY_SUBMISSION.md @@ -25,14 +25,14 @@ complementary catalogs. Do not treat connector review as plugin publication. | Public repository | `https://github.com/Synter-Media-AI/plugin` | | Plugin name | `synter` | | Publisher | Synter | -| Website | `https://syntermedia.ai` | +| Website | `https://synterai.com` | | License | MIT | | Category | Marketing and advertising | | Short description | Operate cross-channel advertising with approval-gated Synter agents, skills, and MCP tools. | | Brand icon | `assets/logo.png` — canonical transparent 1024×1024 Synter mark | -| Support | `https://syntermedia.ai/support` | -| Privacy policy | `https://syntermedia.ai/privacy` | -| Terms | `https://syntermedia.ai/terms` | +| Support | `https://synterai.com/support` | +| Privacy policy | `https://synterai.com/privacy` | +| Terms | `https://synterai.com/terms` | Suggested long description: @@ -105,7 +105,7 @@ Direct installation is not public-directory discovery. ## Security and data-use evidence - Claude invokes a Bash session hook that prints static guidance through `cat`. Cursor declares no hook. The repository also contains a manually invoked Node SDK runner and development scripts; no compiled binaries are bundled. -- Claude uses `https://mcp.syntermedia.ai` to match the connector under review. Cursor separately uses `https://mcp.synterai.com`. Both plugin configurations use browser OAuth without static credentials or headers. +- Claude and Cursor use `https://mcp.synterai.com`. Both plugin configurations use browser OAuth without static credentials or headers. - The session hook prints a static operating and approval-safety primer into session context; it does not read or transmit credentials. - Advertising writes are approval-gated. The bundled guidance does not turn a @@ -133,9 +133,9 @@ boundary before any external spend-changing action. | Requirement | Evidence | | --- | --- | | Public source and license | Public GitHub repository; MIT `LICENSE` | -| OAuth for authenticated remote MCP | OAuth metadata, DCR, PKCE, and protected-tool `401` challenge at `https://mcp.syntermedia.ai` | +| OAuth for authenticated remote MCP | OAuth metadata, DCR, PKCE, and protected-tool `401` challenge at `https://mcp.synterai.com` | | Tool directory | 34 checked-in tool names; live annotations require a fresh authenticated review | -| Privacy and support | `https://syntermedia.ai/privacy`; `https://syntermedia.ai/support` | +| Privacy and support | `https://synterai.com/privacy`; `https://synterai.com/support` | | Narrow, visible instructions | Human-readable skills and agents in this repository; no encoded or remotely loaded behavioral instructions | | Approval boundary | Spend-changing operations require explicit approval; a model response is not approval | | Test account | Must be supplied privately by Synter in the submission form | diff --git a/README.md b/README.md index 8242c90..6b6808f 100644 --- a/README.md +++ b/README.md @@ -14,7 +14,7 @@ The OpenAI package includes Synter skills and the hosted OAuth MCP connection. Its generated `mcp.json` declares OAuth with dynamic client registration under `mcpServers.synter.extensions.com.openai.auth`; discovery provides the endpoints. The portal displays these settings and does not provide an advanced OAuth editor. -The existing-draft archive is `dist/synter-openai-plugin-1.2.1.zip`, for +The existing-draft archive is `dist/synter-openai-plugin-1.3.0.zip`, for **Synter Ads MCP**. Its package identity remains `app-6a90dc5bbc3c819199b4f1e44028fcbf`. Uploading creates a draft; directory approval and publication are separate steps. This archive contains no lifecycle @@ -25,14 +25,14 @@ MCP app before updating its plugin ZIP,” while its connection settings are unavailable. A valid archive does not resolve that portal state. Verify the saved MCP origin before updating: OpenAI does not allow an origin change between versions. `bash scripts/build-zip.sh --include-new-draft` also prepares -`dist/synter-openai-new-draft-plugin-1.2.1.zip` with the canonical `synter` package +`dist/synter-openai-new-draft-plugin-1.3.0.zip` with the canonical `synter` package name for a separately authorized new draft if the existing identity cannot be recovered. Building it does not upload, register, or publish anything. ### Claude Desktop and Cowork Build the archives with `bash scripts/build-zip.sh`, then use Claude Desktop's -plugin upload to select `dist/synter-claude-plugin-1.2.1.zip`. The archive contains +plugin upload to select `dist/synter-claude-plugin-1.3.0.zip`. The archive contains the `.claude-plugin` manifest, OAuth configuration, skills, agents, and static session primer. Start a new conversation after updating and complete browser OAuth when prompted. Uploading a ZIP does not enable automatic GitHub updates. You can also add @@ -114,7 +114,7 @@ bash scripts/build-zip.sh The directory check scans every file under `skills/`, `commands/` (when present), `rules/`, and `agents/`, including prose, tables, and code fences. Spell out exact tool names; dynamic tool-name templates fail validation. Snake-case data fields are recognized separately, but calling them as functions still counts as a tool reference. For a tool name without underscores, use explicit `tool:name` or its MCP-qualified name. -The check runs offline in CI. To also compare the directory against live MCP `tools/list`, supply an OAuth access token through `SYNTER_MCP_TOKEN` in your environment and run the same script. It initializes an MCP session and follows paginated results. `--live` requires the token instead of silently running offline. `SYNTER_MCP_URL` optionally selects either hosted URL in the table; it defaults to the Cursor endpoint. The token is for this development check only and is never written to plugin configuration. Extra live tools do not expand the checked-in directory. +The check runs offline in CI. To also compare the directory against live MCP `tools/list`, supply an OAuth access token through `SYNTER_MCP_TOKEN` in your environment and run the same script. It initializes an MCP session and follows paginated results. `--live` requires the token instead of silently running offline. If set, `SYNTER_MCP_URL` must match the allow-listed endpoint (`https://mcp.synterai.com`, which is also the default); untrusted endpoints are rejected. The token is for this development check only and is never written to plugin configuration. Extra live tools do not expand the checked-in directory. [Terms](https://synterai.com/terms) · [MIT license](LICENSE) diff --git a/assets/logo-opaque-512.png b/assets/logo-opaque-512.png new file mode 100644 index 0000000..0989bc9 Binary files /dev/null and b/assets/logo-opaque-512.png differ diff --git a/assets/logo-opaque.png b/assets/logo-opaque.png new file mode 100644 index 0000000..3d4fcac Binary files /dev/null and b/assets/logo-opaque.png differ diff --git a/packages/claude-directory/.claude-plugin/plugin.json b/packages/claude-directory/.claude-plugin/plugin.json index 8004b46..668bd14 100644 --- a/packages/claude-directory/.claude-plugin/plugin.json +++ b/packages/claude-directory/.claude-plugin/plugin.json @@ -3,7 +3,7 @@ "name": "synter", "displayName": "Synter", "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", - "version": "1.2.1", + "version": "1.3.0", "license": "MIT", "author": { "name": "Synter", diff --git a/packages/claude-directory/.mcp.json b/packages/claude-directory/.mcp.json index c3ae094..eafd066 100644 --- a/packages/claude-directory/.mcp.json +++ b/packages/claude-directory/.mcp.json @@ -3,7 +3,7 @@ "synter": { "type": "http", "url": "https://mcp.synterai.com", - "description": "Synter Advertising Platform MCP \u2014 cross-channel ad management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." + "description": "Synter Advertising Platform MCP: cross-channel ad reporting and management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." } } } diff --git a/plugin.json b/plugin.json index 5f165a0..9310620 100644 --- a/plugin.json +++ b/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "synter", - "version": "1.2.1", + "version": "1.3.0", "description": "Plan and operate advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", "author": { "name": "Synter", diff --git a/scripts/check-directory-tools.js b/scripts/check-directory-tools.js index b7aee51..edf2c9c 100644 --- a/scripts/check-directory-tools.js +++ b/scripts/check-directory-tools.js @@ -15,7 +15,7 @@ const DATA_IDENTIFIERS = new Set([ ]); const ROOT = path.resolve(__dirname, '..'); const SURFACES = ['skills', 'commands', 'rules', 'agents']; -const ENDPOINTS = new Set(['https://mcp.synterai.com', 'https://mcp.syntermedia.ai']); +const ENDPOINTS = new Set(['https://mcp.synterai.com']); function extractReferences(source) { const refs = []; @@ -75,7 +75,7 @@ function scan(root = ROOT) { async function readLiveTools({ token, url = 'https://mcp.synterai.com', fetchImpl = fetch }) { if (!token) throw new Error('Live check requires SYNTER_MCP_TOKEN (an OAuth access token).'); - if (!ENDPOINTS.has(url)) throw new Error('Live check URL must be one of the two production Synter MCP endpoints.'); + if (!ENDPOINTS.has(url)) throw new Error('Live check URL must be the production Synter MCP endpoint (https://mcp.synterai.com).'); let session; let protocol = '2025-03-26'; let requestId = 0; diff --git a/scripts/test_build_packages.py b/scripts/test_build_packages.py index 08daf25..e4f5298 100644 --- a/scripts/test_build_packages.py +++ b/scripts/test_build_packages.py @@ -99,10 +99,10 @@ def test_directory_generated_source_detects_drift_and_symlinks(self): def test_archives_match_reviewed_rsa_correction_bytes(self): expected = { - 'claude': '72fecb572222d3725acd884f4d7f49a3f5493a2c084d4a4ee201a53a960aee73', - 'claude-directory': 'e313a4ed69ef3e2e80d13c622d102e69d8e6c51cfeb8f0ba13f29b2e0340efc1', - 'openai': '5ab905019791b7f0f71033e19e18042e26ba272b7b2d958aac4ff177a7c0f665', - 'openai-new-draft': '48bbdbedbc5eb96ffacfcd18b339048139ac6f67dbca160e5fd2d13b7682cd87', + 'claude': '8a4141f2e4b1fa0c965258fe03aadf7129525d48d2e9e6d0008b1f6e2cf63793', + 'claude-directory': 'dce25899dd00aa9ab95bf941e730203daf9689d5ece79571ec630f0010a245c7', + 'openai': '5cc8eac259294beed15f329cbc155afaab91bdeb3f564916f73517a8801216a0', + 'openai-new-draft': '554a7cdd3c8785932e15b876a6c2f0fe2da249d3ce10d4a68a45f318771ed3dd', } # Snapshot after the approved RSA/bidding correction across all hosts. # Update deliberately when reviewed package contents change.