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."
}
]
}
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": "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",
"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.3.0",
"license": "MIT",
"author": {
"name": "Synter",
Expand Down
3 changes: 2 additions & 1 deletion .cursor-mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -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."
}
}
}
4 changes: 2 additions & 2 deletions .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -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."
}
]
Expand Down
73 changes: 60 additions & 13 deletions .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,30 +1,77 @@
{
"$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"
},
"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/",
Expand Down
2 changes: 2 additions & 0 deletions .github/workflows/directory-tools.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,5 +19,7 @@ jobs:
node-version: '20'
- name: Check instruction tool references
run: node scripts/check-directory-tools.js
- name: Check skill tool references against hosted tools
run: node scripts/check-skill-tools.mjs
- name: Test repository validators
run: node --test scripts/*.test.js
3 changes: 3 additions & 0 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,6 +19,9 @@ jobs:
- name: Run manifest validation
run: node scripts/validate-manifests.js

- name: Check skill tool references against hosted tools
run: node scripts/check-skill-tools.mjs

- name: Run strict Claude plugin validation
run: |
npx -y @anthropic-ai/claude-code@2.1.263 plugin validate . --strict
Expand Down
2 changes: 1 addition & 1 deletion .mcp.json
Original file line number Diff line number Diff line change
Expand Up @@ -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."
}
}
}
9 changes: 9 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,14 @@
# Changelog

## [1.3.0] - Unreleased

- Update the Cursor Marketplace manifest to 1.3.0 with a verified nine-platform description, category, and keywords. Add `assets/logo-opaque.png` for that listing and keep the canonical transparent `assets/logo.png`.
- Point the Claude directory bundle at `https://mcp.synterai.com/mcp/directory`. Claude, Cursor, and portable packages stay on `https://mcp.synterai.com`.
- Record the connector submitted 2026-09-04, plugin ID `f802a044-fa2c-4a98-8c82-26a2870ca6b3`. `https://mcp.syntermedia.ai` remains the live origin of that pending submission.
- Describe Claude listings as 30+ ad platforms, and add directory install and support copy. Directory listing copy points at the pricing page and does not state plan prices.
- Ship 42 tool names in the Claude directory bundle. `tools/directory-tools.json` stays the 34-name full-plugin instruction allowlist.
- Check skill tool names against `scripts/hosted-tools.json` in CI.

## [1.2.1] - Unreleased

- Add a portable OpenAI package targeting the existing Synter Ads MCP draft,
Expand Down
58 changes: 38 additions & 20 deletions CLAUDE_COMMUNITY_SUBMISSION.md
Original file line number Diff line number Diff line change
@@ -1,19 +1,33 @@
# Claude plugin directory submission

Prepared: 2026-09-06
Prepared: 2026-09-06. URL and submission record updated: 2026-11-06.

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.
submit or publish this plugin in Anthropic's plugin directory. This document
does not submit either listing.

## Current directory status

- **Connector Directory:** submitted 2026-09-05 from the Synter Team
organization; slug `synter`; status **In review** at
- **Connector Directory:** submitted 2026-09-04 from the Synter Team
organization. Plugin ID `f802a044-fa2c-4a98-8c82-26a2870ca6b3`. Slug `synter`.
Status **In review** at
`https://claude.ai/admin-settings/directory/submissions/synter`.
The origin on that submission is `https://mcp.syntermedia.ai`. That host is
still live. Leave it in place for the review already underway. This
repository does not redirect it, take it down, or edit that submission.
- **New package endpoints:** Claude, Cursor, and the portable package use
`https://mcp.synterai.com`. The Claude directory bundle at
`packages/claude-directory` uses `https://mcp.synterai.com/mcp/directory`
for the curated directory profile. Those URLs are for new package files.
They are not a change to the connector already in review. On 2026-11-06 an
unauthenticated request to `https://mcp.synterai.com/mcp/directory` returned
the same `401` challenge as `https://mcp.synterai.com` and named
`https://mcp.synterai.com` as `mcp_endpoint`. Confirm that path serves the
curated tool list before anyone submits the bundle.
- **Plugin Directory:** no submission ID or published listing has been
verified. This public repository remains directly installable while the
separate plugin submission is completed.
verified. This reconciliation does not submit the bundle. The public
repository remains directly installable.

Anthropic documents the Connector Directory and Plugin Directory as separate,
complementary catalogs. Do not treat connector review as plugin publication.
Expand All @@ -25,14 +39,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:

Expand Down Expand Up @@ -86,8 +100,9 @@ Direct installation is not public-directory discovery.
- [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] `npx -y @anthropic-ai/claude-code@2.1.263 plugin validate . --strict`,
`.claude-plugin/plugin.json`, and `packages/claude-directory` print
`✔ Validation passed` on 2026-11-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.
Expand All @@ -105,7 +120,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.
- New Claude and Cursor package files use `https://mcp.synterai.com` with browser OAuth and no static credentials or headers. The directory bundle uses `https://mcp.synterai.com/mcp/directory`. The connector submitted on 2026-09-04 remains on `https://mcp.syntermedia.ai`. That pending origin stays as submitted.
- 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
Expand Down Expand Up @@ -133,9 +148,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` |
| 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 | New packages: OAuth metadata, DCR, PKCE, and a protected-tool `401` at `https://mcp.synterai.com` (directory bundle: `https://mcp.synterai.com/mcp/directory`). Pending connector: the same class of challenge at `https://mcp.syntermedia.ai`, which stays the submitted origin. |
| Tool directory | Full-plugin instruction allowlist: 34 names in `tools/directory-tools.json`. Claude directory bundle: those 34 plus `get_workspaces`, `update_active_workspace`, `google_ads_manage_custom_goals`, `angstrom_verify_output`, `run_gaql_query`, `add_negative_keywords`, `add_keywords`, and `get_ad_readback` (42), in `config/claude-directory/directory-tools.json`. Live annotations still need a fresh authenticated review. |
| 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 |
Expand All @@ -147,10 +162,13 @@ the directory.

## Provider-side plugin action still required

The remote MCP connector is already in review. Publishing this plugin still
requires an authenticated Synter representative with the required Claude.ai
directory-management access or Console Developer/Admin/Owner role and a
private reviewer test account. Use one of:
The remote MCP connector is already in review at `https://mcp.syntermedia.ai`
(plugin ID `f802a044-fa2c-4a98-8c82-26a2870ca6b3`, submitted 2026-09-04). Do not
replace that origin while Anthropic is reviewing it. Publishing this plugin
still requires an authenticated Synter representative with the required
Claude.ai directory-management access or Console Developer/Admin/Owner role
and a private reviewer test account. This change does not perform that
submission. When an owner later submits the plugin, use one of:

- `https://claude.ai/admin-settings/directory/submissions/plugins/new`
- `https://platform.claude.com/plugins/submit`
Expand Down
Loading
Loading