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
2 changes: 1 addition & 1 deletion .claude-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"name": "synter",
"displayName": "Synter",
"description": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 30+ ad platforms over OAuth.",
"version": "1.3.0",
"version": "1.3.1",
"license": "MIT",
"author": {
"name": "Synter",
Expand Down
2 changes: 1 addition & 1 deletion .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
},
"metadata": {
"description": "Synter's official plugin marketplace. The AI Agent Operator for Ads.",
"version": "1.3.0"
"version": "1.3.1"
},
"plugins": [
{
Expand Down
2 changes: 1 addition & 1 deletion .cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
"$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json",
"name": "synter",
"displayName": "Synter",
"version": "1.3.0",
"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",
Expand Down
8 changes: 8 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,13 @@
# 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
Expand Down
34 changes: 13 additions & 21 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -65,41 +65,33 @@ The portable base `mcp.json` uses the Agent Plugins schema and `streamable-http`

## 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
22 changes: 0 additions & 22 deletions agents/budget-optimizer.md

This file was deleted.

20 changes: 0 additions & 20 deletions agents/creative-director.md

This file was deleted.

21 changes: 0 additions & 21 deletions agents/media-buyer.md

This file was deleted.

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 @@ -3,7 +3,7 @@
"name": "synter",
"displayName": "Synter",
"description": "Free read-only Synter advertising skills and MCP connector. Review performance, audiences, and plans across 30+ ad platforms over OAuth.",
"version": "1.3.0",
"version": "1.3.1",
"license": "MIT",
"author": {
"name": "Synter",
Expand Down
2 changes: 1 addition & 1 deletion plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "synter",
"version": "1.3.0",
"version": "1.3.1",
"description": "Plan and operate advertising campaigns through Synter\u2019s hosted MCP server over OAuth. Review performance, write ad copy, and approve campaign changes before execution.",
"author": {
"name": "Synter",
Expand Down
Loading
Loading