From ca73ea3590c810626dc114f67d3e0fc86f55b8f1 Mon Sep 17 00:00:00 2001 From: Joel Horwitz Date: Tue, 17 Nov 2026 10:37:38 -0800 Subject: [PATCH 1/3] fix(claude-directory): align tool list with read-only /mcp/directory (v1.3.3) Replace the 42-tool directory allowlist, which included writes such as execute_campaign_plan, enable_campaign, and action_card, with the 83 read-only tools served by /mcp/directory. Update instruction mentions, validators, package hashes, and bump the patch version to 1.3.3. --- .claude-plugin/plugin.json | 2 +- .cursor-plugin/marketplace.json | 2 +- .cursor-plugin/plugin.json | 2 +- CHANGELOG.md | 4 + .../.claude-plugin/plugin.json | 2 +- .../audience-expansion-strategy/SKILL.md | 2 +- .../skills/conversion-tracking/SKILL.md | 2 +- .../skills/geo-integrity-audit/SKILL.md | 2 +- .../tools/directory-tools.json | 111 ++++++++++++------ plugin.json | 2 +- scripts/check-directory-tools.js | 4 +- scripts/check-directory-tools.test.js | 2 +- scripts/test_build_packages.py | 8 +- skills/audience-expansion-strategy/SKILL.md | 2 +- skills/conversion-tracking/SKILL.md | 2 +- skills/geo-integrity-audit/SKILL.md | 2 +- tools/directory-tools.json | 111 ++++++++++++------ 17 files changed, 174 insertions(+), 88 deletions(-) diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index 06ed02d..e828b3c 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -3,7 +3,7 @@ "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", + "version": "1.3.3", "license": "MIT", "author": { "name": "Synter", diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 0b020a8..816ce6a 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -6,7 +6,7 @@ }, "metadata": { "description": "Synter's official plugin marketplace. The AI Agent Operator for Ads.", - "version": "1.3.2" + "version": "1.3.3" }, "plugins": [ { diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index 0c82c10..83eac65 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -2,7 +2,7 @@ "$schema": "https://cursor.com/schemas/cursor-plugin/plugin.json", "name": "synter", "displayName": "Synter", - "version": "1.3.2", + "version": "1.3.3", "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.", "author": { "name": "Synter", diff --git a/CHANGELOG.md b/CHANGELOG.md index eb7246c..335499f 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,10 @@ ## [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. + ### Fixed - Moved `outbound`, `outbound-research`, and `outbound-replies` out of the shipped `skills/` tree (now under `skills-write/`) so the Cursor Marketplace diff --git a/packages/claude-directory/.claude-plugin/plugin.json b/packages/claude-directory/.claude-plugin/plugin.json index e4f8784..f7f2181 100644 --- a/packages/claude-directory/.claude-plugin/plugin.json +++ b/packages/claude-directory/.claude-plugin/plugin.json @@ -3,7 +3,7 @@ "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", + "version": "1.3.3", "license": "MIT", "author": { "name": "Synter", diff --git a/packages/claude-directory/skills/audience-expansion-strategy/SKILL.md b/packages/claude-directory/skills/audience-expansion-strategy/SKILL.md index b56e001..ddf90c1 100644 --- a/packages/claude-directory/skills/audience-expansion-strategy/SKILL.md +++ b/packages/claude-directory/skills/audience-expansion-strategy/SKILL.md @@ -48,7 +48,7 @@ Meta Advantage+ audiences and Google Optimized Targeting treat your audiences as ## 6. Monitor and rebalance -Weekly: the supported performance tools (`pull_google_ads_performance`, `pull_meta_ads_performance`, `pull_linkedin_ads_performance`, `pull_microsoft_ads_performance`, `pull_reddit_ads_performance`) per audience tier. Scale rungs beating target, refresh creative on fatiguing ones, and rebalance spend across tiers with `optimize_budget`. When an expansion audience wins, feed its converters back into the seed pool — the ladder compounds. +Weekly: the supported performance tools (`pull_google_ads_performance`, `pull_meta_ads_performance`, `pull_linkedin_ads_performance`, `pull_microsoft_ads_performance`, `pull_reddit_ads_performance`) per audience tier. Scale rungs beating target, refresh creative on fatiguing ones, and recommend spend rebalances across tiers from that evidence (write tools are not available on this read-only surface). When an expansion audience wins, feed its converters back into the seed pool — the ladder compounds. ## Rules diff --git a/packages/claude-directory/skills/conversion-tracking/SKILL.md b/packages/claude-directory/skills/conversion-tracking/SKILL.md index 7c13e57..ec965d6 100644 --- a/packages/claude-directory/skills/conversion-tracking/SKILL.md +++ b/packages/claude-directory/skills/conversion-tracking/SKILL.md @@ -7,7 +7,7 @@ description: Verify available conversion and pixel diagnostics before launch; ha Confirm the account with `list_connected_accounts` and `verify_platform_accounts`. Use `ga4_get_properties` to select the right property, `ga4_get_conversions` to inspect configured conversions, and `ga4_get_report` to check recorded events over a stated period. Read `get_pixel_health` for available pixel diagnostics. -A configured conversion is not proof that the right event fires or that the campaign optimizes toward it. Compare the intended business action with the evidence returned. Use `run_launch_preflight` for a campaign plan. Mark fields and checks unavailable from the tools as unverified. +A configured conversion is not proof that the right event fires or that the campaign optimizes toward it. Compare the intended business action with the evidence returned. Use `get_campaign_plan` to review a campaign plan. Mark fields and checks unavailable from the tools as unverified. For missing tags, event routing, or consent settings, describe the exact gap and have the account owner make the change in the platform or tag manager. This plugin does not publish tags or configure pixel destinations. diff --git a/packages/claude-directory/skills/geo-integrity-audit/SKILL.md b/packages/claude-directory/skills/geo-integrity-audit/SKILL.md index abdecd6..61a3947 100644 --- a/packages/claude-directory/skills/geo-integrity-audit/SKILL.md +++ b/packages/claude-directory/skills/geo-integrity-audit/SKILL.md @@ -5,7 +5,7 @@ description: Check intended geography against available campaign settings and de # Geo integrity audit -Confirm the workspace with `list_connected_accounts`, then read `list_campaigns` and `audit_account_structure`. For a planned campaign, use `get_campaign_plan` and `run_launch_preflight`. +Confirm the workspace with `list_connected_accounts`, then read `list_campaigns` and `audit_account_structure`. For a planned campaign, use `get_campaign_plan`. Compare the intended geography with the location criteria, exclusions, and presence settings actually returned. A campaign name is not targeting evidence. Check every ad set or ad group when the data is available. Missing fields mean UNVERIFIED, not worldwide delivery or a passed check. diff --git a/packages/claude-directory/tools/directory-tools.json b/packages/claude-directory/tools/directory-tools.json index e3801c5..1360663 100644 --- a/packages/claude-directory/tools/directory-tools.json +++ b/packages/claude-directory/tools/directory-tools.json @@ -1,44 +1,85 @@ [ + "angstrom_verify_output", + "apple_ads_get_accounts", + "apple_ads_get_ad_groups", + "apple_ads_get_campaigns", + "apple_ads_get_keywords", + "apple_ads_get_performance", + "attio_get_companies", + "attio_get_contacts", + "attio_get_deals", + "attio_get_lists", + "audit_account_structure", + "demandbase_get_campaigns", + "demandbase_get_performance", + "ebay_ads_get_campaigns", + "ebay_ads_get_performance", + "forecast_campaign", + "ga4_get_conversions", + "ga4_get_properties", + "ga4_get_report", + "get_ad_readback", + "get_attribution", + "get_campaign_plan", + "get_commerce_records", "get_connection_status", - "list_connected_accounts", - "verify_platform_accounts", + "get_crm_companies", + "get_crm_contacts", + "get_crm_deals", + "get_job_status", + "get_performance", + "get_pixel_health", + "get_plan_execution", + "get_product_analytics", + "get_spend_reconciliation", + "get_workspaces", + "google_search_console_get_keyword_opportunities", + "google_search_console_get_performance", + "google_search_console_get_sites", + "hubspot_get_companies", + "hubspot_get_contacts", + "hubspot_get_deals", + "impact_get_actions", + "impact_get_campaigns", + "impact_get_performance", + "list_audiences", "list_campaigns", + "list_connected_accounts", + "list_creative_assets", + "luma_get_events", + "luma_get_guests", + "magento_get_active_carts", + "magento_get_customers", + "magento_get_orders", + "magento_get_products", + "magento_get_store", + "measure_incrementality", + "mixpanel_get_events", + "mixpanel_get_projects", + "mixpanel_get_segmentation", + "posthog_get_event_definitions", + "posthog_get_projects", + "posthog_get_trends", "pull_google_ads_performance", - "pull_meta_ads_performance", "pull_linkedin_ads_performance", + "pull_meta_ads_performance", "pull_microsoft_ads_performance", "pull_reddit_ads_performance", - "ga4_get_properties", - "ga4_get_report", - "ga4_get_conversions", - "get_attribution", - "get_spend_reconciliation", - "get_pixel_health", - "measure_incrementality", - "audit_account_structure", "research_campaign_opportunity", - "forecast_campaign", - "optimize_budget", - "create_ad_copy", - "list_audiences", - "list_creative_assets", - "create_campaign_plan", - "get_campaign_plan", - "upsert_plan_entity", - "run_launch_preflight", - "approve_campaign_plan", - "execute_campaign_plan", - "get_plan_execution", - "enable_campaign", - "pause_campaign", - "update_campaign_budget", - "get_job_status", - "company_intel_search_people", - "company_intel_get_profile", - "company_intel_get_signals", - "enrich_contacts", - "synter_audience", - "get_crm_contacts", - "render_card_preview", - "action_card" + "run_gaql_query", + "sa360_get_campaign_verification", + "sa360_get_campaigns", + "salesforce_get_companies", + "salesforce_get_contacts", + "salesforce_get_deals", + "stackadapt_get_audiences", + "stackadapt_get_campaign_structure", + "stackadapt_get_campaigns", + "stackadapt_get_company_domain_performance", + "synter_onboarding_status", + "taboola_get_accounts", + "taboola_get_campaigns", + "taboola_get_performance", + "verify_platform_accounts", + "youtube_get_videos" ] diff --git a/plugin.json b/plugin.json index 169b07e..40baf41 100644 --- a/plugin.json +++ b/plugin.json @@ -1,7 +1,7 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "synter", - "version": "1.3.2", + "version": "1.3.3", "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", diff --git a/scripts/check-directory-tools.js b/scripts/check-directory-tools.js index 7b2ec3c..dd80dfa 100644 --- a/scripts/check-directory-tools.js +++ b/scripts/check-directory-tools.js @@ -51,9 +51,9 @@ function listFiles(dir) { function readAllowlist(root) { const names = JSON.parse(fs.readFileSync(path.join(root, 'tools/directory-tools.json'), 'utf8')); - if (!Array.isArray(names) || names.length !== 42 || new Set(names).size !== 42 || + if (!Array.isArray(names) || names.length !== 83 || new Set(names).size !== 83 || names.some(name => typeof name !== 'string' || !/^[a-z][a-z0-9_]+$/.test(name))) { - throw new Error('tools/directory-tools.json must contain 42 unique tool names.'); + throw new Error('tools/directory-tools.json must contain 83 unique tool names.'); } return new Set(names); } diff --git a/scripts/check-directory-tools.test.js b/scripts/check-directory-tools.test.js index c77958a..a0f93e6 100644 --- a/scripts/check-directory-tools.test.js +++ b/scripts/check-directory-tools.test.js @@ -56,7 +56,7 @@ test('checks nested files in every instruction surface, including optional comma assert.equal(cli.status, 1); assert.match(cli.stderr, /unlisted tool unknown_commands/); fs.writeFileSync(path.join(root, 'tools/directory-tools.json'), '["list_campaigns", "list_campaigns"]'); - assert.throws(() => scan(root), /42 unique tool names/); + assert.throws(() => scan(root), /83 unique tool names/); }); function response(id, result, { sse = false, session = false } = {}) { diff --git a/scripts/test_build_packages.py b/scripts/test_build_packages.py index 3a77ac9..a3e3fb7 100644 --- a/scripts/test_build_packages.py +++ b/scripts/test_build_packages.py @@ -102,10 +102,10 @@ def test_directory_generated_source_detects_drift_and_symlinks(self): def test_archives_match_reviewed_rsa_correction_bytes(self): expected = { - 'claude': 'ab39309643f33f5b8f4b29e55e1871b11afd866ac120b7cd7c068523ebac6229', - 'claude-directory': 'a9f580f3daecc138cb562e6ff66f08d504fb3748968c1b03686bed77057e82d7', - 'openai': '63e4aa8f53b103195063504a2078fee336296ceef18fb8ec2fd0691ab5389058', - 'openai-new-draft': '53a41af245c29d6d9192b100b50623c50ba1b94320907ed3812f3bfb0a9e3045', + 'claude': '073d219a6ef35d2de21289f53d89ce33fd002c37519b433faa987fa3acfeb28b', + 'claude-directory': '6e0134cd68c652b0dea99401de5a9ef8809d997597fd3886acb76c59aa60404c', + 'openai': '9a731d4194846cfa2e01d1b3db16d92381bd0f0de4be39b7aa63c13c016c924d', + 'openai-new-draft': '1d7b1aa251b550e7b5c9c329a174c7076ea49aa7e389633f24a3fa80a6424154', } # Snapshot after the approved RSA/bidding correction across all hosts. # Update deliberately when reviewed package contents change. diff --git a/skills/audience-expansion-strategy/SKILL.md b/skills/audience-expansion-strategy/SKILL.md index b56e001..ddf90c1 100644 --- a/skills/audience-expansion-strategy/SKILL.md +++ b/skills/audience-expansion-strategy/SKILL.md @@ -48,7 +48,7 @@ Meta Advantage+ audiences and Google Optimized Targeting treat your audiences as ## 6. Monitor and rebalance -Weekly: the supported performance tools (`pull_google_ads_performance`, `pull_meta_ads_performance`, `pull_linkedin_ads_performance`, `pull_microsoft_ads_performance`, `pull_reddit_ads_performance`) per audience tier. Scale rungs beating target, refresh creative on fatiguing ones, and rebalance spend across tiers with `optimize_budget`. When an expansion audience wins, feed its converters back into the seed pool — the ladder compounds. +Weekly: the supported performance tools (`pull_google_ads_performance`, `pull_meta_ads_performance`, `pull_linkedin_ads_performance`, `pull_microsoft_ads_performance`, `pull_reddit_ads_performance`) per audience tier. Scale rungs beating target, refresh creative on fatiguing ones, and recommend spend rebalances across tiers from that evidence (write tools are not available on this read-only surface). When an expansion audience wins, feed its converters back into the seed pool — the ladder compounds. ## Rules diff --git a/skills/conversion-tracking/SKILL.md b/skills/conversion-tracking/SKILL.md index 7c13e57..ec965d6 100644 --- a/skills/conversion-tracking/SKILL.md +++ b/skills/conversion-tracking/SKILL.md @@ -7,7 +7,7 @@ description: Verify available conversion and pixel diagnostics before launch; ha Confirm the account with `list_connected_accounts` and `verify_platform_accounts`. Use `ga4_get_properties` to select the right property, `ga4_get_conversions` to inspect configured conversions, and `ga4_get_report` to check recorded events over a stated period. Read `get_pixel_health` for available pixel diagnostics. -A configured conversion is not proof that the right event fires or that the campaign optimizes toward it. Compare the intended business action with the evidence returned. Use `run_launch_preflight` for a campaign plan. Mark fields and checks unavailable from the tools as unverified. +A configured conversion is not proof that the right event fires or that the campaign optimizes toward it. Compare the intended business action with the evidence returned. Use `get_campaign_plan` to review a campaign plan. Mark fields and checks unavailable from the tools as unverified. For missing tags, event routing, or consent settings, describe the exact gap and have the account owner make the change in the platform or tag manager. This plugin does not publish tags or configure pixel destinations. diff --git a/skills/geo-integrity-audit/SKILL.md b/skills/geo-integrity-audit/SKILL.md index abdecd6..61a3947 100644 --- a/skills/geo-integrity-audit/SKILL.md +++ b/skills/geo-integrity-audit/SKILL.md @@ -5,7 +5,7 @@ description: Check intended geography against available campaign settings and de # Geo integrity audit -Confirm the workspace with `list_connected_accounts`, then read `list_campaigns` and `audit_account_structure`. For a planned campaign, use `get_campaign_plan` and `run_launch_preflight`. +Confirm the workspace with `list_connected_accounts`, then read `list_campaigns` and `audit_account_structure`. For a planned campaign, use `get_campaign_plan`. Compare the intended geography with the location criteria, exclusions, and presence settings actually returned. A campaign name is not targeting evidence. Check every ad set or ad group when the data is available. Missing fields mean UNVERIFIED, not worldwide delivery or a passed check. diff --git a/tools/directory-tools.json b/tools/directory-tools.json index e3801c5..1360663 100644 --- a/tools/directory-tools.json +++ b/tools/directory-tools.json @@ -1,44 +1,85 @@ [ + "angstrom_verify_output", + "apple_ads_get_accounts", + "apple_ads_get_ad_groups", + "apple_ads_get_campaigns", + "apple_ads_get_keywords", + "apple_ads_get_performance", + "attio_get_companies", + "attio_get_contacts", + "attio_get_deals", + "attio_get_lists", + "audit_account_structure", + "demandbase_get_campaigns", + "demandbase_get_performance", + "ebay_ads_get_campaigns", + "ebay_ads_get_performance", + "forecast_campaign", + "ga4_get_conversions", + "ga4_get_properties", + "ga4_get_report", + "get_ad_readback", + "get_attribution", + "get_campaign_plan", + "get_commerce_records", "get_connection_status", - "list_connected_accounts", - "verify_platform_accounts", + "get_crm_companies", + "get_crm_contacts", + "get_crm_deals", + "get_job_status", + "get_performance", + "get_pixel_health", + "get_plan_execution", + "get_product_analytics", + "get_spend_reconciliation", + "get_workspaces", + "google_search_console_get_keyword_opportunities", + "google_search_console_get_performance", + "google_search_console_get_sites", + "hubspot_get_companies", + "hubspot_get_contacts", + "hubspot_get_deals", + "impact_get_actions", + "impact_get_campaigns", + "impact_get_performance", + "list_audiences", "list_campaigns", + "list_connected_accounts", + "list_creative_assets", + "luma_get_events", + "luma_get_guests", + "magento_get_active_carts", + "magento_get_customers", + "magento_get_orders", + "magento_get_products", + "magento_get_store", + "measure_incrementality", + "mixpanel_get_events", + "mixpanel_get_projects", + "mixpanel_get_segmentation", + "posthog_get_event_definitions", + "posthog_get_projects", + "posthog_get_trends", "pull_google_ads_performance", - "pull_meta_ads_performance", "pull_linkedin_ads_performance", + "pull_meta_ads_performance", "pull_microsoft_ads_performance", "pull_reddit_ads_performance", - "ga4_get_properties", - "ga4_get_report", - "ga4_get_conversions", - "get_attribution", - "get_spend_reconciliation", - "get_pixel_health", - "measure_incrementality", - "audit_account_structure", "research_campaign_opportunity", - "forecast_campaign", - "optimize_budget", - "create_ad_copy", - "list_audiences", - "list_creative_assets", - "create_campaign_plan", - "get_campaign_plan", - "upsert_plan_entity", - "run_launch_preflight", - "approve_campaign_plan", - "execute_campaign_plan", - "get_plan_execution", - "enable_campaign", - "pause_campaign", - "update_campaign_budget", - "get_job_status", - "company_intel_search_people", - "company_intel_get_profile", - "company_intel_get_signals", - "enrich_contacts", - "synter_audience", - "get_crm_contacts", - "render_card_preview", - "action_card" + "run_gaql_query", + "sa360_get_campaign_verification", + "sa360_get_campaigns", + "salesforce_get_companies", + "salesforce_get_contacts", + "salesforce_get_deals", + "stackadapt_get_audiences", + "stackadapt_get_campaign_structure", + "stackadapt_get_campaigns", + "stackadapt_get_company_domain_performance", + "synter_onboarding_status", + "taboola_get_accounts", + "taboola_get_campaigns", + "taboola_get_performance", + "verify_platform_accounts", + "youtube_get_videos" ] From a14a0878c618a61a11d1a5bc382cf7c657ed5229 Mon Sep 17 00:00:00 2001 From: Joel Horwitz Date: Tue, 17 Nov 2026 10:56:36 -0800 Subject: [PATCH 2/3] fix(claude-directory): 30+ platforms, drop spend copy, tighten live checks Replace the "43 ad platforms" claim with "30+ ad platforms", remove write/spend approval copy from the directory README, help skill, and root plugin.json, default check-directory-tools --live to /mcp/directory and fail on unexpected tools or missing annotations, and drop optimize_budget from the Cursor readonly list. --- .claude-plugin/marketplace.json | 2 +- .claude-plugin/plugin.json | 2 +- .cursor-plugin/marketplace.json | 2 +- .cursor-plugin/plugin.json | 2 +- CHANGELOG.md | 3 + README.md | 2 +- config/claude-directory/README.md | 4 +- config/claude-directory/help.md | 4 +- .../.claude-plugin/plugin.json | 2 +- packages/claude-directory/README.md | 4 +- .../claude-directory/skills/help/SKILL.md | 4 +- plugin.json | 13 ++-- scripts/check-directory-tools.js | 46 ++++++++++-- scripts/check-directory-tools.test.js | 74 ++++++++++++++++++- scripts/check-readonly-tools.js | 2 +- scripts/test_build_packages.py | 8 +- tools/readonly-tools.json | 1 - 17 files changed, 136 insertions(+), 39 deletions(-) diff --git a/.claude-plugin/marketplace.json b/.claude-plugin/marketplace.json index 7a11f0f..77fed13 100644 --- a/.claude-plugin/marketplace.json +++ b/.claude-plugin/marketplace.json @@ -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." } ] } diff --git a/.claude-plugin/plugin.json b/.claude-plugin/plugin.json index e828b3c..175cf4c 100644 --- a/.claude-plugin/plugin.json +++ b/.claude-plugin/plugin.json @@ -2,7 +2,7 @@ "$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.", + "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": { diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json index 816ce6a..03a8222 100644 --- a/.cursor-plugin/marketplace.json +++ b/.cursor-plugin/marketplace.json @@ -13,7 +13,7 @@ "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." } ] } diff --git a/.cursor-plugin/plugin.json b/.cursor-plugin/plugin.json index 83eac65..704c9c1 100644 --- a/.cursor-plugin/plugin.json +++ b/.cursor-plugin/plugin.json @@ -3,7 +3,7 @@ "name": "synter", "displayName": "Synter", "version": "1.3.3", - "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.", "author": { "name": "Synter", "email": "joel@synterai.com" diff --git a/CHANGELOG.md b/CHANGELOG.md index 335499f..fcdc5c0 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,9 @@ ### 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 diff --git a/README.md b/README.md index a153fc0..fd46414 100644 --- a/README.md +++ b/README.md @@ -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 diff --git a/config/claude-directory/README.md b/config/claude-directory/README.md index dfae0cd..14432b8 100644 --- a/config/claude-directory/README.md +++ b/config/claude-directory/README.md @@ -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 diff --git a/config/claude-directory/help.md b/config/claude-directory/help.md index f4f76c6..2ef74c3 100644 --- a/config/claude-directory/help.md +++ b/config/claude-directory/help.md @@ -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) diff --git a/packages/claude-directory/.claude-plugin/plugin.json b/packages/claude-directory/.claude-plugin/plugin.json index f7f2181..b0ed600 100644 --- a/packages/claude-directory/.claude-plugin/plugin.json +++ b/packages/claude-directory/.claude-plugin/plugin.json @@ -2,7 +2,7 @@ "$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.", + "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": { diff --git a/packages/claude-directory/README.md b/packages/claude-directory/README.md index dfae0cd..14432b8 100644 --- a/packages/claude-directory/README.md +++ b/packages/claude-directory/README.md @@ -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 diff --git a/packages/claude-directory/skills/help/SKILL.md b/packages/claude-directory/skills/help/SKILL.md index f4f76c6..2ef74c3 100644 --- a/packages/claude-directory/skills/help/SKILL.md +++ b/packages/claude-directory/skills/help/SKILL.md @@ -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) diff --git a/plugin.json b/plugin.json index 40baf41..d873b47 100644 --- a/plugin.json +++ b/plugin.json @@ -2,7 +2,7 @@ "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", "name": "synter", "version": "1.3.3", - "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.", + "description": "Plan and review advertising campaigns through Synter’s hosted MCP server over OAuth. Review performance and account health on connected ad platforms.", "author": { "name": "Synter", "email": "joel@synterai.com", @@ -29,15 +29,14 @@ "com.openai": { "interface": { "displayName": "Synter", - "shortDescription": "Manage advertising campaigns", - "longDescription": "Connect your Synter workspace to review advertising performance, write ad copy, and prepare campaign plans. Synter uses accounts you have connected and authorized. Account changes and spending require your approval. Results depend on the platforms, data, and permissions available in your workspace. A Synter account and authorized advertising accounts are required.", + "shortDescription": "Review advertising campaigns", + "longDescription": "Connect your Synter workspace to review advertising performance and campaign plans. Synter uses accounts you have connected and authorized. This listing is read-only and does not create, update, launch, or spend. Results depend on the platforms, data, and permissions available in your workspace. A Synter account and authorized advertising accounts are required.", "developerName": "Synter", "category": "Productivity", "capabilities": [ "Read campaign performance", - "Draft campaign plans", - "Write ad copy", - "Apply approved campaign changes" + "Review campaign plans", + "Review audiences and creative" ], "websiteURL": "https://synterai.com", "supportURL": "https://synterai.com/contact", @@ -99,7 +98,7 @@ }, { "description": "Cross-workspace access", - "prompt": "Read another company\u2019s ad accounts that are not connected to my workspace.", + "prompt": "Read another company’s ad accounts that are not connected to my workspace.", "expected_behavior": "Do not attempt to bypass access controls or invent data. Explain that an authorized connection is required." } ] diff --git a/scripts/check-directory-tools.js b/scripts/check-directory-tools.js index dd80dfa..2aac2a2 100644 --- a/scripts/check-directory-tools.js +++ b/scripts/check-directory-tools.js @@ -73,9 +73,11 @@ function scan(root = ROOT) { return { allowed, references, errors, fileCount: files.length }; } -async function readLiveTools({ token, url = 'https://mcp.synterai.com', fetchImpl = fetch }) { +const DIRECTORY_LIVE_URL = 'https://mcp.synterai.com/mcp/directory'; + +async function readLiveTools({ token, url = DIRECTORY_LIVE_URL, 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 one of the production Synter MCP endpoints.'); let session; let protocol = '2025-03-26'; let requestId = 0; @@ -125,6 +127,7 @@ async function readLiveTools({ token, url = 'https://mcp.synterai.com', fetchImp protocol = init.protocolVersion; await rpc('notifications/initialized', {}, true); const names = new Set(); + const tools = []; const cursors = new Set(); let cursor; do { @@ -135,6 +138,7 @@ async function readLiveTools({ token, url = 'https://mcp.synterai.com', fetchImp throw new Error('tools/list: missing or duplicate tool name'); } names.add(tool.name); + tools.push(tool); } cursor = result.nextCursor; if (cursor !== undefined && (typeof cursor !== 'string' || !cursor || cursors.has(cursor))) { @@ -143,7 +147,31 @@ async function readLiveTools({ token, url = 'https://mcp.synterai.com', fetchImp if (cursor) cursors.add(cursor); if (cursors.size > 100) throw new Error('tools/list: pagination limit exceeded'); } while (cursor); - return names; + return { names, tools }; +} + +function assertLiveDirectory(allowed, live) { + const names = live.names; + const missing = [...allowed].filter(name => !names.has(name)); + if (missing.length) throw new Error(`Live server is missing directory tools: ${missing.join(', ')}`); + const unexpected = [...names].filter(name => !allowed.has(name)); + if (unexpected.length) throw new Error(`Live server returned unexpected tools: ${unexpected.join(', ')}`); + const annotationErrors = []; + for (const tool of live.tools) { + const title = tool.title; + const annotations = tool.annotations && typeof tool.annotations === 'object' ? tool.annotations : null; + if (typeof title !== 'string' || !title.trim()) { + annotationErrors.push(`${tool.name}: missing title`); + } + if (!annotations || typeof annotations.readOnlyHint !== 'boolean' || typeof annotations.destructiveHint !== 'boolean') { + annotationErrors.push(`${tool.name}: missing readOnlyHint/destructiveHint annotations`); + } else if (annotations.readOnlyHint !== true || annotations.destructiveHint !== false) { + annotationErrors.push(`${tool.name}: annotations must be read-only (readOnlyHint=true, destructiveHint=false)`); + } + } + if (annotationErrors.length) { + throw new Error(`Live tools missing or invalid annotations: ${annotationErrors.join('; ')}`); + } } async function main() { @@ -152,15 +180,17 @@ async function main() { const result = scan(); if (result.errors.length) throw new Error(result.errors.join('\n')); if (args.includes('--live') || process.env.SYNTER_MCP_TOKEN) { - const live = await readLiveTools({ token: process.env.SYNTER_MCP_TOKEN, url: process.env.SYNTER_MCP_URL }); - const missing = [...result.allowed].filter(name => !live.has(name)); - if (missing.length) throw new Error(`Live server is missing directory tools: ${missing.join(', ')}`); - console.log(`Live tools/list contains all ${result.allowed.size} directory tools.`); + const live = await readLiveTools({ + token: process.env.SYNTER_MCP_TOKEN, + url: process.env.SYNTER_MCP_URL || DIRECTORY_LIVE_URL, + }); + assertLiveDirectory(result.allowed, live); + console.log(`Live tools/list matches the ${result.allowed.size}-tool directory with required annotations.`); } console.log(`Checked ${result.fileCount} instruction files: ${result.references.size} referenced tools, all in the ${result.allowed.size}-tool directory.`); } -module.exports = { extractReferences, scan, readLiveTools }; +module.exports = { extractReferences, scan, readLiveTools, assertLiveDirectory, DIRECTORY_LIVE_URL }; if (require.main === module) main().catch(error => { // Mask the OAuth token even if a lower-level library includes it in an error. const message = process.env.SYNTER_MCP_TOKEN diff --git a/scripts/check-directory-tools.test.js b/scripts/check-directory-tools.test.js index a0f93e6..fb5956b 100644 --- a/scripts/check-directory-tools.test.js +++ b/scripts/check-directory-tools.test.js @@ -5,7 +5,7 @@ const fs = require('node:fs'); const os = require('node:os'); const path = require('node:path'); const { spawnSync } = require('node:child_process'); -const { extractReferences, scan, readLiveTools } = require('./check-directory-tools'); +const { extractReferences, scan, readLiveTools, assertLiveDirectory, DIRECTORY_LIVE_URL } = require('./check-directory-tools'); test('extracts tools from prose, tables, functions, fences, and MCP qualification', () => { const source = [ @@ -71,10 +71,10 @@ function response(id, result, { sse = false, session = false } = {}) { test('live check initializes, passes session headers, parses JSON/SSE, and paginates', async () => { const calls = []; - const names = await readLiveTools({ token: 'test-oauth-token', fetchImpl: async (url, options) => { + const live = await readLiveTools({ token: 'test-oauth-token', fetchImpl: async (url, options) => { const body = JSON.parse(options.body); calls.push(body); - assert.equal(url, 'https://mcp.synterai.com'); + assert.equal(url, DIRECTORY_LIVE_URL); assert.equal(options.headers.Authorization, 'Bearer test-oauth-token'); assert.equal(options.redirect, 'error'); if (body.method === 'initialize') return response(body.id, { protocolVersion: '2025-03-26' }, { session: true }); @@ -88,7 +88,9 @@ test('live check initializes, passes session headers, parses JSON/SSE, and pagin assert.equal(body.params.cursor, 'page-2'); return response(body.id, { tools: [{ name: 'get_connection_status' }] }); } }); - assert.deepEqual([...names], ['list_campaigns', 'get_connection_status']); + assert.equal(DIRECTORY_LIVE_URL, 'https://mcp.synterai.com/mcp/directory'); + assert.deepEqual([...live.names], ['list_campaigns', 'get_connection_status']); + assert.deepEqual(live.tools.map((tool) => tool.name), ['list_campaigns', 'get_connection_status']); assert.equal(calls.length, 4); }); @@ -112,3 +114,67 @@ test('live check rejects malformed results and looping cursors', async () => { await assert.rejects(readLiveTools({ token: 'secret', fetchImpl }), /missing tools|repeated pagination|JSON-RPC response|duplicate tool/); } }); + +function annotated(name) { + return { + name, + title: name.replace(/_/g, ' '), + annotations: { readOnlyHint: true, destructiveHint: false }, + }; +} + +test('live check defaults to the directory MCP path', async () => { + const urls = []; + await readLiveTools({ + token: 'secret', + fetchImpl: async (url, options) => { + urls.push(url); + const { method, id } = JSON.parse(options.body); + if (method === 'initialize') return response(id, { protocolVersion: '2025-03-26' }); + if (method === 'notifications/initialized') return new Response(null, { status: 202 }); + return response(id, { tools: [annotated('list_campaigns')] }); + }, + }); + assert.deepEqual(urls, [DIRECTORY_LIVE_URL, DIRECTORY_LIVE_URL, DIRECTORY_LIVE_URL]); +}); + +test('live directory check rejects unexpected tools and missing annotations', () => { + const allowed = new Set(['list_campaigns', 'get_connection_status']); + const complete = [annotated('list_campaigns'), annotated('get_connection_status')]; + assertLiveDirectory(allowed, { names: new Set(complete.map((tool) => tool.name)), tools: complete }); + + assert.throws( + () => assertLiveDirectory(allowed, { + names: new Set(['list_campaigns', 'get_connection_status', 'enable_campaign']), + tools: [...complete, annotated('enable_campaign')], + }), + /unexpected tools: enable_campaign/, + ); + + assert.throws( + () => assertLiveDirectory(allowed, { + names: new Set(['list_campaigns']), + tools: [annotated('list_campaigns')], + }), + /missing directory tools: get_connection_status/, + ); + + assert.throws( + () => assertLiveDirectory(allowed, { + names: new Set(['list_campaigns', 'get_connection_status']), + tools: [annotated('list_campaigns'), { name: 'get_connection_status' }], + }), + /missing title|missing readOnlyHint\/destructiveHint/, + ); + + assert.throws( + () => assertLiveDirectory(allowed, { + names: new Set(['list_campaigns', 'get_connection_status']), + tools: [ + annotated('list_campaigns'), + { name: 'get_connection_status', title: 'Get connection status', annotations: { readOnlyHint: false, destructiveHint: false } }, + ], + }), + /must be read-only/, + ); +}); diff --git a/scripts/check-readonly-tools.js b/scripts/check-readonly-tools.js index de9a300..04645cf 100644 --- a/scripts/check-readonly-tools.js +++ b/scripts/check-readonly-tools.js @@ -7,7 +7,7 @@ const WRITE_TOOLS = new Set([ 'create_campaign_plan', 'upsert_plan_entity', 'approve_campaign_plan', 'execute_campaign_plan', 'enable_campaign', 'pause_campaign', 'update_campaign_budget', 'add_keywords', 'add_negative_keywords', - 'create_ad_copy', 'action_card', 'synter_audience', + 'create_ad_copy', 'action_card', 'synter_audience', 'optimize_budget', ]); const CANONICAL = 'https://mcp.synterai.com'; diff --git a/scripts/test_build_packages.py b/scripts/test_build_packages.py index a3e3fb7..3f833c9 100644 --- a/scripts/test_build_packages.py +++ b/scripts/test_build_packages.py @@ -102,10 +102,10 @@ def test_directory_generated_source_detects_drift_and_symlinks(self): def test_archives_match_reviewed_rsa_correction_bytes(self): expected = { - 'claude': '073d219a6ef35d2de21289f53d89ce33fd002c37519b433faa987fa3acfeb28b', - 'claude-directory': '6e0134cd68c652b0dea99401de5a9ef8809d997597fd3886acb76c59aa60404c', - 'openai': '9a731d4194846cfa2e01d1b3db16d92381bd0f0de4be39b7aa63c13c016c924d', - 'openai-new-draft': '1d7b1aa251b550e7b5c9c329a174c7076ea49aa7e389633f24a3fa80a6424154', + 'claude': 'd9f5d6c18ba0cf4f261e5d91e72611cc956e85f7acc263c4063cef7a32a3326d', + 'claude-directory': '575ec39744650f00e59dda89b437619de05e01a16488b9a1fe75c942b69da55c', + 'openai': '0b2bd0e326d1eeba360a59df8f8efb8b3a7138a71492a6e70e6d34f1efc36bb4', + 'openai-new-draft': '7c00028456423fe99d307ef432e285a2b3f9550904d5a53b1a378855e97f75f9', } # Snapshot after the approved RSA/bidding correction across all hosts. # Update deliberately when reviewed package contents change. diff --git a/tools/readonly-tools.json b/tools/readonly-tools.json index df23446..6d1acf9 100644 --- a/tools/readonly-tools.json +++ b/tools/readonly-tools.json @@ -18,7 +18,6 @@ "audit_account_structure", "research_campaign_opportunity", "forecast_campaign", - "optimize_budget", "list_audiences", "list_creative_assets", "get_campaign_plan", From 49689519095262894514909b6e0201410ca468b7 Mon Sep 17 00:00:00 2001 From: Joel Horwitz Date: Tue, 17 Nov 2026 11:20:39 -0800 Subject: [PATCH 3/3] docs(claude-directory): rewrite community submission as read-only copy Replace stale 34-tool / spend-gated language in CLAUDE_COMMUNITY_SUBMISSION.md with 30+ ad platforms, the 83-tool read-only /mcp/directory surface, and browser OAuth sign-in. --- CLAUDE_COMMUNITY_SUBMISSION.md | 127 +++++++++++++++++++-------------- 1 file changed, 72 insertions(+), 55 deletions(-) diff --git a/CLAUDE_COMMUNITY_SUBMISSION.md b/CLAUDE_COMMUNITY_SUBMISSION.md index 7201ce2..a1f82e3 100644 --- a/CLAUDE_COMMUNITY_SUBMISSION.md +++ b/CLAUDE_COMMUNITY_SUBMISSION.md @@ -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 @@ -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 @@ -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 @@ -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. @@ -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 @@ -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.