Skip to content
Open
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": "./packages/claude-directory",
"description": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 43 ad platforms over OAuth."
"description": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 30+ ad platforms over OAuth."
}
]
}
4 changes: 2 additions & 2 deletions .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
"name": "synter",
"displayName": "Synter",
"description": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 43 ad platforms over OAuth.",
"version": "1.3.2",
"description": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 30+ ad platforms over OAuth.",
"version": "1.3.3",
"license": "MIT",
"author": {
"name": "Synter",
Expand Down
4 changes: 2 additions & 2 deletions .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,14 +6,14 @@
},
"metadata": {
"description": "Synter's official plugin marketplace. The AI Agent Operator for Ads.",
"version": "1.3.2"
"version": "1.3.3"
},
"plugins": [
{
"name": "synter",
"source": ".",
"logo": "assets/logo.png",
"description": "Free, read-only Synter MCP plugin for Cursor. Review ad performance and account health across 43 ad platforms over OAuth. No create, update, launch, or spend tools in this listing."
"description": "Free, read-only Synter MCP plugin for Cursor. Review ad performance and account health across 30+ ad platforms over OAuth. No create, update, launch, or spend tools in this listing."
}
]
}
4 changes: 2 additions & 2 deletions .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
"$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
"name": "synter",
"displayName": "Synter",
"version": "1.3.2",
"description": "Free, read-only Synter MCP plugin for Cursor. Review ad performance and account health across 43 ad platforms over OAuth. No create, update, launch, or spend tools in this listing.",
"version": "1.3.3",
"description": "Free, read-only Synter MCP plugin for Cursor. Review ad performance and account health across 30+ ad platforms over OAuth. No create, update, launch, or spend tools in this listing.",
"author": {
"name": "Synter",
"email": "joel@synterai.com"
Expand Down
7 changes: 7 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,13 @@

## [1.3.3] - Unreleased

### Changed
- Claude Directory tool list now matches the read-only `/mcp/directory` profile (83 tools). Write tools such as `execute_campaign_plan`, `enable_campaign`, and `action_card` are no longer listed.
- Skills no longer mention write tools that the directory surface does not serve.
- Marketplace and plugin copy now uses the official “30+ ad platforms” claim, and the Claude Directory README, help skill, and root plugin.json no longer describe write, approval, or spend-changing actions.
- `check-directory-tools.js --live` defaults to `https://mcp.synterai.com/mcp/directory` and fails on unexpected tools or tools missing `title` / `readOnlyHint` / `destructiveHint`.
- Removed `optimize_budget` (`@destructive_tool`) from `tools/readonly-tools.json`.

### Fixed
- Moved `outbound`, `outbound-research`, and `outbound-replies` out of the
shipped `skills/` tree (now under `skills-write/`) so the Cursor Marketplace
Expand Down
127 changes: 72 additions & 55 deletions CLAUDE_COMMUNITY_SUBMISSION.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,16 @@
# Claude plugin directory submission

Prepared: 2026-09-06
Prepared: 2026-11-17

This is the reviewer-ready package for the public Synter plugin repository.
Synter's separate remote MCP connector submission is in review; that does not
submit or publish this plugin in Anthropic's plugin directory.
This is the reviewer-ready copy for the public Synter plugin repository.
The Claude Directory package lives at `packages/claude-directory`. It is a
free, read-only listing: 83 hosted MCP tools, 27 skills, and 3 agent
instructions, with browser OAuth sign-in to Synter's `/mcp/directory`
endpoint. Do not merge or publish this listing until the matching
`/mcp/directory` profile is live in production (synter-media #14019).

Synter's separate remote MCP connector submission is in review; that does
not submit or publish this plugin in Anthropic's plugin directory.

## Current directory status

Expand All @@ -23,23 +29,28 @@ complementary catalogs. Do not treat connector review as plugin publication.
| Field | Value |
| --- | --- |
| Public repository | `https://github.com/Synter-Media-AI/plugin` |
| Marketplace source | `packages/claude-directory` |
| Plugin name | `synter` |
| Version | `1.3.3` |
| 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. |
| Short description | Free, read-only Synter skills and MCP connector. Review performance, audiences, and plans across 30+ ad platforms over OAuth. |
| 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/contact` |
| Privacy policy | `https://synterai.com/privacy` |
| Terms | `https://synterai.com/terms` |
| MCP endpoint | `https://mcp.synterai.com/mcp/directory` |

Suggested long description:

> Synter is an AI agent operator for cross-channel advertising. The plugin
> combines campaign planning, audience, creative, measurement, reporting, and
> optimization skills with Synter's hosted MCP tool surface. Users connect
> their own advertising accounts and explicitly approve spend-changing actions.
> Synter is a free, read-only plugin for reviewing advertising performance,
> audiences, and campaign plans across 30+ ad platforms. It connects to
> Synter's hosted MCP service over browser OAuth. Users sign in, verify the
> connected workspace and advertising accounts, and use the 83-tool
> `/mcp/directory` surface for lookups and reports. This listing does not
> include tools that create, update, or change campaigns.

## Canonical installation

Expand All @@ -50,9 +61,9 @@ Direct installation from Synter's marketplace:
/plugin install synter@synter
```

After Anthropic approves and publishes the community-directory listing, Claude
Code users add Anthropic's community marketplace and install Synter from its
published `claude-community` catalog:
After Anthropic publishes the community-directory listing, Claude Code users
add Anthropic's community marketplace and install Synter from its published
`claude-community` catalog:

```text
/plugin marketplace add anthropics/claude-plugins-community
Expand All @@ -74,27 +85,31 @@ Direct installation is not public-directory discovery.
- [x] Repository is public and contains an MIT license.
- [x] `.claude-plugin/plugin.json` names the plugin `synter` and points to the
canonical public repository.
- [x] `.claude-plugin/marketplace.json` references the repository root.
- [x] Marketplace source for this listing is `packages/claude-directory`.
- [x] `assets/logo.png` is the canonical transparent 1024×1024 Synter mark,
ready to supply if the authenticated directory form requests brand artwork.
- [x] No unsupported `icon` or `logo` key was added to the Claude manifest;
Anthropic's current strict schema has no such field. The Cursor manifest's
supported `logo` field points to this asset.
- [x] `.mcp.json` uses the production HTTPS MCP endpoint and secure browser
OAuth; it contains no static key, token, custom auth header, or credential
prompt.
- [x] `packages/claude-directory/.mcp.json` uses
`https://mcp.synterai.com/mcp/directory` and secure browser OAuth; it
contains no static key, token, custom auth header, or credential prompt.
- [x] The directory package contains no local lifecycle hooks, executable
scripts, or SDK runner.
- [x] README installation commands match the authoritative marketplace
manifest and production Synter documentation.
- [x] `node scripts/validate-manifests.js` passes.
- [x] `npx -y @anthropic-ai/claude-code plugin validate . --strict` prints
`✔ Validation passed` on 2026-09-06.
- [x] Production OAuth protected-resource and authorization-server metadata
return `200`; a protected tool call returns `401` with a
`WWW-Authenticate` resource-metadata challenge.
- [ ] Run the optional live directory check with reviewer-authorized OAuth before submission; the checked-in directory contains 34 tools.
- [ ] Re-inventory the updated package: 52 skills, 6 agents, one Claude session hook, and one remote MCP server per client.
- [ ] Provider reviewer exercises `/synter:quickstart`, one read-only report,
and one write preview without approving the write.
- [x] `node scripts/check-directory-tools.js` checks instruction files
against the 83-name `tools/directory-tools.json` allowlist.
- [x] `node scripts/check-directory-tools.js --live` defaults to
`/mcp/directory` and rejects unexpected tools or missing `title` /
`readOnlyHint` / `destructiveHint` annotations.
- [x] Official listing copy uses “30+ ad platforms,” not a counted platform
total.
- [ ] Run the optional live directory check with reviewer-authorized OAuth
before submission.
- [ ] Provider reviewer exercises `/synter:quickstart`, confirms OAuth
sign-in, and runs a read-only report against sample data.
- [ ] Provider reviewer uses a Synter-owned test workspace with sample data;
reviewer credentials must be delivered through Anthropic's private form,
never committed to this repository.
Expand All @@ -104,46 +119,48 @@ 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.
- 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
model response into approval and does not bypass provider permissions.
- Source, manifests, skills, agents, hooks, and output styles are inspectable in
the public repository.
- Synter's privacy policy, terms, and support channel are public and linked from
the README.
- The Claude Directory package is static instructions plus the declared remote
HTTPS MCP connection. It contains no local hooks, compiled binaries, or
bundled runners.
- The listing connects to `https://mcp.synterai.com/mcp/directory` with browser
OAuth and no static credentials or headers. Users sign in through the OAuth
prompt and verify the workspace before using account data.
- The published tool surface is the 83-name read-only directory allowlist.
Tools that create, update, or change campaigns are not included.
- Source, manifests, skills, agents, and output styles are inspectable in the
public repository.
- Synter's privacy policy, terms, and support channel are public and linked
from the README.

## Reviewer prompts

Use a Synter-owned test workspace with synthetic/sample campaign data. Do not
approve or execute production spend.
Use a Synter-owned test workspace with synthetic or sample campaign data.

1. `Use Synter to list my connected ad accounts and identify the workspace.`
2. `Report sample campaign spend and conversions for the last seven days. Read only; do not change anything.`
3. `Draft a paused cross-platform campaign and show the exact account, budget, and changes that would require my approval. Do not execute.`
1. `Use Synter to sign in over OAuth, list my connected ad accounts, and identify the workspace.`
2. `Report sample campaign performance and conversions for the last seven days. Read only; do not change anything.`
3. `Review the current campaign plan and account health for this workspace.`

Expected safety behavior: the first two prompts perform only reads. The third
produces a reviewable plan or paused draft and stops at the explicit approval
boundary before any external spend-changing action.
Expected behavior: all three prompts perform only reads against the
`/mcp/directory` tool surface. Unavailable accounts or metrics should be
reported plainly. Sample data must be identified as sample data.

## Directory policy evidence

| 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` |
| 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` |
| OAuth for authenticated remote MCP | Browser OAuth at `https://mcp.synterai.com/mcp/directory`; metadata, DCR, PKCE, and protected-tool `401` challenge |
| Tool directory | 83 checked-in read-only tool names in `tools/directory-tools.json`; live annotations require a fresh authenticated review |
| Platform claim | Official copy is “30+ ad platforms” |
| Privacy and support | `https://synterai.com/privacy`; `https://synterai.com/contact` |
| 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 |
| Read-only listing | Directory package and tool allowlist contain only lookup and report tools |
| Test account | Must be supplied privately by Synter in the submission form |

The plugin manages advertising workflows, writes text ads, and selects existing assets. The submission must describe those capabilities accurately. Anthropic retains
This listing helps reviewers inspect advertising performance, audiences, and
plans. Describe those read-only capabilities accurately. Anthropic retains
discretion under the Software Directory Policy's unsupported-use restrictions;
do not claim acceptance or an Anthropic Verified status before it appears in
the directory.
do not claim an Anthropic Verified status before it appears in the directory.

## Provider-side plugin action still required

Expand All @@ -156,4 +173,4 @@ private reviewer test account. Use one of:
- `https://platform.claude.com/plugins/submit`

No pull request to Anthropic's read-only community catalog is required or
accepted; approved entries are synchronized from Anthropic's review pipeline.
accepted; published entries are synchronized from Anthropic's review pipeline.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

# Synter plugin

This Cursor Marketplace listing is a **free, read-only** Synter plugin. It connects to Synter's hosted MCP over browser OAuth so you can review ad performance and account health across 43 ad platforms. It does **not** create, update, launch, or spend. Paid write and launch tools live in the full Synter product — see https://synterai.com/pricing (no plan prices in this listing).
This Cursor Marketplace listing is a **free, read-only** Synter plugin. It connects to Synter's hosted MCP over browser OAuth so you can review ad performance and account health across 30+ ad platforms. It does **not** create, update, launch, or spend. Paid write and launch tools live in the full Synter product — see https://synterai.com/pricing (no plan prices in this listing).

## Install and sign in

Expand Down
4 changes: 2 additions & 2 deletions config/claude-directory/README.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
# 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 helps you review advertising performance and campaign plans 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.

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.

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.
This listing is read-only: account lookups and reports can run directly. It does not create, activate, pause, or change campaign budgets. Use the verified advertiser's brand and original assets; do not substitute Synter's branding for another advertiser.

```mermaid
flowchart LR
Expand Down
4 changes: 2 additions & 2 deletions config/claude-directory/help.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,8 +7,8 @@ description: Explain the bundled skills, supported MCP tools, OAuth setup, and s

This plugin connects to Synter's hosted advertising service over OAuth. Use **quickstart** to sign in and **connect** to verify accounts.

Use **report** and **attribution** to review performance, **media-plan** and **launch** to prepare approved campaign changes, **audience** to inspect targeting, and **ad-copy-generation** to write text for the verified advertiser. Read [brand and safety guidance](../../context/brand-and-safety.md) before writing copy or proposing spend.
Use **report** and **attribution** to review performance, **media-plan** to review campaign plans, and **audience** to inspect targeting. Read [brand and safety guidance](../../context/brand-and-safety.md) before using account data.

This directory package uses static instructions and the declared remote MCP connection. Account operations run through Synter MCP tools. Use only tools in the bundled [tool directory](../../tools/directory-tools.json) and the live server schema; report unavailable capabilities plainly. Confirm the workspace and account, obtain explicit approval for spend-changing actions, and verify provider readback before claiming completion.
This directory package uses static instructions and the declared remote MCP connection. Account lookups and reports run through Synter MCP tools. Use only tools in the bundled [tool directory](../../tools/directory-tools.json) and the live server schema; report unavailable capabilities plainly. Confirm the workspace and account, and verify results against the returned tool data before claiming completion.

[Privacy](https://synterai.com/privacy) · [Support](https://synterai.com/contact)
4 changes: 2 additions & 2 deletions packages/claude-directory/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,8 +2,8 @@
"$schema": "https://json.schemastore.org/claude-code-plugin-manifest.json",
"name": "synter",
"displayName": "Synter",
"description": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 43 ad platforms over OAuth.",
"version": "1.3.2",
"description": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 30+ ad platforms over OAuth.",
"version": "1.3.3",
"license": "MIT",
"author": {
"name": "Synter",
Expand Down
Loading
Loading