Skip to content
Merged
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
4 changes: 2 additions & 2 deletions .claude-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -9,8 +9,8 @@
"plugins": [
{
"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."
"source": "./packages/claude-directory",
"description": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 30+ ad platforms over OAuth."
}
]
}
7 changes: 4 additions & 3 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": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 30+ ad platforms over OAuth.",
"version": "1.3.1",
"license": "MIT",
"author": {
"name": "Synter",
Expand Down Expand Up @@ -37,5 +37,6 @@
]
}
]
}
},
"privacyPolicyUrl": "https://synterai.com/privacy"
}
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.2.1"
"version": "1.3.1"
},
"plugins": [
{
"name": "synter",
"source": ".",
"logo": "assets/logo.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."
"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."
}
]
}
9 changes: 6 additions & 3 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.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.",
"version": "1.3.1",
"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 All @@ -24,7 +24,10 @@
"meta-ads",
"linkedin-ads",
"mcp",
"synter"
"synter",
"read-only",
"free",
"reporting"
],
"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 Cursor readonly listing
run: node scripts/check-readonly-tools.js
- name: Test repository validators
run: node --test scripts/*.test.js
2 changes: 2 additions & 0 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,6 +26,8 @@ jobs:

- name: Validate directory tool references
run: node scripts/check-directory-tools.js
- name: Check Cursor readonly listing
run: node scripts/check-readonly-tools.js

- name: Test repository validators
run: node --test scripts/*.test.js
Expand Down
10 changes: 6 additions & 4 deletions .github/workflows/validate.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,13 +18,15 @@ jobs:

- name: Run manifest validation
run: node scripts/validate-manifests.js
- name: Check Cursor readonly listing
run: node scripts/check-readonly-tools.js

- name: Run strict Claude plugin validation
run: |
npx -y @anthropic-ai/claude-code@2.1.263 plugin validate . --strict
npx -y @anthropic-ai/claude-code@2.1.263 plugin validate .claude-plugin/plugin.json --strict
bash scripts/validate-claude-plugin.sh .
bash scripts/validate-claude-plugin.sh .claude-plugin/plugin.json
python3 scripts/build-packages.py --check-claude-directory
npx -y @anthropic-ai/claude-code@2.1.263 plugin validate packages/claude-directory --strict
bash scripts/validate-claude-plugin.sh packages/claude-directory

- name: Test package validation
run: |
Expand All @@ -36,7 +38,7 @@ jobs:
run: |
VERSION=$(node -p "require('./.claude-plugin/plugin.json').version")
python3 -m zipfile -e "dist/synter-claude-plugin-$VERSION.zip" /tmp/synter-claude-package
npx -y @anthropic-ai/claude-code@2.1.263 plugin validate /tmp/synter-claude-package/.claude-plugin/plugin.json --strict
bash scripts/validate-claude-plugin.sh /tmp/synter-claude-package/.claude-plugin/plugin.json

- name: Save reviewable package artifacts
uses: actions/upload-artifact@v4
Expand Down
4 changes: 2 additions & 2 deletions .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 free read-only MCP profile. Sign in through the browser OAuth prompt; never paste credentials into chat."
}
}
}
23 changes: 23 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,28 @@
# Changelog

## [1.3.1] — 2026-11-09

### Changed
- Root `skills/` and `agents/` trimmed to the free read-only allowlist (27 skills, 3 agents). Removed write-flavored skills including `launch` and `optimize`, and agents `budget-optimizer`, `creative-director`, `media-buyer`.
- README no longer lists write skills or describes the launch/write workflow.
- CI (`scripts/check-readonly-tools.js`) fails if any non-allowlisted skill/agent ships.
- Cursor MCP URL remains `https://mcp.synterai.com` until prod path-PRM for `/mcp/directory` matches staging (see PR notes).

## [1.3.0]

### Fixed
- Claude Directory package is slimmed to free read-only skills/agents, declares `privacyPolicyUrl`, and points the connector at `https://mcp.synterai.com/mcp/directory`. Marketplace source is `packages/claude-directory`. Removed non-text GIF asset that blocked directory scanners.

— 2026-11-09

### Cursor Marketplace (free, read-only)
- Bump to 1.3.0 for a free, read-only Cursor Marketplace listing.
- Canonical MCP URL stays `https://mcp.synterai.com` across `.cursor-mcp.json`, `mcp.json`, `.mcp.json`, and docs.
- Add `tools/readonly-tools.json` (26 read/observe tools) and a Cursor rule that forbids write/launch/spend tools in this listing.
- README states the listing is free and read-only; paid write capabilities point at https://synterai.com/pricing without plan prices.
- Claude directory bundle uses `https://mcp.synterai.com/mcp/directory`; the in-review Claude connector keeps `https://mcp.syntermedia.ai`.
- Supersedes open Cursor prep PRs #20, #24, and #28 for listing purposes.

## [1.2.1] - Unreleased

- Add a portable OpenAI package targeting the existing Synter Ads MCP draft,
Expand Down
48 changes: 25 additions & 23 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@

# Synter plugin

Plan advertising campaigns, review performance, write ad copy, and apply approved campaign changes through Synter. This plugin is a no-cost client for the paid Synter service. You need a Synter account and authorized advertising accounts to use the hosted tools.
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 Expand Up @@ -59,47 +59,39 @@ Both plugin configurations use remote HTTP MCP with browser OAuth. They contain
| Client | Configuration | Hosted MCP URL |
| --- | --- | --- |
| Cursor | `.cursor-mcp.json`, referenced by `.cursor-plugin/plugin.json` | `https://mcp.synterai.com` |
| Claude | `.mcp.json`, discovered by the Claude plugin | `https://mcp.synterai.com` |
| Claude | `.mcp.json` / `packages/claude-directory` | `https://mcp.synterai.com/mcp/directory` |

The portable base `mcp.json` uses the Agent Plugins schema and `streamable-http` transport. The OpenAI build adds its documented server authentication extension; the published portable 1.0.0 schema currently rejects that extension, so validate the base against that schema and the generated vendor settings against the documented contract separately. Claude and Cursor use their own HTTP configuration files. All generated packages connect to the canonical endpoint. Existing OpenAI connections on another origin require a new plugin or support-assisted recovery, not a blind endpoint replacement. For another remote MCP client, use its browser OAuth flow with the appropriate hosted URL. If sign-in fails, reconnect through the client’s settings or contact [support](https://synterai.com/contact).

## What this plugin runs

The plugin connects to the hosted Synter MCP server over OAuth. The advertising tools run on that server. Local Markdown skills, agents, and rules guide how the client uses them; the checked-in [tool directory](tools/directory-tools.json) contains the 34 supported tool names.
The plugin connects to the hosted Synter MCP server over OAuth. The advertising tools run on that server. Local Markdown skills, agents, and rules guide how the client uses them; the checked-in [read-only tool allowlist](tools/readonly-tools.json) is the Cursor listing surface; [directory-tools.json](tools/directory-tools.json) remains the broader curated catalog reference.

Claude also runs one `SessionStart` hook from [.claude-plugin/plugin.json](.claude-plugin/plugin.json). It invokes [scripts/session-context.sh](scripts/session-context.sh), a Bash script that uses `cat` to print static account-scope and approval guidance. It does not read credentials or make network requests. Cursor declares no hooks and uses [rules/synter-operator.mdc](rules/synter-operator.mdc).

There is no local MCP server or bundled compiled binary. The repository includes an optional [Node SDK runner](sdk/README.md), invoked manually, and development scripts for validation and packaging. Both distribution archives exclude the SDK, local configuration, and development scripts. Agent definitions may delegate work when the host client supports them.

Bundled skills (invoke as `/synter:<name>`):
Bundled skills (invoke as `/synter:<name>`; free read-only set):

- [`creative`](skills/creative/SKILL.md) · [`landing-page-creation`](skills/landing-page-creation/SKILL.md) · [`llm-visibility-audit`](skills/llm-visibility-audit/SKILL.md) · [`ugc-creative-brief`](skills/ugc-creative-brief/SKILL.md)

- [`ad-copy-generation`](skills/ad-copy-generation/SKILL.md) · [`ad-policy-compliance`](skills/ad-policy-compliance/SKILL.md) · [`anomaly-detector`](skills/anomaly-detector/SKILL.md) · [`attribution`](skills/attribution/SKILL.md)
- [`audience`](skills/audience/SKILL.md) · [`audience-expansion-strategy`](skills/audience-expansion-strategy/SKILL.md) · [`bid-optimization`](skills/bid-optimization/SKILL.md) · [`campaign-preflight`](skills/campaign-preflight/SKILL.md)
- [`ad-policy-compliance`](skills/ad-policy-compliance/SKILL.md) · [`anomaly-detector`](skills/anomaly-detector/SKILL.md) · [`attribution`](skills/attribution/SKILL.md) · [`audience-expansion-strategy`](skills/audience-expansion-strategy/SKILL.md)
- [`campaign-structure-auditor`](skills/campaign-structure-auditor/SKILL.md) · [`competitor-analysis`](skills/competitor-analysis/SKILL.md) · [`connect`](skills/connect/SKILL.md) · [`conversion-tracking`](skills/conversion-tracking/SKILL.md)
- [`creative-fatigue-detector`](skills/creative-fatigue-detector/SKILL.md) · [`creative-testing`](skills/creative-testing/SKILL.md) · [`dayparting`](skills/dayparting/SKILL.md) · [`executive-reporting`](skills/executive-reporting/SKILL.md)
- [`first-party-data-strategy`](skills/first-party-data-strategy/SKILL.md) · [`geo-integrity-audit`](skills/geo-integrity-audit/SKILL.md) · [`google-ads-quality-score`](skills/google-ads-quality-score/SKILL.md) · [`google-shopping-optimizer`](skills/google-shopping-optimizer/SKILL.md)
- [`help`](skills/help/SKILL.md) · [`incrementality-testing`](skills/incrementality-testing/SKILL.md) · [`keyword-research`](skills/keyword-research/SKILL.md) · [`kill-scale-rules`](skills/kill-scale-rules/SKILL.md)
- [`launch`](skills/launch/SKILL.md) · [`linkedin-ads-targeting`](skills/linkedin-ads-targeting/SKILL.md) · [`media-plan`](skills/media-plan/SKILL.md) · [`meta-ads-diagnostics`](skills/meta-ads-diagnostics/SKILL.md)
- [`mmm-budget-planner`](skills/mmm-budget-planner/SKILL.md) · [`negative-keywords`](skills/negative-keywords/SKILL.md) · [`optimize`](skills/optimize/SKILL.md) · [`performance-max-optimizer`](skills/performance-max-optimizer/SKILL.md)
- [`pixel-capi-auditor`](skills/pixel-capi-auditor/SKILL.md) · [`platform-amazon`](skills/platform-amazon/SKILL.md) · [`platform-benchmarks`](skills/platform-benchmarks/SKILL.md) · [`platform-google`](skills/platform-google/SKILL.md)
- [`platform-linkedin`](skills/platform-linkedin/SKILL.md) · [`platform-meta`](skills/platform-meta/SKILL.md) · [`platform-microsoft`](skills/platform-microsoft/SKILL.md) · [`platform-openai`](skills/platform-openai/SKILL.md)
- [`platform-reddit`](skills/platform-reddit/SKILL.md) · [`platform-tiktok`](skills/platform-tiktok/SKILL.md) · [`platform-x`](skills/platform-x/SKILL.md) · [`pre-pause-analysis`](skills/pre-pause-analysis/SKILL.md)
- [`quickstart`](skills/quickstart/SKILL.md) · [`replicate`](skills/replicate/SKILL.md) · [`report`](skills/report/SKILL.md) · [`retargeting-sequence-designer`](skills/retargeting-sequence-designer/SKILL.md)
- [`roas-calculator`](skills/roas-calculator/SKILL.md) · [`seasonal-budget-planner`](skills/seasonal-budget-planner/SKILL.md) · [`utm-builder`](skills/utm-builder/SKILL.md) · [`video-ad-scriptwriter`](skills/video-ad-scriptwriter/SKILL.md)

Bundled agents: [`audience-builder`](agents/audience-builder.md) · [`budget-optimizer`](agents/budget-optimizer.md) · [`campaign-strategist`](agents/campaign-strategist.md) · [`creative-director`](agents/creative-director.md) · [`media-buyer`](agents/media-buyer.md) · [`performance-analyst`](agents/performance-analyst.md).
- [`creative-fatigue-detector`](skills/creative-fatigue-detector/SKILL.md) · [`dayparting`](skills/dayparting/SKILL.md) · [`executive-reporting`](skills/executive-reporting/SKILL.md) · [`first-party-data-strategy`](skills/first-party-data-strategy/SKILL.md)
- [`geo-integrity-audit`](skills/geo-integrity-audit/SKILL.md) · [`help`](skills/help/SKILL.md) · [`landing-page-creation`](skills/landing-page-creation/SKILL.md) · [`linkedin-ads-targeting`](skills/linkedin-ads-targeting/SKILL.md)
- [`llm-visibility-audit`](skills/llm-visibility-audit/SKILL.md) · [`media-plan`](skills/media-plan/SKILL.md) · [`negative-keywords`](skills/negative-keywords/SKILL.md) · [`pixel-capi-auditor`](skills/pixel-capi-auditor/SKILL.md)
- [`platform-benchmarks`](skills/platform-benchmarks/SKILL.md) · [`quickstart`](skills/quickstart/SKILL.md) · [`report`](skills/report/SKILL.md) · [`roas-calculator`](skills/roas-calculator/SKILL.md)
- [`ugc-creative-brief`](skills/ugc-creative-brief/SKILL.md) · [`utm-builder`](skills/utm-builder/SKILL.md) · [`video-ad-scriptwriter`](skills/video-ad-scriptwriter/SKILL.md)

Bundled agents: [`audience-builder`](agents/audience-builder.md) · [`campaign-strategist`](agents/campaign-strategist.md) · [`performance-analyst`](agents/performance-analyst.md).

[Privacy policy](https://synterai.com/privacy) · [Support](https://synterai.com/contact)

## Campaign safety and scope

Confirm the workspace, account name, and account ID before account actions. Use the advertiser’s verified brand and original assets. Writes require an explicit approved scope; a tool’s plan-approval record is not a substitute for the user’s approval.
This listing is **free and read-only**. Confirm the workspace, account name, and account ID before account reads. Use the advertiser’s verified brand and original assets.

The launch workflow reads the final plan, runs preflight, records approval, executes, and verifies the returned campaign state. Creating a campaign does not prove it is live or spending. Unsupported operations, including tag publishing and audience synchronization, require a manual handoff to the platform UI.
Skills and MCP tools here list, pull, audit, forecast, and report. They do not create, pause, enable, approve, or execute campaigns. Unsupported operations, including writes, tag publishing, and audience synchronization, require Synter’s full product or a manual handoff to the platform UI.

Text ads use `create_ad_copy`; existing assets use `list_creative_assets`. The plugin reports missing capabilities and data rather than inventing tool names or results.
Existing creative assets use `list_creative_assets`. The plugin reports missing capabilities and data rather than inventing tool names or results.

## Develop and validate

Expand Down Expand Up @@ -150,3 +142,13 @@ are review instructions, not claims that those live checks already passed.
Format references: [OpenAI package guide](https://developers.openai.com/plugins/build/plugins),
[OpenAI submission guide](https://developers.openai.com/plugins/deploy/submission),
and [Claude manifest reference](https://code.claude.com/docs/en/plugins-reference).

## Free read-only Cursor listing

This Marketplace build is free and read-only:

- MCP URL (Cursor): `https://mcp.synterai.com` (canonical production OAuth host; unauthenticated calls return `401` with `WWW-Authenticate` and PRM at `/.well-known/oauth-protected-resource`).
- Tool surface for this listing: `tools/readonly-tools.json` (26 read/observe tools). Write, launch, and spend tools are out of scope here.
- Enforcement: plugin allowlist + CI guard + Cursor rule. Server tools remain classified with `@readonly_tool` / OAuth `tools:read`. A stricter server-side read-only profile is owned separately; when it ships on staging this listing can point at it without changing the canonical host.
- Claude directory bundle (`packages/claude-directory`, marketplace source) is a slim free read-only skill/agent set with `privacyPolicyUrl` `https://synterai.com/privacy` and connector `https://mcp.synterai.com/mcp/directory`. The Claude connector already in review keeps `https://mcp.syntermedia.ai`.

Loading
Loading