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..803b0a3 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": { 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..358396d 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.pop('privacyPolicyUrl', None) 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 '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'}: 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..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,7 +58,16 @@ 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'}, + {'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 +109,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': '22daffe7aa0de8710718e9766d2c7341890196d537120bfc74dbcaa4600c44a6', '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)