Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -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."
}
]
}
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down
20 changes: 17 additions & 3 deletions config/claude-directory/README.md
Original file line number Diff line number Diff line change
@@ -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.

Expand All @@ -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.
2 changes: 1 addition & 1 deletion packages/claude-directory/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -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": {
Expand Down
4 changes: 2 additions & 2 deletions packages/claude-directory/.mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -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."
}
}
}
20 changes: 17 additions & 3 deletions packages/claude-directory/README.md
Original file line number Diff line number Diff line change
@@ -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.

Expand All @@ -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.
15 changes: 13 additions & 2 deletions scripts/build-packages.py
Original file line number Diff line number Diff line change
Expand Up @@ -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())
Expand Down Expand Up @@ -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)
Expand Down Expand Up @@ -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:
Expand Down
2 changes: 1 addition & 1 deletion scripts/check-directory-tools.js
Original file line number Diff line number Diff line change
Expand Up @@ -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 = [];
Expand Down
17 changes: 14 additions & 3 deletions scripts/test_build_packages.py
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand All @@ -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}})})
Expand Down Expand Up @@ -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)
Expand Down
Loading