From 4a4f60040e3ad83e8229df8ab5b033dca7f1d5db Mon Sep 17 00:00:00 2001 From: Joel Horwitz Date: Mon, 2 Nov 2026 19:58:17 -0800 Subject: [PATCH 1/2] fix(claude-directory): point bundle at curated /mcp/directory endpoint, 30+ copy, pricing, privacy URL - packages/claude-directory/.mcp.json now targets https://mcp.synterai.com/mcp/directory, the curated connector surface that serves only reviewed tools to every client (Synter-Media-AI/synter-media #13147). The full-catalog root .mcp.json is unchanged for direct installs. - build-packages.py generates and validates that URL and adds privacyPolicyUrl (claude plugin validate note PRIVACY_URL_MISSING). - Manifest + marketplace description: "on 30+ ad platforms" (owner decision 2026-11-03). - Directory README: 30+ claim, install line, owner-approved pricing copy, support and security contacts. - Reviewed archive digests updated deliberately for these content changes. Co-Authored-By: Claude Opus 5.5 --- .claude-plugin/marketplace.json | 2 +- .claude-plugin/plugin.json | 2 +- config/claude-directory/README.md | 20 ++++++++++++++++--- .../.claude-plugin/plugin.json | 5 +++-- packages/claude-directory/.mcp.json | 4 ++-- packages/claude-directory/README.md | 20 ++++++++++++++++--- scripts/build-packages.py | 17 +++++++++++++--- scripts/check-directory-tools.js | 2 +- scripts/test_build_packages.py | 10 +++++++--- 9 files changed, 63 insertions(+), 19 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 7c0785b..9a091b5 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -10,7 +10,7 @@ { "name": "synter", "source": "./", - "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." + "description": "Plan and operate advertising campaigns on 30+ ad platforms through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution." } ] } diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 8ca4331..baabd0d 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -2,7 +2,7 @@ "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json", "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.", + "description": "Plan and operate advertising campaigns on 30+ ad platforms through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", "version": "1.2.1", "license": "MIT", "author": { diff --git a/config/claude-directory/README.md b/config/claude-directory/README.md index dfae0cd..a0dadff 100644 --- a/config/claude-directory/README.md +++ b/config/claude-directory/README.md @@ -1,8 +1,8 @@ # Synter -Synter helps you review advertising performance, prepare campaign plans, write ad copy, and approve changes through its hosted MCP service. Start with the quickstart skill, sign in through the browser OAuth prompt, and verify the connected workspace and advertising account before using account data. +Synter executes approval-gated advertising campaigns on 30+ ad platforms. This plugin helps you review performance, prepare campaign plans, write ad copy, and approve changes through Synter's hosted MCP service. Start with the quickstart skill, sign in through the browser OAuth prompt, and verify the connected workspace and advertising account before using account data. -This directory package includes 56 Markdown skills, six agent instructions, an output style, and static [brand and safety guidance](context/brand-and-safety.md). Its only service connection is the remote HTTPS MCP server declared in `.mcp.json`. It contains no local lifecycle hooks, executable scripts, or SDK runner. Tool availability follows the bundled [tool directory](tools/directory-tools.json) and the live server schema. +This directory package includes 56 Markdown skills, six agent instructions, an output style, and static [brand and safety guidance](context/brand-and-safety.md). Its only service connection is the remote HTTPS MCP server declared in `.mcp.json` (`https://mcp.synterai.com/mcp/directory`, Synter's reviewed connector surface). It contains no local lifecycle hooks, executable scripts, or SDK runner. Tool availability follows the bundled [tool directory](tools/directory-tools.json) and the live server schema. Read-only account lookups and reports can run directly. Before any campaign creation, activation, pause, budget adjustment, or other spend-changing action, review the proposed account, scope, and amounts and give explicit approval. After execution, check the provider readback before treating a change as complete. Use the verified advertiser's brand and original assets; do not substitute Synter's branding for another advertiser. @@ -17,4 +17,18 @@ flowchart LR Tool arguments and account results pass through Synter's hosted service and the connected advertising provider. Never paste passwords, API keys, or access tokens into chat. Sample data must be identified as sample data; missing account access or unavailable metrics must be reported plainly. Read [Synter's privacy policy](https://synterai.com/privacy) for data handling and [terms](https://synterai.com/terms) for service conditions. -For help, use the help skill or [contact Synter](https://synterai.com/contact). This folder is generated from reviewed repository sources and is intended for the Claude directory submission path `packages/claude-directory`. Directory approval and publication are separate from local package validation. The source is distributed under the included MIT license. +## Install + +In Claude Code, add Synter's marketplace and install the plugin, then complete the browser OAuth prompt: + +```text +/plugin install synter --marketplace Synter-Media-AI/plugin +``` + +## Pricing + +Reading your own ad accounts is free. Actions start at $0.25. Audiences, creative and other add-ons are priced per use. $20/month minimum. You need a Synter account at [synterai.com](https://synterai.com) and at least one connected advertising account. + +## Support and security + +For help, use the help skill, see [Synter support](https://synterai.com/support), or email support@syntermedia.ai. Report security issues to security@synterai.com. This folder is generated from reviewed repository sources and is intended for the Claude directory submission path `packages/claude-directory`. Directory approval and publication are separate from local package validation. The source is distributed under the included MIT license. diff --git a/packages/claude-directory/.claude-plugin/plugin.json b/packages/claude-directory/.claude-plugin/plugin.json index 8004b46..f5838d1 100644 --- a/packages/claude-directory/.claude-plugin/plugin.json +++ b/packages/claude-directory/.claude-plugin/plugin.json @@ -2,7 +2,7 @@ "$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json", "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.", + "description": "Plan and operate advertising campaigns on 30+ ad platforms through Synter’s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.", "version": "1.2.1", "license": "MIT", "author": { @@ -25,5 +25,6 @@ "linkedin-ads", "mcp", "synter" - ] + ], + "privacyPolicyUrl": "https://synterai.com/privacy" } diff --git a/packages/claude-directory/.mcp.json b/packages/claude-directory/.mcp.json index c3ae094..22d6ea8 100644 --- a/packages/claude-directory/.mcp.json +++ b/packages/claude-directory/.mcp.json @@ -2,8 +2,8 @@ "mcpServers": { "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." + "url": "https://mcp.synterai.com/mcp/directory", + "description": "Synter Advertising Platform MCP — cross-channel ad management for AI agents. Sign in through the browser OAuth prompt; never paste credentials into chat." } } } diff --git a/packages/claude-directory/README.md b/packages/claude-directory/README.md index dfae0cd..a0dadff 100644 --- a/packages/claude-directory/README.md +++ b/packages/claude-directory/README.md @@ -1,8 +1,8 @@ # Synter -Synter helps you review advertising performance, prepare campaign plans, write ad copy, and approve changes through its hosted MCP service. Start with the quickstart skill, sign in through the browser OAuth prompt, and verify the connected workspace and advertising account before using account data. +Synter executes approval-gated advertising campaigns on 30+ ad platforms. This plugin helps you review performance, prepare campaign plans, write ad copy, and approve changes through Synter's hosted MCP service. Start with the quickstart skill, sign in through the browser OAuth prompt, and verify the connected workspace and advertising account before using account data. -This directory package includes 56 Markdown skills, six agent instructions, an output style, and static [brand and safety guidance](context/brand-and-safety.md). Its only service connection is the remote HTTPS MCP server declared in `.mcp.json`. It contains no local lifecycle hooks, executable scripts, or SDK runner. Tool availability follows the bundled [tool directory](tools/directory-tools.json) and the live server schema. +This directory package includes 56 Markdown skills, six agent instructions, an output style, and static [brand and safety guidance](context/brand-and-safety.md). Its only service connection is the remote HTTPS MCP server declared in `.mcp.json` (`https://mcp.synterai.com/mcp/directory`, Synter's reviewed connector surface). It contains no local lifecycle hooks, executable scripts, or SDK runner. Tool availability follows the bundled [tool directory](tools/directory-tools.json) and the live server schema. Read-only account lookups and reports can run directly. Before any campaign creation, activation, pause, budget adjustment, or other spend-changing action, review the proposed account, scope, and amounts and give explicit approval. After execution, check the provider readback before treating a change as complete. Use the verified advertiser's brand and original assets; do not substitute Synter's branding for another advertiser. @@ -17,4 +17,18 @@ flowchart LR Tool arguments and account results pass through Synter's hosted service and the connected advertising provider. Never paste passwords, API keys, or access tokens into chat. Sample data must be identified as sample data; missing account access or unavailable metrics must be reported plainly. Read [Synter's privacy policy](https://synterai.com/privacy) for data handling and [terms](https://synterai.com/terms) for service conditions. -For help, use the help skill or [contact Synter](https://synterai.com/contact). This folder is generated from reviewed repository sources and is intended for the Claude directory submission path `packages/claude-directory`. Directory approval and publication are separate from local package validation. The source is distributed under the included MIT license. +## Install + +In Claude Code, add Synter's marketplace and install the plugin, then complete the browser OAuth prompt: + +```text +/plugin install synter --marketplace Synter-Media-AI/plugin +``` + +## Pricing + +Reading your own ad accounts is free. Actions start at $0.25. Audiences, creative and other add-ons are priced per use. $20/month minimum. You need a Synter account at [synterai.com](https://synterai.com) and at least one connected advertising account. + +## Support and security + +For help, use the help skill, see [Synter support](https://synterai.com/support), or email support@syntermedia.ai. Report security issues to security@synterai.com. This folder is generated from reviewed repository sources and is intended for the Claude directory submission path `packages/claude-directory`. Directory approval and publication are separate from local package validation. The source is distributed under the included MIT license. diff --git a/scripts/build-packages.py b/scripts/build-packages.py index e835688..d36046e 100644 --- a/scripts/build-packages.py +++ b/scripts/build-packages.py @@ -15,6 +15,12 @@ # schema does not yet accept server extensions. Keep the base independent. OPENAI_AUTH = {'type': 'oauth', 'client': {'mode': 'dcr'}} +# The directory bundle points at Synter's curated directory endpoint, which +# serves only the reviewed connector tool surface to every client (claude.ai, +# Desktop, Claude Code). It is the same URL submitted as the MCP connector. +DIRECTORY_MCP_URL = 'https://mcp.synterai.com/mcp/directory' +DIRECTORY_PRIVACY_URL = 'https://synterai.com/privacy' + def validate_openai_mcp(value): base = json.loads((ROOT / 'mcp.json').read_text()) @@ -56,8 +62,11 @@ def include(relative): include('scripts/session-context.sh') elif target == 'claude-directory': manifest.pop('hooks', None) + manifest['privacyPolicyUrl'] = DIRECTORY_PRIVACY_URL files['.claude-plugin/plugin.json'] = encoded(manifest) - include('.mcp.json') + directory_mcp = json.loads((root / '.mcp.json').read_text()) + directory_mcp['mcpServers']['synter']['url'] = DIRECTORY_MCP_URL + files['.mcp.json'] = encoded(directory_mcp) for source, destination in [('README.md', 'README.md'), ('help.md', 'skills/help/SKILL.md')]: path = root / 'config/claude-directory' / source relative_path = path.relative_to(root) @@ -102,13 +111,15 @@ def validate_claude_directory(files): manifest = json.loads(files['.claude-plugin/plugin.json']) if 'hooks' in manifest: raise ValueError('Directory manifest must not declare hooks') + if manifest.get('privacyPolicyUrl') != DIRECTORY_PRIVACY_URL: + raise ValueError('Directory manifest must declare the Synter privacy policy URL') if set(manifest) - {'$schema', 'name', 'displayName', 'description', 'version', 'license', - 'author', 'homepage', 'repository', 'keywords'}: + 'author', 'homepage', 'repository', 'keywords', 'privacyPolicyUrl'}: raise ValueError('Unreviewed directory manifest capability') servers = json.loads(files['.mcp.json']).get('mcpServers', {}) if (set(servers) != {'synter'} or set(servers['synter']) != {'type', 'url', 'description'} or servers['synter']['type'] != 'http' - or servers['synter']['url'] != 'https://mcp.synterai.com' + or servers['synter']['url'] != DIRECTORY_MCP_URL or not isinstance(servers['synter']['description'], str)): raise ValueError('Directory supports only the declared remote HTTPS MCP server') if len(files['README.md'].decode().split()) < 40: diff --git a/scripts/check-directory-tools.js b/scripts/check-directory-tools.js index b7aee51..fcea814 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', 'https://mcp.synterai.com/mcp/directory', 'https://mcp.syntermedia.ai']); function extractReferences(source) { const refs = []; diff --git a/scripts/test_build_packages.py b/scripts/test_build_packages.py index 08daf25..23b096d 100644 --- a/scripts/test_build_packages.py +++ b/scripts/test_build_packages.py @@ -57,7 +57,10 @@ def test_directory_rejects_local_execution_and_unknown_files(self): changed['.claude-plugin/plugin.json'] = mod.encoded(manifest) with self.assertRaises(ValueError): mod.validate_claude_directory(changed) + self.assertEqual(json.loads(files['.mcp.json'])['mcpServers']['synter']['url'], mod.DIRECTORY_MCP_URL) + self.assertEqual(mod.DIRECTORY_MCP_URL, 'https://mcp.synterai.com/mcp/directory') for server in [{'command': 'node'}, {'type': 'http', 'url': 'https://other.example', 'description': 'test'}, + {'type': 'http', 'url': 'https://mcp.synterai.com', 'description': 'full catalog, not the directory surface'}, {'type': 'http', 'url': 'https://mcp.synterai.com', 'description': 'test', 'headers': {'x-key': 'fake'}}]: with self.subTest(server=server), self.assertRaises(ValueError): mod.validate_claude_directory({**files, '.mcp.json': mod.encoded({'mcpServers': {'synter': server}})}) @@ -99,12 +102,13 @@ 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', + 'claude': '258e638fc31d338aebb3b9057ccd32f8aaf35572175993ad7c68ce42d4aff64b', + 'claude-directory': '36f363157d4502a28df5b70a4c241f148595e674db9036f74f29d7a1527b23d9', 'openai': '5ab905019791b7f0f71033e19e18042e26ba272b7b2d958aac4ff177a7c0f665', 'openai-new-draft': '48bbdbedbc5eb96ffacfcd18b339048139ac6f67dbca160e5fd2d13b7682cd87', } - # Snapshot after the approved RSA/bidding correction across all hosts. + # Snapshot after the approved RSA/bidding correction across all hosts, + # then the 30+ description and /mcp/directory endpoint (2026-11-03). # Update deliberately when reviewed package contents change. for target, digest in expected.items(): _, files = mod.collect(mod.ROOT, target) From 48541fa56302043d3bf54b240c18cb3ea6656683 Mon Sep 17 00:00:00 2001 From: Joel Horwitz Date: Wed, 4 Nov 2026 11:34:55 -0800 Subject: [PATCH 2/2] fix(claude-directory): stop emitting privacyPolicyUrl in Claude package to pass strict validation - Claude Code plugin validate --strict rejects privacyPolicyUrl as an unknown field - The privacy URL (https://synterai.com/privacy) belongs in the Claude listing submission form instead - Update build-packages.py, test assertions, and reviewed archive digest Amp-Thread-ID: https://ampcode.com/threads/T-01a1a808-f80b-758b-a839-b5b8e1ecdde3 Co-authored-by: Amp --- packages/claude-directory/.claude-plugin/plugin.json | 3 +-- scripts/build-packages.py | 8 ++++---- scripts/test_build_packages.py | 9 ++++++++- 3 files changed, 13 insertions(+), 7 deletions(-) diff --git a/packages/claude-directory/.claude-plugin/plugin.json b/packages/claude-directory/.claude-plugin/plugin.json index f5838d1..803b0a3 100644 --- a/packages/claude-directory/.claude-plugin/plugin.json +++ b/packages/claude-directory/.claude-plugin/plugin.json @@ -25,6 +25,5 @@ "linkedin-ads", "mcp", "synter" - ], - "privacyPolicyUrl": "https://synterai.com/privacy" + ] } diff --git a/scripts/build-packages.py b/scripts/build-packages.py index d36046e..358396d 100644 --- a/scripts/build-packages.py +++ b/scripts/build-packages.py @@ -62,7 +62,7 @@ def include(relative): include('scripts/session-context.sh') elif target == 'claude-directory': manifest.pop('hooks', None) - manifest['privacyPolicyUrl'] = DIRECTORY_PRIVACY_URL + manifest.pop('privacyPolicyUrl', None) files['.claude-plugin/plugin.json'] = encoded(manifest) directory_mcp = json.loads((root / '.mcp.json').read_text()) directory_mcp['mcpServers']['synter']['url'] = DIRECTORY_MCP_URL @@ -111,10 +111,10 @@ def validate_claude_directory(files): manifest = json.loads(files['.claude-plugin/plugin.json']) if 'hooks' in manifest: raise ValueError('Directory manifest must not declare hooks') - if manifest.get('privacyPolicyUrl') != DIRECTORY_PRIVACY_URL: - raise ValueError('Directory manifest must declare the Synter privacy policy URL') + if 'privacyPolicyUrl' in manifest: + raise ValueError('Directory manifest must not declare privacyPolicyUrl; provide in listing form') if set(manifest) - {'$schema', 'name', 'displayName', 'description', 'version', 'license', - 'author', 'homepage', 'repository', 'keywords', 'privacyPolicyUrl'}: + 'author', 'homepage', 'repository', 'keywords'}: raise ValueError('Unreviewed directory manifest capability') servers = json.loads(files['.mcp.json']).get('mcpServers', {}) if (set(servers) != {'synter'} or set(servers['synter']) != {'type', 'url', 'description'} diff --git a/scripts/test_build_packages.py b/scripts/test_build_packages.py index 23b096d..c71e62c 100644 --- a/scripts/test_build_packages.py +++ b/scripts/test_build_packages.py @@ -36,6 +36,7 @@ def test_directory_source_is_reproducible_and_has_only_static_runtime(self): self.assertEqual(sum(name.endswith('/SKILL.md') for name in files), 56) self.assertEqual(sum(name.startswith('agents/') for name in files), 6) self.assertNotIn('hooks', json.loads(files['.claude-plugin/plugin.json'])) + self.assertNotIn('privacyPolicyUrl', json.loads(files['.claude-plugin/plugin.json'])) self.assertEqual(files['assets/logo.png'], (mod.ROOT / 'assets/logo.png').read_bytes()) self.assertNotIn(b'SessionStart shell hook', files['skills/help/SKILL.md']) for name in files: @@ -57,6 +58,12 @@ def test_directory_rejects_local_execution_and_unknown_files(self): changed['.claude-plugin/plugin.json'] = mod.encoded(manifest) with self.assertRaises(ValueError): mod.validate_claude_directory(changed) + changed_privacy = dict(files) + manifest_privacy = json.loads(files['.claude-plugin/plugin.json']) + manifest_privacy['privacyPolicyUrl'] = 'https://synterai.com/privacy' + changed_privacy['.claude-plugin/plugin.json'] = mod.encoded(manifest_privacy) + with self.assertRaises(ValueError): + mod.validate_claude_directory(changed_privacy) self.assertEqual(json.loads(files['.mcp.json'])['mcpServers']['synter']['url'], mod.DIRECTORY_MCP_URL) self.assertEqual(mod.DIRECTORY_MCP_URL, 'https://mcp.synterai.com/mcp/directory') for server in [{'command': 'node'}, {'type': 'http', 'url': 'https://other.example', 'description': 'test'}, @@ -103,7 +110,7 @@ def test_directory_generated_source_detects_drift_and_symlinks(self): def test_archives_match_reviewed_rsa_correction_bytes(self): expected = { 'claude': '258e638fc31d338aebb3b9057ccd32f8aaf35572175993ad7c68ce42d4aff64b', - 'claude-directory': '36f363157d4502a28df5b70a4c241f148595e674db9036f74f29d7a1527b23d9', + 'claude-directory': '22daffe7aa0de8710718e9766d2c7341890196d537120bfc74dbcaa4600c44a6', 'openai': '5ab905019791b7f0f71033e19e18042e26ba272b7b2d958aac4ff177a7c0f665', 'openai-new-draft': '48bbdbedbc5eb96ffacfcd18b339048139ac6f67dbca160e5fd2d13b7682cd87', }