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/plugin.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,7 @@
"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",
"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: 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."
}
}
}
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.0] - Unreleased

- Update Cursor Marketplace manifest with verified platform coverage across Google Ads, Meta, LinkedIn, Reddit, X, TikTok, Microsoft Ads, Snapchat, and StackAdapt.
- Clarify in Cursor Marketplace manifest that reads cost credits and that performance reporting on X and TikTok may require platform exports.
- Add `assets/logo-opaque.png` (1024x1024 solid #070806 dark background) for the Cursor Marketplace listing while preserving canonical `assets/logo.png`.
- Replace legacy syntermedia.ai domain references with synterai.com across user-facing documentation, submission evidence, and endpoint configuration.
- Align MCP HTTP client configurations across Cursor and Claude to the canonical `https://mcp.synterai.com` endpoint.

## [1.2.1] - Unreleased

- Add a portable OpenAI package targeting the existing Synter Ads MCP draft,
Expand Down
14 changes: 7 additions & 7 deletions CLAUDE_COMMUNITY_SUBMISSION.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,14 +25,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 @@ -105,7 +105,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.
- Claude and Cursor use `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
Expand Down Expand Up @@ -133,9 +133,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` |
| OAuth for authenticated remote MCP | OAuth metadata, DCR, PKCE, and protected-tool `401` challenge at `https://mcp.synterai.com` |
| 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` |
| 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 Down
8 changes: 4 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ The OpenAI package includes Synter skills and the hosted OAuth MCP connection.
Its generated `mcp.json` declares OAuth with dynamic client registration under
`mcpServers.synter.extensions.com.openai.auth`; discovery provides the endpoints.
The portal displays these settings and does not provide an advanced OAuth editor.
The existing-draft archive is `dist/synter-openai-plugin-1.2.1.zip`, for
The existing-draft archive is `dist/synter-openai-plugin-1.3.0.zip`, for
**Synter Ads MCP**. Its package identity remains
`app-6a90dc5bbc3c819199b4f1e44028fcbf`. Uploading creates a draft; directory
approval and publication are separate steps. This archive contains no lifecycle
Expand All @@ -25,14 +25,14 @@ MCP app before updating its plugin ZIP,” while its connection settings are
unavailable. A valid archive does not resolve that portal state. Verify the saved
MCP origin before updating: OpenAI does not allow an origin change between versions.
`bash scripts/build-zip.sh --include-new-draft` also prepares
`dist/synter-openai-new-draft-plugin-1.2.1.zip` with the canonical `synter` package
`dist/synter-openai-new-draft-plugin-1.3.0.zip` with the canonical `synter` package
name for a separately authorized new draft if the existing identity cannot be
recovered. Building it does not upload, register, or publish anything.

### Claude Desktop and Cowork

Build the archives with `bash scripts/build-zip.sh`, then use Claude Desktop's
plugin upload to select `dist/synter-claude-plugin-1.2.1.zip`. The archive contains
plugin upload to select `dist/synter-claude-plugin-1.3.0.zip`. The archive contains
the `.claude-plugin` manifest, OAuth configuration, skills, agents, and static
session primer. Start a new conversation after updating and complete browser
OAuth when prompted. Uploading a ZIP does not enable automatic GitHub updates. You can also add
Expand Down Expand Up @@ -114,7 +114,7 @@ bash scripts/build-zip.sh

The directory check scans every file under `skills/`, `commands/` (when present), `rules/`, and `agents/`, including prose, tables, and code fences. Spell out exact tool names; dynamic tool-name templates fail validation. Snake-case data fields are recognized separately, but calling them as functions still counts as a tool reference. For a tool name without underscores, use explicit `tool:name` or its MCP-qualified name.

The check runs offline in CI. To also compare the directory against live MCP `tools/list`, supply an OAuth access token through `SYNTER_MCP_TOKEN` in your environment and run the same script. It initializes an MCP session and follows paginated results. `--live` requires the token instead of silently running offline. `SYNTER_MCP_URL` optionally selects either hosted URL in the table; it defaults to the Cursor endpoint. The token is for this development check only and is never written to plugin configuration. Extra live tools do not expand the checked-in directory.
The check runs offline in CI. To also compare the directory against live MCP `tools/list`, supply an OAuth access token through `SYNTER_MCP_TOKEN` in your environment and run the same script. It initializes an MCP session and follows paginated results. `--live` requires the token instead of silently running offline. If set, `SYNTER_MCP_URL` must match the allow-listed endpoint (`https://mcp.synterai.com`, which is also the default); untrusted endpoints are rejected. The token is for this development check only and is never written to plugin configuration. Extra live tools do not expand the checked-in directory.

[Terms](https://synterai.com/terms) · [MIT license](LICENSE)

Expand Down
Binary file added assets/logo-opaque-512.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/logo-opaque.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
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": "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",
"version": "1.3.0",
"license": "MIT",
"author": {
"name": "Synter",
Expand Down
2 changes: 1 addition & 1 deletion packages/claude-directory/.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."
}
}
}
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.2.1",
"version": "1.3.0",
"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.",
"author": {
"name": "Synter",
Expand Down
4 changes: 2 additions & 2 deletions 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']);

function extractReferences(source) {
const refs = [];
Expand Down Expand Up @@ -75,7 +75,7 @@ function scan(root = ROOT) {

async function readLiveTools({ token, url = 'https://mcp.synterai.com', fetchImpl = fetch }) {
if (!token) throw new Error('Live check requires SYNTER_MCP_TOKEN (an OAuth access token).');
if (!ENDPOINTS.has(url)) throw new Error('Live check URL must be one of the two production Synter MCP endpoints.');
if (!ENDPOINTS.has(url)) throw new Error('Live check URL must be the production Synter MCP endpoint (https://mcp.synterai.com).');
let session;
let protocol = '2025-03-26';
let requestId = 0;
Expand Down
8 changes: 4 additions & 4 deletions scripts/test_build_packages.py
Original file line number Diff line number Diff line change
Expand Up @@ -99,10 +99,10 @@ 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',
'openai': '5ab905019791b7f0f71033e19e18042e26ba272b7b2d958aac4ff177a7c0f665',
'openai-new-draft': '48bbdbedbc5eb96ffacfcd18b339048139ac6f67dbca160e5fd2d13b7682cd87',
'claude': '8a4141f2e4b1fa0c965258fe03aadf7129525d48d2e9e6d0008b1f6e2cf63793',
'claude-directory': 'dce25899dd00aa9ab95bf941e730203daf9689d5ece79571ec630f0010a245c7',
'openai': '5cc8eac259294beed15f329cbc155afaab91bdeb3f564916f73517a8801216a0',
'openai-new-draft': '554a7cdd3c8785932e15b876a6c2f0fe2da249d3ce10d4a68a45f318771ed3dd',
}
# Snapshot after the approved RSA/bidding correction across all hosts.
# Update deliberately when reviewed package contents change.
Expand Down
Loading