# io.github.Synter-Media-AI/synter-ads (remote · mcp.syntermedia.ai) Reporting across 19 ad platforms, campaign creation on 14, write actions on 16, via AI. - Trust score: 36/100 (low) - Registry status: active - Liveness: live - Owner verified: no - Last scored: 2026-10-07 ## Components - remote · `mcp.syntermedia.ai`: 36/100 (this document), [markdown](https://verifymcp.io/servers/synter-media-ai-synter-ads/mcp-2.md), [page](https://verifymcp.io/servers/synter-media-ai-synter-ads/mcp-2) - npm · `@synterai/mcp-server`: 61/100, [markdown](https://verifymcp.io/servers/synter-media-ai-synter-ads/synterai-mcp-server.md), [page](https://verifymcp.io/servers/synter-media-ai-synter-ads/synterai-mcp-server) ## Channel facts - Endpoint: `https://mcp.syntermedia.ai/mcp/` - Transports: `streamable-http` - Auth: `required` - Version: `1.2.4` ## Trust breakdown How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog) Scored 2026-10-07. - **Endpoint Security**: 89/100 - The endpoint's TLS certificate is valid, in date, and uses a strong key. - The endpoint enforces authorisation, advertised via RFC 9728 protected-resource metadata. - HTTPS is enforced; there's no plaintext access path. - HSTS check failed: the Strict-Transport-Security header is absent. - DNSSEC check failed: this domain isn't protected by DNSSEC. - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents. - **Transport & Reachability**: 0/100 - Transport blocked by authentication: the endpoint requires auth we don't have to verify streamable-http. - **Schema Quality & AI Usability**: 0/100 - Schema blocked by authentication: the endpoint requires auth we don't have to read it. - **Stability & Change Management**: 0/100 - Stability not yet verified: not enough scan history yet (needs a 30-day window). - **Tool Coverage**: 0/100 - Tool coverage blocked by authentication: the endpoint requires auth we don't have to read its tools. - **Tool Safety**: 0/100 - Tool safety blocked by authentication: the endpoint requires auth we don't have to read its tools. - **Capabilities**: 0/100 - Capabilities blocked by authentication: the endpoint requires auth we don't have to read them. **Unverified: 6 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm. ## Install ### How do I install the io.github.Synter-Media-AI/synter-ads MCP server? io.github.Synter-Media-AI/synter-ads is a hosted endpoint at https://mcp.syntermedia.ai/mcp/, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation. ### Claude ```bash claude mcp add --transport http synter-media-ai-synter-ads 'https://mcp.syntermedia.ai/mcp/' ``` ### Cursor ```json { "mcpServers": { "synter-media-ai-synter-ads": { "url": "https://mcp.syntermedia.ai/mcp/" } } } ``` ### VS Code ```json { "servers": { "synter-media-ai-synter-ads": { "type": "http", "url": "https://mcp.syntermedia.ai/mcp/" } } } ``` ### Codex ```toml [mcp_servers.synter-media-ai-synter-ads] url = "https://mcp.syntermedia.ai/mcp/" ``` ### opencode ```json { "$schema": "https://opencode.ai/config.json", "mcp": { "synter-media-ai-synter-ads": { "type": "remote", "url": "https://mcp.syntermedia.ai/mcp/", "enabled": true } } } ``` ### OpenClaw ```bash openclaw mcp add synter-media-ai-synter-ads --url 'https://mcp.syntermedia.ai/mcp/' --transport streamable-http ``` ### Hermes ```yaml mcp_servers: synter-media-ai-synter-ads: url: "https://mcp.syntermedia.ai/mcp/" ``` ### Netclaw ```json { "McpServers": { "synter-media-ai-synter-ads": { "Transport": "http", "Url": "https://mcp.syntermedia.ai/mcp/" } } } ``` ### Vellum ```bash assistant mcp add synter-media-ai-synter-ads -t streamable-http -u 'https://mcp.syntermedia.ai/mcp/' ``` ### Other ```json { "mcpServers": { "synter-media-ai-synter-ads": { "type": "http", "url": "https://mcp.syntermedia.ai/mcp/" } } } ``` The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs. ## Changelog Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims. ### 2026-10-03 (score 36, −36) - [security regression] Endpoint reachability: reachable → behind authorisation - [security regression] Tool safety: pass → unverified - [security regression] Transport: pass → unverified - [security] Authorization: The endpoint enforces authorisation, advertised via RFC 9728 protected-resource metadata. - [functional regression] Capabilities: pass → unverified - [functional regression] Tool coverage: 100 → unverified - [functional] First check of Schema quality: unverified ### 2026-10-02 (score 72) First indexed and scored. ## MCP tools (235) ### `get_organic_publishing_readiness` (~107 tokens) Get Organic Publishing Readiness Inspect tenant-bound organic publishing setup for one explicit platform and destination. Provider config and connection ID are optional only as a pair. Separates persisted scope claims from verified effective scopes and reports provider prerequisites without drafting, scheduling, or publishing. [effect=read; scope=social:read] Input parameters: - `account_kind` (string, required) - `account_ref` (string, required) - `platform` (string, required) - `platform_connection_id` - `provider_config_key` ### `draft_organic_post` (~174 tokens) Draft Organic Post Create an immutable, tenant-bound text post draft for an explicitly selected LinkedIn member or company destination. Supply a stable idempotency_key (1-255 non-whitespace characters), unique within the workspace for this intended draft, and reuse that exact key on retries; changing content or destination while reusing it fails closed. The media field is reserved and any non-empty value fails closed until managed media transport exists; never publishes. [effect=write; scope=social:write; requires=campaignPublishing] Input parameters: - `account_kind` (string, required) - `account_ref` (string, required) - `body` (string, required) - `idempotency_key` (string, required) - `media` - `platform` (string, required) - `platform_connection_id` (integer, required) - `provider_config_key` (string, required) ### `validate_organic_post` (~76 tokens) Validate Organic Post Run a non-publishing provider capability preflight for the exact immutable revision, tenant, connection, provider config, LinkedIn member/company destination, token, and effective scopes. [effect=write; scope=social:write; requires=campaignPublishing] Input parameters: - `post_id` (integer, required) - `revision_hash` (string, required) ### `approve_organic_post` (~64 tokens) Approve Organic Post Approve exactly one immutable organic-post revision after successful preflight. Any revision mismatch fails closed; never publishes. [effect=write; scope=social:write; requires=campaignPublishing] Input parameters: - `post_id` (integer, required) - `revision_hash` (string, required) ### `schedule_organic_post` (~80 tokens) Schedule Organic Post Schedule an approved organic-post revision for an exact ISO-8601 time with timezone. Enqueues one non-retrying publication job. [effect=publish; scope=social:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `post_id` (integer, required) - `revision_hash` (string, required) - `scheduled_for` (string, required) ### `publish_organic_post` (~76 tokens) Publish Organic Post Publish an approved, preflighted organic-post revision once to its exact bound destination. Requires separate publish approval and never automatically retries an ambiguous provider outcome. [effect=publish; scope=social:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `post_id` (integer, required) - `revision_hash` (string, required) ### `cancel_scheduled_post` (~68 tokens) Cancel Scheduled Post Cancel an exact scheduled organic-post revision before its one-shot provider job starts. Cancellation remains available when publishing is disabled so queued external mutations can be stopped safely. [effect=state; scope=social:write] Input parameters: - `post_id` (integer, required) - `revision_hash` (string, required) ### `list_scheduled_posts` (~45 tokens) List Scheduled Posts List tenant-owned organic drafts, approvals, schedules, and publication receipts without exposing credentials. [effect=read; scope=social:read] Input parameters: - `limit` (integer) ### `synter_onboarding_start` (~57 tokens) Synter Onboarding Start Start Synter onboarding without an account: returns a sign-in link and code for your human (no API key is ever returned through MCP) [effect=write; scope=workspace:write] Input parameters: - `email` (string) ### `synter_onboarding_status` (~61 tokens) Synter Onboarding Status Check whether the human finished Synter sign-in for a synter_onboarding_start device code; never returns a key [effect=read; scope=workspace:read] Input parameters: - `device_code` (string) - `session_token` (string) ### `pull_google_ads_performance` (~349 tokens) Pull Google Ads Performance Get Google Ads campaign metrics — impressions, clicks, spend, conversions per campaign (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for custom ranges like weekends, or days for a rolling window. last_N_days presets cover the N complete days ending YESTERDAY (Google Ads semantics; use date_range=today for today). segment=date|week breaks metrics out per day or per week (one call for a pacing or creative-fatigue trend — don't loop one call per week). Paginate with limit/offset (next_offset in the result); at level=ads set include_ad_text=false to fit several hundred ads per page. Any window up to 3 years (1095 days) is accepted; long windows are fetched in platform-sized chunks and stitched, and `truncated`/`warnings` in the result say when a read was bounded. IMPORTANT: If the user has multiple Google Ads accounts connected, you MUST ask which account to use BEFORE calling this tool — pass account_name to select it. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `include_ad_text` - `level` (string) - `limit` - `offset` (integer) - `segment` - `start_date` ### `pull_meta_ads_performance` (~239 tokens) Pull Meta Ads Performance Get Meta (Facebook/Instagram) Ads metrics — impressions, clicks, spend, conversions per campaign (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for custom ranges, or days for a rolling window. Any window up to 3 years (1095 days) is accepted; long windows are fetched in platform-sized chunks and stitched, and `truncated`/`warnings` in the result say when a read was bounded. IMPORTANT: If the user has multiple Meta Ads accounts connected, you MUST ask which account to use BEFORE calling this tool — pass account_name to select it. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `level` (string) - `start_date` ### `get_campaign_observation` (~125 tokens) Get Campaign Observation Independent read-only native campaign observation v1 for explicitly enrolled Google, Meta or LinkedIn test accounts. Requires exact workspace, connection and account. Returns provider fields and pagination/provenance, never a parity or delivery verdict. No creation, repair, activation, report jobs or model calls. Unenrolled accounts fail closed. [effect=read; scope=campaigns:read] Input parameters: - `account_id` (string, required) - `campaign_id` (string, required) - `connection_id` (integer, required) - `platform` (string, required) - `workspace_id` (integer, required) ### `get_ad_readback` (~110 tokens) Get Ad Readback Proof Pack: read a launched ad's creative + CTA back from the platform API (the source of truth) and verify the CTA against the platform enum and the copy against ad policy (2 credits). Meta, Reddit, and LinkedIn supported today; other platforms return a clearly-labeled unsupported result. [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `ad_id` (string, required) - `approved_cta` - `platform` (string, required) ### `pull_linkedin_ads_performance` (~251 tokens) Pull LinkedIn Ads Performance Get LinkedIn Ads metrics — impressions, clicks, spend, conversions per campaign (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for custom ranges, or days for a rolling window. Any window up to 3 years (1095 days) is accepted; long windows are fetched in platform-sized chunks and stitched, and `truncated`/`warnings` in the result say when a read was bounded. Pass campaign_group_ids (comma-separated) to filter to specific campaign groups. IMPORTANT: If the user has multiple LinkedIn accounts connected, you MUST ask which account to use BEFORE calling this tool — pass account_name to select it. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `campaign_group_ids` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_x_ads_performance` (~254 tokens) Pull X Ads Performance Get X (Twitter) Ads metrics — impressions, clicks, spend, conversions per campaign (2 credits). Filter by campaign_id/campaign_ids to inspect specific campaigns. Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for custom ranges, or days for a rolling window. Any window up to 3 years (1095 days) is accepted; long windows are fetched in platform-sized chunks and stitched, and `truncated`/`warnings` in the result say when a read was bounded. IMPORTANT: If the user has multiple X Ads accounts connected, you MUST ask which account to use BEFORE calling this tool — pass account_name to select it. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `campaign_id` - `campaign_ids` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_reddit_ads_performance` (~228 tokens) Pull Reddit Ads Performance Get Reddit Ads metrics — impressions, clicks, spend, conversions per campaign (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for custom ranges, or days for a rolling window. Any window up to 3 years (1095 days) is accepted; long windows are fetched in platform-sized chunks and stitched, and `truncated`/`warnings` in the result say when a read was bounded. IMPORTANT: If the user has multiple Reddit Ads accounts connected, you MUST ask which account to use BEFORE calling this tool — pass account_name to select it. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_microsoft_ads_performance` (~232 tokens) Pull Microsoft Ads Performance Get Microsoft (Bing) Ads metrics — impressions, clicks, spend, conversions per campaign (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for custom ranges, or days for a rolling window. Any window up to 3 years (1095 days) is accepted; long windows are fetched in platform-sized chunks and stitched, and `truncated`/`warnings` in the result say when a read was bounded. IMPORTANT: If the user has multiple Microsoft Ads accounts connected, you MUST ask which account to use BEFORE calling this tool — pass account_name to select it. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_tiktok_ads_performance` (~243 tokens) Pull TikTok Ads Performance Get TikTok Ads metrics — impressions, clicks, spend, conversions per campaign (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for custom ranges, or days for a rolling window. Any window up to 3 years (1095 days) is accepted; long windows are fetched in platform-sized chunks and stitched, and `truncated`/`warnings` in the result say when a read was bounded. For detailed video engagement metrics use tiktok_ads_get_insights. IMPORTANT: If the user has multiple TikTok Ads accounts connected, you MUST ask which account to use BEFORE calling this tool — pass account_name to select it. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_amazon_dsp_performance` (~161 tokens) Pull Amazon DSP Performance Pull Amazon DSP campaign performance data (2 credits) Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Amazon reporting retains about 90 days, so windows are capped there. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_amazon_ads_performance` (~235 tokens) Pull Amazon Ads Performance Get Amazon Ads (Sponsored Products/Brands/Display) metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Amazon reporting retains about 90 days, so windows are capped there. When counting 'live' campaigns, only count campaigns with state=ENABLED AND active ad groups with budget remaining — ARCHIVED campaigns are NOT active. IMPORTANT: If the user has multiple Amazon Ads accounts connected, you MUST ask which account to use BEFORE calling this tool — pass account_name to select it. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `ad_type` (string) - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_pinterest_ads_performance` (~182 tokens) Pull Pinterest Ads Performance Get Pinterest Ads metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. IMPORTANT: If the user has multiple Pinterest ad accounts connected, you MUST ask which account to use BEFORE calling this tool — pass account_name to select it. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `level` (string) - `start_date` ### `pull_snap_ads_performance` (~162 tokens) Pull Snap Ads Performance Get Snapchat Ads metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Use account_name to specify which account when multiple are connected. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `level` (string) - `start_date` ### `pull_spotify_ads_performance` (~156 tokens) Pull Spotify Ads Performance Get Spotify Ads metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Use account_name to specify which account when multiple are connected. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_openai_ads_performance` (~231 tokens) Pull OpenAI Ads Performance Get OpenAI Ads metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Pulls insights from the OpenAI Ads API. Optional scope: campaign_id, ad_group_id, or ad_id to scope the report. Defaults to the selected scope's natural aggregation level; unscoped defaults to ad_account. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `ad_group_id` - `ad_id` - `aggregation_level` - `campaign_id` - `date_range` - `days` (integer) - `end_date` - `limit` (integer) - `start_date` - `time_granularity` ### `pull_trade_desk_performance` (~200 tokens) Pull Trade Desk Performance Get The Trade Desk metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for custom ranges, or days for a rolling window. Any window up to 3 years (1095 days) is accepted; long windows are fetched in platform-sized chunks and stitched, and `truncated`/`warnings` in the result say when a read was bounded. Use account_name to specify which account when multiple are connected. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_freewheel_performance` (~205 tokens) Pull FreeWheel Performance Get FreeWheel Buyer Cloud (Beeswax) metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for custom ranges, or days for a rolling window. Any window up to 3 years (1095 days) is accepted; long windows are fetched in platform-sized chunks and stitched, and `truncated`/`warnings` in the result say when a read was bounded. Use account_name to specify which account when multiple are connected. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `get_spend_reconciliation` (~119 tokens) Get Spend Reconciliation Cross-platform reconciliation MVP — compares Google Ads ↔ Trade Desk totals for a date range, returns normalized per-platform metrics, discrepancies, and deterministic likely-cause explanations. Read-only. Date range capped to 92 days. SYN-2480. [effect=read; scope=measurement:read] Input parameters: - `end_date` (string, required) - `google_account_id` - `google_account_name` - `start_date` (string, required) - `ttd_account_name` - `ttd_advertiser_id` ### `pull_dv360_performance` (~163 tokens) Pull DV360 Performance Get Display & Video 360 (DV360) metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Use account_name to specify which account when multiple are connected. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_cm360_performance` (~161 tokens) Pull CM360 Performance Get Campaign Manager 360 (CM360) metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Use account_name to specify which account when multiple are connected. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_walmart_ads_performance` (~160 tokens) Pull Walmart Ads Performance Get Walmart Connect Advertising metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Returns impressions, clicks, spend, conversions, and ROAS per campaign. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_instacart_ads_performance` (~163 tokens) Pull Instacart Ads Performance Get Instacart Ads metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Returns impressions, clicks, spend, attributed orders, and attributed sales per campaign. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_target_roundel_performance` (~161 tokens) Pull Target Roundel Performance Get Target Roundel retail media metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Returns impressions, clicks, spend, conversions, and revenue per campaign. [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `pull_criteo_ads_performance` (~162 tokens) Pull Criteo Ads Performance Get Criteo Commerce Media metrics (2 credits). Date window: date_range preset (today, yesterday, last_7_days, last_14_days, last_30_days, last_90_days, last_180_days, last_365_days, last_2_years, last_3_years), start_date/end_date (YYYY-MM-DD) for a fixed historical range, or days for a rolling window. Returns displays, clicks, cost, conversions, and revenue per campaign. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `date_range` - `days` (integer) - `end_date` - `start_date` ### `tiktok_ads_get_insights` (~93 tokens) TikTok Ads Get Insights Get TikTok Ads performance report with video metrics (2 credits). Returns spend, impressions, clicks, CTR, conversions, CPA, ROAS, and TikTok-specific video engagement metrics per campaign/adgroup/ad. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `data_level` (string) - `days` (integer) ### `tiktok_ads_get_adgroup` (~76 tokens) TikTok Ads Get Ad Group Get full TikTok ad group configuration (free). Returns targeting, budget, bid, pixel, optimization goal, languages, locations, age groups, identity. [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `account_name` - `adgroup_id` (string, required) ### `tiktok_ads_get_ad_groups` (~70 tokens) TikTok Ads Get Ad Groups List all TikTok ad groups, optionally filtered by campaign (free). Returns ID, name, status, budget, bid, optimization goal. [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `account_name` - `campaign_id` ### `tiktok_ads_get_ads` (~75 tokens) TikTok Ads Get Ads List all TikTok ads, optionally filtered by ad group (free). Returns ad_id, ad_name, adgroup_id, campaign_id, status, ad_format. [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `account_name` - `adgroup_id` ### `tiktok_ads_update_adgroup` (~155 tokens) TikTok Ads Update Ad Group Update a TikTok ad group: status, budget, locations, age targeting, bid, languages, audiences, optimization goal, pixel tracking (5 credits) [effect=write; scope=campaigns:write; externalMutation=true] Input parameters: - `account_id` - `account_name` - `adgroup_id` (string, required) - `age_max` - `age_min` - `audience_ids` - `bid` - `bid_type` - `budget` - `conversion_event` - `excluded_audience_ids` - `languages` - `locations` - `optimization_goal` - `pixel_id` - `status` ### `tiktok_ads_get_campaign` (~65 tokens) TikTok Ads Get Campaign Get full TikTok campaign configuration by ID (free). Returns name, objective, budget, status, timestamps. [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `account_name` - `campaign_id` (string, required) ### `list_gtm_containers` (~51 tokens) List GTM Containers List Google Tag Manager accounts and containers for the connected GTM user. Returns each account's id/name and its containers' id/name/publicId. [effect=read; scope=tracking:read] ### `list_gtm_tags` (~83 tokens) List GTM Tags List published GTM tags by default; source=workspace inspects unpublished drafts. Returns tag summaries: tagId, name, type, paused. Pass account_id/container_id, or rely on the connection's defaults. [effect=read; scope=tracking:read] Input parameters: - `account_id` - `container_id` - `source` (string) ### `get_gtm_tag` (~67 tokens) Get GTM Tag Get the full definition of one GTM tag, including its parameters (the html body for Custom HTML tags) and firing triggers. [effect=read; scope=tracking:read] Input parameters: - `account_id` - `container_id` - `tag_id` (string, required) ### `update_gtm_tag_html` (~101 tokens) Update GTM Tag HTML Replace the HTML body of an existing GTM Custom HTML tag. MODIFIES LIVE SITE TRACKING once the container is published. Only type 'html' tags are allowed; the change stays in the workspace until publish_gtm_container runs. [effect=write; scope=tracking:write; externalMutation=true] Input parameters: - `account_id` - `container_id` - `html` (string, required) - `tag_id` (string, required) ### `update_gtm_tag` (~228 tokens) Update GTM Tag Pause/unpause a GTM tag of ANY type, replace its HTML body, or set its parameters — including the conversion VALUE (set_param conversionValue on a Google Ads tag, set_event_param value on a GA4 event tag). MODIFIES LIVE SITE TRACKING once published or when publish=true is passed. Use this (not update_gtm_tag_html) for non-HTML tags like Google Ads/Meta/LinkedIn conversion tags — e.g. pausing a duplicate conversion tag. Pausing a conversion tag (awct/gclidw/sp/gaawe, or a name matching conversion/signup/purchase/lead) requires i_checked_conversion_volume=true or the underlying script refuses — see its parameter description. [effect=write; scope=tracking:write; externalMutation=true] Input parameters: - `account_id` - `container_id` - `html` - `i_checked_conversion_volume` (boolean) - `pause` - `publish` (boolean) - `set_event_param` - `set_param` - `tag_id` (string, required) ### `publish_gtm_container` (~89 tokens) Publish GTM Container Publish a GTM container — creates a version from the default workspace and publishes it. PUSHES ALL WORKSPACE CHANGES LIVE to the site's tracking immediately. Approval-gated. [effect=publish; scope=tracking:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `account_id` - `conflict_resolution` - `container_id` - `version_name` ### `run_gaql_query` (~68 tokens) Run GAQL Query Execute a Google Ads Query Language (GAQL) query (2 credits). Use account_name to specify which account when multiple are connected. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `account_name` - `query` (string, required) ### `ga4_get_properties` (~38 tokens) GA4 Get Properties List your Google Analytics 4 properties (free) [effect=read; scope=reporting:read] Input parameters: - `account_id` ### `ga4_get_report` (~81 tokens) GA4 Get Report Run a Google Analytics 4 report (free). Pass property_id to query a specific GA4 property instead of the connection default. [effect=read; scope=reporting:read] Input parameters: - `account_id` - `days` (integer) - `dimensions` (string) - `metrics` (string) - `property_id` ### `ga4_get_conversions` (~58 tokens) GA4 Get Conversions List GA4 conversion events (free). Pass property_id to query a specific GA4 property instead of the connection default. [effect=read; scope=tracking:read] Input parameters: - `account_id` - `property_id` ### `verify_pixel_ownership` (~89 tokens) Verify Pixel Ownership Cross-validate that the pixel/tag IDs on a landing page belong to the connected ad account. Detects wrong-pixel installs, domain registration gaps, and CAPI mismatches. Free — no credits. [effect=read; scope=tracking:read] Input parameters: - `account_id` - `page_pixel_id` - `platform` (string, required) - `url` (string, required) ### `list_campaigns` (~51 tokens) List Campaigns List campaigns for any ad platform [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `account_name` - `platform` (string, required) - `status` ### `pause_campaign` (~62 tokens) Pause Campaign Pause a campaign on any ad platform (2 credits) [effect=state; scope=campaigns:state; externalMutation=true] Input parameters: - `account_id` - `account_name` - `campaign_id` (string, required) - `platform` (string, required) ### `meta_ads_create_ad` (~176 tokens) Meta Ads Create Ad Create a Meta (Facebook/Instagram) ad in an existing ad set (20 credits) [effect=write; scope=campaigns:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `account_id` - `account_name` - `adset_id` (string, required) - `allow_weak_creative_variants` (boolean) - `call_to_action` - `creative_id` - `description` - `descriptions` - `headline` - `headlines` - `image_hash` - `image_url` - `instagram_user_id` - `link` - `message` - `messages` - `name` (string, required) - `page_id` - `status` (string) - `video_id` ### `reddit_ads_create_ad` (~109 tokens) Reddit Ads Create Ad Create a Reddit ad from an existing post in an ad group (20 credits) [effect=write; scope=campaigns:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `account_id` - `account_name` - `ad_group_id` (string, required) - `campaign_name` - `click_url` - `name` - `no_utm` (boolean) - `post_id` (string, required) - `status` (string) ### `enable_campaign` (~70 tokens) Enable Campaign Enable/resume a paused campaign on any ad platform (2 credits) [effect=state; scope=campaigns:state; requires=campaignPublishing; externalMutation=true] Input parameters: - `account_id` - `account_name` - `campaign_id` (string, required) - `platform` (string, required) ### `update_campaign_budget` (~97 tokens) Update Campaign Budget Update a campaign's daily budget (5 credits). DV360 is intentionally excluded because insertion orders use time-bound total budget segments; use dv360_update_io_budget directly with explicit total-budget semantics. [effect=write; scope=budget:write; externalMutation=true] Input parameters: - `account_id` - `account_name` - `campaign_id` (string, required) - `daily_budget` (number, required) - `platform` (string, required) ### `list_connected_accounts` (~76 tokens) List Connected Accounts See ALL connected accounts with pagination: ad platforms, analytics (GA4, PostHog), CRM (HubSpot, Attio), and more (free) [effect=read; scope=connections:read] Input parameters: - `limit` (integer) - `offset` - `page` (integer) - `platform` ### `verify_platform_accounts` (~87 tokens) Verify Platform Accounts Verify which ad account each platform's pull tools would use by default, with recent activity per connected account. Flags when the default account is dormant while a sibling account has spend (free). Call this before pull_*_performance when a platform has multiple accounts or returns suspicious zeros. [effect=read; scope=connections:read] Input parameters: - `days` (integer) - `platform` ### `list_available_scripts` (~28 tokens) List Available Scripts See all available PPC scripts (free) [effect=read; scope=workspace:read] ### `inspect_script` (~51 tokens) Inspect Script Get the exact arguments, choices, required fields, and output fields for a Synter action before executing it (free) [effect=read; scope=workspace:read] Input parameters: - `script_name` (string, required) ### `read_google_drive_file` (~79 tokens) Read Google Drive File Read a Picker-attached Google Drive file by file_id, or a public Google Drive/Docs file or folder by URL. Public folders return a bounded recursive listing; call this tool again with a returned file URL to extract its content. [effect=read; scope=workspace:read] Input parameters: - `file_id` - `url` ### `create_google_doc` (~56 tokens) Create Google Doc Create and read back a complete Google Doc from substantive markdown or HTML content (5 credits) [effect=write; scope=workspace:external_docs] Input parameters: - `content` - `html` - `title` (string, required) ### `publish_to_github` (~127 tokens) Publish To GitHub Publish a markdown blog post to a connected GitHub repo: commit /.md and open a PR for the customer to review and merge (never pushes directly). Free. [effect=publish; scope=workspace:code; requires=campaignPublishing; externalMutation=true] Input parameters: - `base_branch` - `category` - `content_path` - `date` - `description` - `markdown` (string, required) - `open_pr` - `slug` (string, required) - `tags` - `title` (string, required) ### `create_google_sheet` (~63 tokens) Create Google Sheet Create, populate, and read back a complete Google Sheet from tabular data (5 credits) [effect=write; scope=workspace:external_docs] Input parameters: - `headers` - `json_data` - `rows` - `title` (string, required) ### `read_google_sheet` (~73 tokens) Read Google Sheet Read tabular data (e.g. a media plan / campaign brief) from a connected Google Sheet (free) [effect=read; scope=workspace:read] Input parameters: - `header_row` (integer) - `max_rows` - `range` - `spreadsheet_id` - `url` ### `update_google_sheet` (~81 tokens) Update Google Sheet Write values (e.g. campaign IDs / status / spend) back into a range of an existing Google Sheet (2 credits) [effect=write; scope=workspace:external_docs] Input parameters: - `range` (string, required) - `spreadsheet_id` - `url` - `value_input_option` (string) - `values` (string, required) ### `create_landing_page` (~100 tokens) Create Landing Page Generate an AI landing page hosted on your custom domain (600 credits) [effect=write; scope=landing_pages:write] Input parameters: - `brand_url` - `cta_text` (string) - `cta_url` (string, required) - `idempotency_key` - `lead_form` - `prompt` (string, required) - `slug` - `style` (string) - `title` (string, required) ### `document_authoring_read` (~81 tokens) Document Authoring Read Read canonical persisted Synter document content, full artboard designs, dashboard widgets and whole-document revision. Requires document UUID and explicit project UUID (null outside projects). No browser is required. Use this before document_authoring_apply. [effect=read; scope=campaigns:read] Input parameters: - `document_id` (string, required) - `project_id` (required) ### `document_authoring_apply` (~161 tokens) Document Authoring Apply Persist one atomic draft-authoring operation on a Synter document: artboard.create (caller UUID widget_id, name, width, height, optional ops), artboard.edit (widget_id, studio ops), or dashboard.arrange (arrangement of widget_id,x,y,width,height). Requires the expected_revision from document_authoring_read and explicit project UUID/null. Returns committed canonical readback and changed IDs, never a streamed intent. Stale retries fail 409: read and reconcile, do not blindly reapply. Does not render, publish or spend. [effect=write; scope=campaigns:write] Input parameters: - `document_id` (string, required) - `expected_revision` (string, required) - `operation` (object, required) - `project_id` (required) ### `create_embed` (~117 tokens) Create Embed Create a reusable native Synter form, event registration, customer shopping cart, Synter plan or usage-funds purchase card, checkout link, or media block for any paid or organic destination. Use list_embeds to inspect native-vs-hosted platform capabilities. [effect=write; scope=landing_pages:write] Input parameters: - `allowed_origins` - `commerce_connection_id` - `config` - `fields` - `kind` (string, required) - `name` (string, required) - `published` (boolean) ### `update_embed` (~78 tokens) Update Embed Update a workspace-owned native Synter embed. [effect=write; scope=landing_pages:write] Input parameters: - `allowed_origins` - `commerce_connection_id` - `config` - `embed_id` (string, required) - `field_mappings` - `fields` - `name` - `published` ### `list_embeds` (~41 tokens) List Embeds List reusable embeds plus the complete paid-platform and organic-channel native-vs-hosted form capability matrix. [effect=read; scope=landing_pages:read] ### `get_embed` (~41 tokens) Get Embed Get the full configuration for one workspace-owned native Synter embed. [effect=read; scope=landing_pages:read] Input parameters: - `embed_id` (string, required) ### `get_embed_code` (~41 tokens) Get Embed Code Get install code for a workspace-owned native Synter embed. [effect=read; scope=landing_pages:read] Input parameters: - `embed_id` (string, required) ### `list_embed_submissions` (~49 tokens) List Embed Submissions List recent submissions for a workspace-owned form or event embed. [effect=read; scope=landing_pages:read] Input parameters: - `embed_id` (string, required) - `limit` (integer) ### `list_embed_purchases` (~52 tokens) List Embed Purchases List and reconcile recent Stripe purchase receipts for a workspace-owned customer cart embed. [effect=read; scope=landing_pages:read] Input parameters: - `embed_id` (string, required) - `limit` (integer) ### `set_embed_crm_destination` (~77 tokens) Set Embed CRM Destination Route a Synter form or event embed to exactly one active CRM connection in the current workspace. [effect=write; scope=landing_pages:write; requires=crmIntegrations] Input parameters: - `connection_id` - `crm_provider` (string, required) - `embed_id` (string, required) - `field_mappings` ### `create_verified_page_replica` (~79 tokens) Create Verified Page Replica Create an unpublished, verified iframe replica draft for a source and custom domain you control. [effect=write; scope=landing_pages:write] Input parameters: - `attest_authorized` (boolean, required) - `custom_domain` (string, required) - `slug` (string, required) - `source_url` (string, required) - `title` (string) ### `update_verified_page_replica` (~52 tokens) Update Verified Page Replica Get status, verify, or revoke source ownership for a verified page replica. [effect=write; scope=landing_pages:write] Input parameters: - `action` (string) - `slug` (string, required) ### `publish_landing_page` (~87 tokens) Publish Landing Page Publish a landing page draft, making it live at syntermedia.ai/lp/{slug} (free). A page that lost its last benchmark_landing_page run is refused until fixed or acknowledged. [effect=publish; scope=landing_pages:publish; requires=campaignPublishing; externalMutation=true] Input parameters: - `acknowledge_benchmark` (boolean) - `slug` (string, required) ### `create_landing_page_variants` (~168 tokens) Create Landing Page Variants Per-ad landing pages from ONE approved canvas framework, bound to real ads. Keeps the framework's section order, theme, offer and CTA verb; swaps only the message-match slots (hero headline := the ad's promise, subtitle := primary text, badge := audience, CTA verb := the ad's CTA) and names the page after the ad. Each variant records its ad (platform, campaign_id, ad_id) on the canvas document so attribution reads back per ad. Pass ads exactly as read from the platform; never invent copy. Each NEW hosted page is charged like create_landing_page; re-deriving an existing variant is free. [effect=write; scope=landing_pages:write] Input parameters: - `ads` (array, required) - `framework_slug` (string, required) ### `benchmark_landing_page` (~183 tokens) Benchmark Landing Page Measure whether our landing page looks and converts better than the pages this traffic would otherwise land on. Captures ours and up to 5 competitor URLs at desktop (1280) and mobile (390), scores every page on one rubric (CTA above the fold, h1, no horizontal overflow, load time, conversion surface, proof, copy length) plus a vision design read, and ranks them. Returns wins, rank, a leaderboard and gaps — the dimensions a competitor beats us on, i.e. the next studio_edit_landing_page batch. Recorded on the canvas page; publish_landing_page refuses a page that lost until fixed or acknowledged. Free; runs 20-90s. [effect=write; scope=landing_pages:write] Input parameters: - `competitor_urls` (array, required) - `slug` (string, required) - `vision` (boolean) ### `studio_inspect_landing_page` (~135 tokens) Studio Inspect Landing Page Read a landing page as a canvas document: indexed sections (type + full props), theme, nav, footer, metadata and a revision. Every page generated by create_landing_page is a canvas document (render_mode=schema). Call before studio_edit_landing_page and pass the revision back as expected_revision. screenshots=True also returns desktop (1280) + mobile (390) render-verify PNGs with layout diagnostics (horizontal overflow, CTA above the fold, h1 present). [effect=read; scope=landing_pages:read] Input parameters: - `screenshots` (boolean) - `slug` (string, required) ### `studio_edit_landing_page` (~272 tokens) Studio Edit Landing Page Edit a canvas landing page with structured section ops — the landing-page twin of studio_edit_artboard; never write HTML. Atomic: invalid ops, an off-theme color/font or a stale revision saves nothing and returns every problem. On success the page is re-rendered, versioned, purged at the edge if published, and returned with desktop + mobile screenshots and layout diagnostics. Free edit of a page you own. ops (max 50): add_section {type, props, index?} | update_section {section_index, props (shallow merge; null deletes a key)} | replace_section {section_index, type, props} | remove_section {section_index} | reorder_section {section_index, to_index} | set_theme {theme} | set_nav {nav|null} | set_footer {footer|null} | set_metadata {metadata}. Section types: hero, personalized_hero, video, scheduler_embed, native_form, workspace_embed, comparison_table, social_proof, features, pricing, testimonials, faq, cta, stats_bar, how_it_works, logo_marquee. [effect=write; scope=landing_pages:write] Input parameters: - `expected_revision` - `ops` (array, required) - `screenshots` (boolean) - `slug` (string, required) ### `update_landing_page_html` (~104 tokens) Update Landing Page HTML Update the HTML content of an existing landing page you own without AI regeneration (free edit). Use this to patch copy, add logos, or tweak layout after reviewing a draft. If the slug does not exist yet, this creates a new hosted page and is billed like create_landing_page; forecast_tool_cost has the live rate. [effect=write; scope=landing_pages:write] Input parameters: - `html_content` (string, required) - `slug` (string, required) ### `update_landing_page_tracking` (~147 tokens) Update Landing Page Tracking Set workspace-owned landing-page pixels, GA4, and the Google Ads conversion label, and wire a Fillout embed so form submits count as campaign conversions using the existing workspace integrations. Free edit of a page you own. Returns google_send_to plus a Fillout webhook URL. [effect=write; scope=landing_pages:write] Input parameters: - `fillout_form_id` - `ga4_measurement_id` - `google_conversion_label` - `google_pixel_id` - `linkedin_pixel_id` - `meta_pixel_id` - `reddit_pixel_id` - `rotate_webhook_token` (boolean) - `slug` (string, required) ### `upload_landing_page_html` (~142 tokens) Upload Landing Page HTML Upload raw HTML as a new landing-page draft (no AI generation). Use to import an exported .html file or hand-written markup (embedded forms, Cal.com embeds, thank-you pages all supported). Then publish_landing_page and attach it to an ad campaign. Creating a new hosted page is billed like create_landing_page (forecast_tool_cost has the live rate); re-uploading to a slug you already own is a free edit. [effect=publish; scope=landing_pages:publish; requires=campaignPublishing; externalMutation=true] Input parameters: - `html_content` (string, required) - `slug` (string) - `title` (string) ### `setup_custom_domain` (~69 tokens) Setup Custom Domain Assign a custom domain (e.g. go.acme.com) to a published landing page. Requires an active paid or pay-as-you-go plan. No credits charged. [effect=write; scope=landing_pages:write] Input parameters: - `domain` (string, required) - `slug` (string, required) ### `verify_custom_domain` (~47 tokens) Verify Custom Domain Check if DNS is configured for a landing page's custom domain. Free — no credits charged. [effect=read; scope=landing_pages:read] Input parameters: - `slug` (string, required) ### `execute` (~249 tokens) Execute Execute any Synter action: create campaigns, upload to YouTube, manage GTM/GA4, analyze competitors, and more. Calls execute immediately by default; pass dry_run=true only when the user explicitly asks for validation-only behavior. Use inspect_script before the first call to an unfamiliar action so arguments are never guessed. Pass expected_names={"campaign-id": ""} to hard-enforce target identity for updates. MULTIPLE ACCOUNTS ARE THE NORM: most platforms have more than one connected account, and account_id selects which one this call uses. Omit it and the workspace default is used, which is NOT always the account you want and may be one with no usable credential. If a call fails on credentials, returns suspicious zeros, or the platform has several accounts, call verify_platform_accounts first to see the default and its siblings, then re-run with account_id. [effect=write; scope=scripts:execute] Input parameters: - `account_id` - `action` (string, required) - `args` - `customer_id` - `dry_run` (boolean) - `expected_names` - `idempotency_key` - `platform` ### `get_job_status` (~61 tokens) Get Job Status Check the status of an async job (e.g. audience sync). Returns job status, result on success, or error on failure. Free - no credits charged. [effect=read; scope=workspace:read] Input parameters: - `job_id` (string, required) ### `sync_audience` (~310 tokens) Sync Audience Upload audience data (emails, phones, MAIDs, companies, a public CSV URL, or a private artifact id) to ad platforms. Supports inline pre-hashed identifiers, artifact-id references for >1k entries, and batch mode for Clay.com row-by-row workflows (staging is free; upload costs 10 credits for the call plus 6 credits per delivered record — both only on success). REQUIRED FROM 2026-05-21: pass i_have_consent=True confirming the customer has lawful basis under GDPR/CCPA and platform Customer Match terms for every identifier in the audience. [effect=write; scope=audiences:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `account_id` - `audience_name` - `audience_type` (string) - `batch_action` - `batch_key` - `company_domains` - `company_names` - `csv_path` - `csv_url` - `customer_file_source` - `emails` - `emails_artifact_id` - `hashed_emails` - `hashed_emails_artifact_id` - `hashed_mobile_ids` - `hashed_phones` - `hashed_phones_artifact_id` - `i_have_consent` - `mobile_ids` - `mobile_ids_artifact_id` - `phones` - `phones_artifact_id` - `platform` (string, required) ### `build_abm_audience` (~178 tokens) Build ABM Audience [INTERNAL — Synter staff only] Build an ad-platform Custom Audience from verified decision-maker emails for a list of target company domains. Pulls valid emails from Synter's audience data warehouse, SHA-256 hashes locally, uploads to the requested platform (LINKEDIN, META, GOOGLE, REDDIT, X, MICROSOFT, TIKTOK). Requires INTERNAL_ABM_SERVICE_TOKEN and INTERNAL_ABM_MCP_USER_IDS env vars to be configured; the caller's user_id must be on that allowlist. [effect=write; scope=audiences:write; externalMutation=true] Input parameters: - `account_id` (string, required) - `audience_name` (string, required) - `decision_makers_only` (boolean) - `domains` (string, required) - `max_contacts` - `platform` (string, required) ### `stage_audience_artifact` (~130 tokens) Stage Audience Artifact Stage a hashed-PII payload (newline-delimited identifiers) in Synter's private artifact store and return an opaque artifact_id. Pass that id to sync_audience via *_artifact_id parameters. FREE — no credits charged. Use this instead of pasting hashed identifiers as inline tool args when you have more than ~500 entries. [effect=write; scope=audiences:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `body` (string, required) - `i_have_consent` - `script_name` (string) - `ttl_seconds` (integer) ### `create_campaign_for_audience` (~106 tokens) Create Campaign For Audience Create a campaign targeting an existing audience (1000 credits — campaign launch) [effect=publish; scope=campaigns:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `account_id` - `audience_id` (string, required) - `campaign_name` (string, required) - `daily_budget` (number) - `description` - `final_url` - `headline` - `image_url` - `platform` (string, required) ### `list_audiences` (~42 tokens) List Audiences List existing audiences on an ad platform [effect=read; scope=audiences:read] Input parameters: - `account_id` - `platform` (string, required) ### `delete_audience` (~111 tokens) Delete Audience Delete (or close) a custom/matched audience from an ad platform by exact audience_id. Use to clean up stale or errored (e.g. NOT_ENOUGH_MATCHES) audiences. Meta, Reddit, and Google are supported. Meta verifies the audience belongs to the resolved ad account before deletion. This is irreversible. [effect=write; scope=audiences:write; externalMutation=true] Input parameters: - `account_id` - `audience_id` (string, required) - `platform` (string, required) ### `pull_linkedin_company_engagement` (~99 tokens) Pull LinkedIn Company Engagement Pull LinkedIn Ads Company Engagement report — shows which companies have seen your ads and how engaged they are (2 credits) [effect=read; scope=reporting:read] Input parameters: - `account_id` - `audience_id` - `country` - `days` (integer) - `engagement_level` - `limit` (integer) - `max_employees` - `min_employees` ### `get_llm_visibility_overview` (~75 tokens) Get LLM Visibility Overview FREE (no credit cost): Get the workspace-native Synter LLM visibility overview, including mention/citation/share-of-voice/coverage metrics, engine exclusions, source domains, sightings, and ranked opportunities. [effect=read; scope=intel:read] Input parameters: - `days` - `project_id` ### `list_llm_visibility_prompts` (~67 tokens) List LLM Visibility Prompts FREE (no credit cost): List tracked buying prompts and their latest answer evidence in the active Synter workspace. [effect=read; scope=intel:read] Input parameters: - `active_only` - `limit` - `project_id` - `search` ### `list_llm_visibility_sightings` (~68 tokens) List LLM Visibility Sightings FREE (no credit cost): List evidence-backed competitive ChatGPT ad, Reddit citation, and YouTube citation sightings from Synter. [effect=read; scope=intel:read] Input parameters: - `limit` - `project_id` - `sighting_type` ### `list_llm_visibility_opportunities` (~59 tokens) List LLM Visibility Opportunities FREE (no credit cost): List ranked, evidence-backed Synter visibility gaps and their recommended actions. [effect=read; scope=intel:read] Input parameters: - `limit` - `project_id` - `status` ### `recommend_llm_visibility_strategy` (~96 tokens) Recommend LLM Visibility Strategy Recommend tailored Generative Engine Optimization (GEO) content strategies, PR drafts, community response tactics, structured schema markup, and authoritative citation building to drive brand visibility in ChatGPT, Claude, Perplexity, and AI Overviews for tracked buying prompts. [effect=read; scope=intel:read] Input parameters: - `focus_area` - `limit` - `project_id` - `prompt_id` ### `discover_llm_visibility_prompts` (~88 tokens) Discover LLM Visibility Prompts Discover and generate high-intent B2B commercial buying prompts across Evaluation, Direct Comparison, Alternatives, Pricing/ROI, and Feature Verification intent stages for your brand and competitors. [effect=read; scope=intel:read] Input parameters: - `auto_seed` - `competitors` - `domain` - `icp_persona` - `project_id` ### `audit_llm_crawler_readiness` (~89 tokens) Audit LLM Crawler Readiness Audit domain crawler readiness for AI search engines (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Bytespider). Checks robots.txt, HTTP headers, llms.txt availability, and generates a custom llms.txt markdown map. [effect=read; scope=intel:read] Input parameters: - `check_llms_txt` - `domain` (string, required) ### `run_llm_visibility_scan` (~59 tokens) Run LLM Visibility Scan Run an on-demand Synter LLM visibility scan for one active workspace project. Admin/Owner only. [effect=write; scope=intel:write] Input parameters: - `idempotency_key` - `project_id` (string, required) ### `draft_wikipedia_article` (~98 tokens) Draft Wikipedia Article Generate an encyclopedic, NPOV-compliant Wikitext draft article with Infobox company markup, citation footnotes, and WP:PAID disclosure text for Wikipedia Articles for Creation (AFC) submission. [effect=write; scope=intel:write] Input parameters: - `brand_name` (string, required) - `citations` - `description` - `domain` - `founding_year` - `headquarters` ### `sync_wikidata_entity` (~81 tokens) Sync Wikidata Entity Query or generate a structured Wikidata entity payload (P31, P856, P571, P159) for direct LLM knowledge graph indexing via MediaWiki REST API. [effect=write; scope=intel:write] Input parameters: - `brand_name` (string, required) - `domain` - `founding_year` - `headquarters` ### `generate_jsonld_schema_markup` (~93 tokens) Generate JSON-LD Schema Markup Generate valid schema.org JSON-LD scripts (Organization, SoftwareApplication, Product, FAQPage) with sameAs knowledge-graph links for embedding into website HTML. [effect=write; scope=creative:generate] Input parameters: - `brand_name` (string, required) - `description` - `domain` (string, required) - `faqs` - `pricing_summary` - `same_as_urls` ### `find_llm_citation_listicles` (~81 tokens) Find LLM Citation Listicles Find top media listicles and roundup articles cited by ChatGPT and Perplexity for a target buying prompt, and generate tailored editor outreach briefs. [effect=read; scope=intel:read] Input parameters: - `brand_name` (string, required) - `buying_prompt` (string, required) - `competitors` - `domain` (string, required) ### `audit_review_site_profiles` (~74 tokens) Audit Review Site Profiles Audit brand profile readiness and completeness across G2, Capterra, Trustpilot, and Gartner Digital Markets to optimize software category indexing in LLM search. [effect=read; scope=connections:read] Input parameters: - `brand_name` (string, required) - `domain` (string, required) - `review_platforms` ### `get_credit_balance` (~29 tokens) Get Credit Balance Check your credit balance and pricing (free) [effect=read; scope=billing:read] ### `set_campaign_guardrail` (~125 tokens) Set Campaign Guardrail Arm or replace a campaign-specific automatic pause rule. Google Ads rules pause one exact campaign only after both the minimum age and spend threshold are met with zero conversions on one exact verified truth conversion action. Configuration is standing authorization for the future pause. Free. [effect=write; scope=guardrails:write; externalMutation=true] Input parameters: - `account_id` (string, required) - `campaign_id` (string, required) - `conversion_action_id` (string, required) - `min_age_hours` (integer) - `platform` (string) - `spend_threshold` (number, required) ### `list_campaign_guardrails` (~46 tokens) List Campaign Guardrails List campaign-specific automatic pause guardrails and their latest spend, conversion, decision, and verified-pause state. Free. [effect=read; scope=guardrails:read] ### `disable_campaign_guardrail` (~57 tokens) Disable Campaign Guardrail Disable a campaign-specific automatic pause guardrail. This does not change the campaign's current platform status. Free. [effect=write; scope=guardrails:write; externalMutation=true] Input parameters: - `guardrail_id` (integer, required) ### `get_billing_status` (~52 tokens) Get Billing Status Check Synter subscription access and usage balance. Ad spend is paid separately to the ad platforms. FREE: costs no credits and makes no LLM call. [effect=read; scope=billing:read] ### `forecast_tool_cost` (~92 tokens) Forecast Tool Cost Look up what a Synter tool will charge in credits BEFORE you call it. Unknown tool names return the fail-closed default rather than 0, so a typo never reads as 'free'. FREE: costs no credits and makes no LLM call. Use this instead of guessing a price from a tool's description. [effect=read; scope=billing:read] Input parameters: - `tool_name` (string, required) ### `set_spend_alert` (~83 tokens) Set Spend Alert Set a weekly ad spend alert — notifies via email, Slack, SMS, and/or WhatsApp when total spend exceeds threshold (free) [effect=write; scope=guardrails:write; externalMutation=true] Input parameters: - `email` (string, required) - `notify` - `phone` - `platforms` - `threshold` (number, required) ### `create_autonomous_schedule` (~145 tokens) Create Autonomous Schedule Create an autonomous agent schedule that runs a Synter skill on a cron cadence (e.g. a budget-pacing / campaign-health monitor). Defaults to a read-only cross-platform pacing monitor every 4 hours that alerts via Slack and never moves money. Pass skill_slug + cron_expression to schedule any autonomous-capable skill. [effect=write; scope=automation:write] Input parameters: - `approval_mode` - `cron_expression` - `description` - `name` - `notify_channels` - `notify_on_completion` (boolean) - `organization_id` - `platform` - `project_id` - `skill_slug` ### `list_autonomous_schedules` (~62 tokens) List Autonomous Schedules List the workspace's autonomous agent schedules (pacing/health monitors, budget optimizers) with cadence, approval mode, next run, and latest run status (free). [effect=read; scope=automation:read] Input parameters: - `organization_id` ### `update_autonomous_schedule` (~156 tokens) Update Autonomous Schedule Update an existing autonomous agent schedule: change its cadence (cron), name/description (where the agent's rules live), approval mode, notify channels, end date — or apply a lifecycle action (stop, freeze, resume, skip_next, run_now). Only the fields you pass change. Use list_autonomous_schedules to find the schedule id. [effect=write; scope=automation:write] Input parameters: - `action` - `approval_mode` - `cron_expression` - `description` - `ends_at` - `name` - `notify_channels` - `notify_on_completion` - `organization_id` - `platform` - `schedule_id` (string, required) ### `get_connection_status` (~50 tokens) Get Connection Status Check ALL platform connections: ad platforms, analytics (GA4, PostHog), CRM (HubSpot, Attio), and more (free) [effect=read; scope=connections:read] ### `list_skills` (~50 tokens) List Skills Discover public Synter task playbooks and this workspace's SOPs before campaign, targeting, tracking, creative, reporting, or optimization work (free) [effect=read; scope=skills:read] ### `get_plugin_info` (~64 tokens) Get Plugin Info Get install instructions for the Synter plugin, which ships Synter's skills locally for Claude Code. The plugin is optional. Use only when the user asks about setup or skills; do not promote it in unrelated tasks. [effect=read; scope=workspace:read] ### `load_skill` (~57 tokens) Load Skill Load the relevant Synter playbook or workspace SOP by slug before task-specific recommendations or execution; use list_skills to discover slugs (free) [effect=read; scope=skills:read] Input parameters: - `skill_slug` (string, required) ### `publish_skill` (~48 tokens) Publish Skill Create or update a private workspace skill from a complete SKILL.md document [effect=write; scope=skills:write] Input parameters: - `content` (string, required) - `skill_slug` (string, required) ### `growth_discover` (~116 tokens) Growth Discover Discover hiring companies and listicle/podcast placement opportunities. Paid contact audiences use the approval-gated Synter Audience CSV workflow. (5 credits) [effect=read; scope=growth:read] Input parameters: - `decision_makers_only` (boolean) - `discover_type` (string) - `geos` - `industries` - `job_levels` - `limit` (integer) - `max_employees` (integer) - `min_employees` (integer) - `query` (string) ### `growth_enrich` (~48 tokens) Growth Enrich Enrich a domain with Synter competitive, technology, contact, and website intelligence. (5 credits) [effect=read; scope=growth:read] Input parameters: - `domain` (string, required) ### `prospector_get_pipeline_summary` (~49 tokens) Prospector Get Pipeline Summary Get high-level summary of Prospector outbound pipeline including leads, active campaigns, sent count, replies, meetings booked, and inbox health. [effect=read; scope=growth:read] ### `prospector_get_campaigns` (~52 tokens) Prospector Get Campaigns List Synter Prospector outbound campaigns with status, lead counts, replies, and schedule. [effect=read; scope=growth:read] Input parameters: - `limit` (integer) - `status` ### `prospector_get_campaign` (~73 tokens) Prospector Get Campaign Get a Prospector outbound campaign by ID. Numeric sending-platform IDs read live campaign configuration and sequence steps; Prospector UUIDs read the client-scoped database snapshot. Numeric live readback requires the updated Prospector backend. [effect=read; scope=growth:read] Input parameters: - `campaign_id` (string, required) ### `prospector_get_campaign_performance` (~95 tokens) Prospector Get Campaign Performance Get Synter Prospector outbound campaign performance: sends, opens, replies, meetings booked, and reply rate. Call this when reporting on an outbound sequence or comparing campaigns. Pass campaign_id for one campaign or omit it for the workspace rollup. [effect=read; scope=growth:read] Input parameters: - `campaign_id` - `days` - `end_date` - `start_date` ### `prospector_get_step_performance` (~79 tokens) Prospector Get Step Performance Get per-step performance for a Synter Prospector outbound sequence (sends, replies, and drop-off by email or LinkedIn step). Call this after prospector_get_campaign_performance when a campaign reply rate needs a step-level diagnosis. [effect=read; scope=growth:read] Input parameters: - `campaign_id` (string, required) ### `prospector_get_analytics_summary` (~67 tokens) Prospector Get Analytics Summary Get workspace-level Synter Prospector outbound analytics: campaign count, total replies, meetings booked, and per-campaign send/reply rates. Call this for an outbound reporting rollup across campaigns. [effect=read; scope=growth:read] Input parameters: - `days` ### `prospector_get_reports` (~58 tokens) Prospector Get Reports List saved Synter Prospector outbound reports (campaign, step, and analytics artifacts). Call this to find a report_id before prospector_get_report. [effect=read; scope=growth:read] Input parameters: - `limit` (integer) ### `prospector_get_report` (~63 tokens) Prospector Get Report Get one saved Synter Prospector outbound report by id, including the metrics payload used for campaign reporting. Call prospector_get_reports first when the report_id is unknown. [effect=read; scope=growth:read] Input parameters: - `report_id` (string, required) ### `prospector_get_leads` (~126 tokens) Prospector Get Leads List leads in the Prospector outbound pipeline, or filter by campaign, pipeline status, tag, or free-text search. campaign_id accepts the numeric EmailBison campaign id (resolved against live campaign membership) as well as the internal UUID. status filters the pipeline stage (e.g. new, contacted, replied, meeting_booked). search matches email, name, or company. [effect=read; scope=growth:read] Input parameters: - `campaign_id` - `limit` (integer) - `search` - `status` - `tag` ### `prospector_get_inbox_health` (~66 tokens) Prospector Get Inbox Health Get deliverability and warmup health for Prospector sending inboxes scoped to the authenticated owner. An empty result may indicate a missing owner-to-sending-domain mapping; it does not establish that reconnecting is necessary. [effect=read; scope=growth:read] ### `synter_audience` (~247 tokens) Synter Audience Build Synter Audiences and Signals with human-approved CSV purchases. Start with action='destinations' to select a writable Synter file's campaign_id (not an ad-platform campaign). Use schema/size for B2B filters or discover_traits for Signals. export/export_signals require explicit max_rows (1–100000) and return a purchase_id, maximum price and review_url; they do not purchase yet. The human must approve in Synter. Then export_status accepts ONLY purchase_id and returns the saved CSV artifact. Never resubmit a purchase to poll it. Requires audiences:write. Discovery retains its published action fees; the purchase is 6 credits per delivered record plus 5 credits. No ad activation. [effect=write; scope=audiences:write; externalMutation=true] Input parameters: - `action` (string, required) - `campaign_id` - `column` - `columns` - `cursor` - `domains` - `entity` - `expression` - `filter` - `limit` - `max_rows` - `purchase_id` - `query` - `thread_id` ### `synter_audience_schema` (~115 tokens) Synter Audience Schema Discover Synter audience filter columns and their allowed values before building an audience filter. Free — metadata only, no records delivered. Pass entity='contact' or 'company'; pass a column name to list that column's vocabulary. Always call this before synter_audience_query: column names are not guessable and an invalid column is rejected rather than ignored. [effect=read; scope=signals:read] Input parameters: - `column` - `entity` (string) - `limit` - `search` ### `synter_audience_capacity` (~58 tokens) Synter Audience Capacity Check whether Synter audience discovery currently has delivery capacity. Free. This is service availability, not the caller's Synter credit balance; use get_credit_balance for customer purchasing capacity. [effect=read; scope=signals:read] ### `synter_audience_query` (~145 tokens) Synter Audience Query Size a Synter Audience from a filter tree. operation='count' returns totals only (cheap — iterate your filter here); 'insights' returns aggregates. Paid rows are delivered only through an approval-gated CSV export. Build the filter with synter_audience_schema first. Semantic scores are FIT, not buying intent, and freshness measures record age, not current buying activity. [effect=read; scope=signals:read] Input parameters: - `columns` - `entity` (string) - `filter` (object, required) - `include_scores` - `limit` - `mode` - `operation` (string) - `section` ### `synter_audience_export` (~168 tokens) Synter Audience Export Start a bounded Synter Audience export after refining with synter_audience_query. Requires explicit max_rows (1-100000) and a stable purchase_id issued by the approval gate for safe retries — there is no unbounded export. Returns a job id, NOT records: poll synter_audience_export_status for completion. Delivered records bill per record when the job completes; a failed or cancelled export delivers nothing and bills only the flat fee. [effect=write; scope=audiences:write; externalMutation=true] Input parameters: - `columns` - `compression` - `entity` (string) - `filename` - `filter` (object, required) - `format` (string) - `max_rows` (integer, required) - `purchase_id` (string, required) ### `synter_audience_export_status` (~91 tokens) Synter Audience Export Status Poll a Synter Audience export. Free to poll. On COMPLETED, Campaign IDE saves the purchased CSV into the project table without exposing private delivery credentials. The per-record fee is levied here once; repeated polls do not bill again. [effect=write; scope=audiences:write; externalMutation=true] Input parameters: - `entity` (string) - `export_id` (string, required) ### `synter_audience_cancel_export` (~67 tokens) Synter Audience Cancel Export Cancel a running Synter Audience export. Free. A cancelled export delivers no records and therefore incurs no per-record fee. [effect=write; scope=audiences:write; externalMutation=true] Input parameters: - `entity` (string) - `export_id` (string, required) ### `synter_signal_trait_search` (~108 tokens) Synter Signal Trait Search Search Synter Signals for TRAITS — the attributes you can build an audience from (behaviours, affinities, firmographics). Returns trait descriptors with sizes, not people. Start here, refine the traits, then use synter_signal_audience_export for approval-gated CSV delivery. US only, adults only. [effect=read; scope=signals:read] Input parameters: - `entity_type` (string) - `limit` (integer) - `query` (string, required) ### `synter_signal_audience_export` (~129 tokens) Synter Signal Audience Export Purchase a bounded Synter Signals audience as CSV after refining traits. Requires an explicit max_rows (1-100000) and stable purchase_id for safe retries. The complete file is delivered only after settlement at the posted audience-record rate ($150 CPM / 6 credits per delivered record), plus the 5-credit call fee. [effect=write; scope=audiences:write; externalMutation=true] Input parameters: - `domains` - `entity_type` (string) - `expression` (string, required) - `max_rows` (integer, required) - `purchase_id` (string, required) ### `synter_signal_entity_resolve` (~75 tokens) Synter Signal Entity Resolve Resolve identifiers you already hold (emails, phones, device ids) to Synter Signals entity IDs. Identity resolution, not discovery. Bills per resolved entity. US only, adults only. [effect=read; scope=signals:read] Input parameters: - `entity_type` (string) - `identifiers` (array, required) ### `synter_signal_entity_relations` (~87 tokens) Synter Signal Entity Relations Traverse Synter Signals relationships from an entity — e.g. person to employer. Use it to span person and business criteria in one audience (executives AT companies matching a firmographic filter). Bills per related entity returned. [effect=read; scope=signals:read] Input parameters: - `entity_id` (string, required) - `limit` (integer) - `relation` ### `enrich_contacts` (~173 tokens) Enrich Contacts Enrich contacts you already hold — including PERSONAL email addresses — by resolving them through Synter Signals to a person, then returning work email, LinkedIn URL, phone, title and employer. Built for the signup-list problem: a gmail.com address is invisible to work-email-only B2B data, but is resolvable as a person. CRM-AGNOSTIC: pass identifiers and get rows back keyed 1:1 to what you passed, so any CRM (attio, hubspot, salesforce, pipedrive) can map them back to its own records. Bills per enriched profile delivered; unresolved identifiers are free. US only, adults only. [effect=read; scope=signals:read] Input parameters: - `crm` - `identifiers` (array, required) - `include_company` (boolean) ### `get_vendor_consumption` (~75 tokens) Get Vendor Consumption Report how much paid Synter audience and research data this workspace consumed — record counts, credits billed and USD — over a window. Free and scoped to the caller's own workspace. Supplier routing remains a private Synter implementation detail. [effect=read; scope=billing:read] Input parameters: - `since_days` (integer) ### `prospector_create_campaign` (~172 tokens) Prospector Create Campaign Create a draft Synter Prospector outbound campaign with a sending schedule in the authenticated workspace. List campaigns first to avoid duplicates. Defaults to plain_text=true and open_tracking=false (tracking pixels and HTML wrappers depress deliverability on cold outbound); pass plain_text=false only when the sequence genuinely needs HTML. Change either later with prospector_update_campaign_settings. This does not launch or send. Add copy separately with prospector_update_campaign_sequence. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `end_time` (string) - `name` (string, required) - `open_tracking` (boolean) - `plain_text` (boolean) - `send_weekends` (boolean) - `start_time` (string) - `timezone` (string) ### `prospector_update_campaign_sequence` (~209 tokens) Prospector Update Campaign Sequence Write email sequence steps on a Synter Prospector campaign in the authenticated workspace. mode=append (default) adds sequence_steps after the existing steps. mode=edit rewrites existing steps in place, addressed by step_id (read step ids with prospector_get_campaign); ids, order, inboxes, and schedule are kept and it is safe on a live campaign. mode=delete removes the steps in delete_step_ids; steps that have already sent cannot be deleted. mode=replace swaps the whole sequence and is refused on an active campaign. Every non-append write is verified against a live readback. Use
line breaks and {FIRST_NAME}, {COMPANY}, {TITLE} tokens. This does not launch or send. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `campaign_id` (string, required) - `delete_step_ids` - `mode` (string) - `sequence_steps` ### `prospector_update_campaign_settings` (~196 tokens) Prospector Update Campaign Settings Update sending settings on an existing Synter Prospector campaign in the authenticated workspace: plain_text (send as plain text rather than HTML), open_tracking (tracking pixel), can_unsubscribe, max_emails_per_day, max_new_leads_per_day, sequence_prioritization. Only the arguments you pass are changed. This never launches, pauses, or otherwise changes campaign status — use prospector_update_campaign_status for that. Campaigns created before this tool existed default to plain_text=false; set plain_text=true to stop sending HTML-wrapped cold email. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `campaign_id` (string, required) - `can_unsubscribe` - `max_emails_per_day` - `max_new_leads_per_day` - `open_tracking` - `plain_text` - `sequence_prioritization` ### `prospector_update_lead_custom_variables` (~156 tokens) Prospector Update Lead Custom Variables Refresh EmailBison custom variables on leads ALREADY attached to a Synter Prospector campaign, without re-pushing them. Pass campaign_id plus leads=[{email, custom_variables}], where custom_variables is a list of {name, value} (names are uppercased by the backend, e.g. CUSTOM_SHOWS) or a plain {NAME: value} object. Idempotent: re-running overwrites the same variables. Use this when sequence merge tokens render blank or stale for leads that are already in the campaign. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `campaign_id` (string, required) - `leads` (array, required) ### `prospector_assign_inboxes_to_campaign` (~101 tokens) Prospector Assign Inboxes To Campaign Attach explicitly selected sending inbox IDs to a Synter Prospector campaign. Requires a non-empty sender_email_ids array; never defaults to every inbox. Each ID must satisfy API-key inbox restrictions and the upstream authenticated sending workspace. Does not launch the campaign. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `campaign_id` (string, required) - `sender_email_ids` (array, required) ### `prospector_add_leads` (~324 tokens) Prospector Add Leads Attach Priority/hand-picked leads to an existing Synter Prospector (EmailBison) campaign by numeric campaign_id. Accepts structured lead objects and/or CSV-shaped rows (email,first_name,last_name,company,title,linkedin_url,custom_shows) and an optional per-lead custom_variables list/object forwarded to EmailBison merge tokens (custom_shows becomes CUSTOM_SHOWS). IDEMPOTENT AND RESUMABLE: safe to re-run with the same leads — saves dedupe by email, the push reconciles against live campaign membership, and a re-run refreshes stale custom variables on already-attached leads instead of duplicating them. Work is time-budgeted: on a large cohort this returns complete=false with remaining_emails, and you should call it again with only those leads. Saves into the Prospector leads table then IcyPeas-verifies and gate-pushes via verify_and_push_leads. Defaults grade=A and outreach_tier=TIER_1 for Priority A cohorts; override per lead or via grade/outreach_tier args. Tenant-scoped like other prospector_* tools — unmapped orgs are refused. Does not launch the campaign. No live prod push without Growth GO. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `campaign_id` (string, required) - `campaign_name` - `grade` (string) - `leads` - `leads_csv` - `outreach_tier` (string) - `tags` ### `prospector_verify_and_push_leads` (~149 tokens) Prospector Verify And Push Leads Lower-level lead attach: IcyPeas-verify already-saved Prospector leads and gate-push them into an existing EmailBison campaign by numeric campaign_id. Each lead needs email + grade (A/B/C/D) + outreach_tier (TIER_1/TIER_2/TIER_3/EXCLUDE). Prefer prospector_add_leads for CSV-shaped Growth cohorts that still need save_leads_to_database. Idempotent on email within the campaign. Tenant-scoped. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `campaign_id` (string, required) - `leads` (array, required) ### `prospector_update_campaign_status` (~153 tokens) Prospector Update Campaign Status Pause, activate/resume, or archive a Prospector outbound campaign. Pass status=paused to stop sending, status=active (aliases: running, resume, launch, start, enabled) to call EmailBison launch_campaign, or status=archived to archive it (refused while active: pause first; history is kept). NOTE: on customer-workspace MCP connections this tool is not yet tenant-scoped and is refused rather than served from Synter's house tenant; use it from the Synter-internal surface. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `campaign_id` (string, required) - `status` (string) ### `prospector_suppress_leads` (~173 tokens) Prospector Suppress Leads Globally suppress email addresses in Synter Prospector: adds them to the suppression list every push gate reads, blocklists them in EmailBison and stops future emails in every campaign holding them. A reason containing 'bounce' also records a hard bounce. all_workspaces=true fans the EmailBison blocklist/stop out to every workspace. Global scope and all_workspaces are limited to the Synter house workspace; tenants use prospector_remove_leads. Pass dry_run=true to preview. Never sends email. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `all_workspaces` (boolean) - `campaign_id` - `dry_run` (boolean) - `emails` (array, required) - `reason` (string, required) ### `prospector_remove_leads` (~137 tokens) Prospector Remove Leads Detach leads from ONE Synter Prospector (EmailBison) campaign by numeric campaign_id. mode=stop (default) stops future emails and keeps history; mode=remove deletes them from the campaign (irreversible, resets that lead's campaign history). Does not suppress globally. Pass dry_run=true to preview. Never sends email. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `campaign_id` (string, required) - `dry_run` (boolean) - `emails` (array, required) - `mode` (string) - `reason` (string, required) ### `prospector_get_bounced_leads` (~129 tokens) Prospector Get Bounced Leads List bounced Prospector leads with a hard/soft/unknown split, the SMTP reason and code, the campaign, the sending inbox, and whether each address is already suppressed. Reads recorded bounces plus EmailBison's live bounced folder. Filter by campaign_id (numeric EmailBison id), since (ISO date), or bounce_type (hard/soft/unknown). [effect=read; scope=growth:read] Input parameters: - `bounce_type` - `campaign_id` - `limit` (integer) - `live` (boolean) - `since` ### `prospector_verify_leads` (~140 tokens) Prospector Verify Leads Verify-only email check for Prospector leads: IcyPeas-verifies each address and returns valid / invalid / risky / unknown with the raw status, plus whether it is suppressed. No campaign, no push, no company-name gate, no domain cooldown. persist=true (default) records the verdict on your saved leads so the push gate can use it. Time-budgeted: re-call with `remaining` until complete=true. Up to 200 emails per call. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `emails` (array, required) - `persist` (boolean) ### `prospector_dedupe_leads` (~108 tokens) Prospector Dedupe Leads Collapse duplicate Prospector lead rows (same email) into one record: keeps the campaign-linked / most complete row, fills its gaps from the duplicates, moves related records onto it, and deletes the duplicates. dry_run defaults to TRUE; pass dry_run=false to apply. Pass emails to target specific addresses. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `dry_run` (boolean) - `emails` ### `prospector_reconcile_campaign_leads` (~145 tokens) Prospector Reconcile Campaign Leads Reconcile a Prospector campaign's saved lead links with live EmailBison membership (numeric campaign_id): reports leads linked in Synter but not in EmailBison, EmailBison members not linked, and members with no saved lead, and returns the live member emails. dry_run defaults to TRUE; dry_run=false fixes the links in Synter only (never changes EmailBison). To detach invalid members use prospector_verify_leads then prospector_remove_leads. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `campaign_id` (string, required) - `dry_run` (boolean) ### `prospector_create_reply` (~98 tokens) Prospector Create Reply Approve and deliver an AI-drafted reply to an interested prospect lead. NOTE: on customer-workspace MCP connections this tool is not yet tenant-scoped and is refused rather than served from Synter's house tenant; use it from the Synter-internal surface. [effect=write; scope=growth:write; requires=prospectorAccess; externalMutation=true] Input parameters: - `message` - `reply_id` (string, required) ### `tech_intel_get_account_usage` (~37 tokens) Tech Intel Get Account Usage Synter technology-intelligence availability and usage snapshot. (2 credits) [effect=read; scope=intel:read] ### `tech_intel_get_domain_technologies` (~83 tokens) Tech Intel Get Domain Technologies Synter domain tech-stack lookup — ad pixels, CRM, analytics, CMS/ecommerce tools, spend/meta. (2 credits) [effect=read; scope=intel:read] Input parameters: - `domain` (string, required) - `include_raw` (boolean) - `include_trust` (boolean) - `live_only` (boolean) ### `tech_intel_get_technology_changes` (~55 tokens) Tech Intel Get Technology Changes Recent technology additions/removals for domains, with business context. (2 credits) [effect=read; scope=intel:read] Input parameters: - `domains` (array, required) - `since` (string) ### `tech_intel_get_trust_signals` (~53 tokens) Tech Intel Get Trust Signals Synter domain trust, ecommerce/payment, parked/status, spend and live-tech signals. (2 credits) [effect=read; scope=intel:read] Input parameters: - `domain` (string, required) ### `tech_intel_get_sites` (~109 tokens) Tech Intel Get Sites Find websites by technology, natural-language audience, or keyword search. (2 credits) [effect=read; scope=intel:read] Input parameters: - `commit` (boolean) - `countries` - `employees` - `include_meta` (boolean) - `keyword` - `limit` (integer) - `offset` - `other_techs` - `query` - `revenue` - `spend` - `tech` ### `tech_intel_product_search` (~58 tokens) Tech Intel Product Search Find ecommerce shops and product listings matching a product query. (2 credits) [effect=read; scope=intel:read] Input parameters: - `limit` (integer) - `page` (integer) - `query` (string, required) ### `tech_intel_company_to_url` (~42 tokens) Tech Intel Company To URL Resolve company names to candidate website domains. (2 credits) [effect=read; scope=intel:read] Input parameters: - `company` (string, required) ### `tech_intel_get_domain_keywords` (~42 tokens) Tech Intel Get Domain Keywords Find keywords associated with a website domain. (2 credits) [effect=read; scope=intel:read] Input parameters: - `domain` (string, required) ### `forecast_campaign` (~75 tokens) Forecast Campaign Forecast campaign KPIs (spend, CPA, ROAS, clicks, conversions) for 7-30 days with confidence intervals (2 credits) [effect=read; scope=campaigns:read] Input parameters: - `campaign_id` - `horizon` (integer) - `metric` (string) - `platform` ### `optimize_budget` (~94 tokens) Optimize Budget Recommend a cross-channel budget allocation using diminishing-returns modeling (5 credits). RECOMMEND-ONLY: dry_run defaults to true and nothing is changed on any ad platform; apply approved changes with update_campaign_budget. [effect=write; scope=budget:write; externalMutation=true] Input parameters: - `constraints` - `dry_run` (boolean) - `target` (string) - `total_budget` (number, required) ### `test_creatives` (~68 tokens) Test Creatives Start or check a multi-armed bandit creative experiment using Thompson sampling (40 credits) [effect=write; scope=creative:generate] Input parameters: - `action` (string) - `campaign_id` (string, required) - `platform` (string, required) - `reward_metric` (string) ### `create_social_clip` (~113 tokens) Create Social Clip Render, watermark, auto-caption, and format video/screen recordings into social clips for X, LinkedIn, TikTok, or Reels. Use forecast_tool_cost for current pricing. [effect=write; scope=creative:generate] Input parameters: - `aspect_ratio` (string) - `auto_caption` (boolean) - `headline` - `idempotency_key` - `name` - `source_url` (string, required) - `trim_end` - `trim_start` (number) ### `create_ad_copy` (~99 tokens) Create Ad Copy Generate text ad copy (headlines, descriptions, CTAs) for any platform using Claude (20 credits) [effect=write; scope=creative:generate] Input parameters: - `competitor_brand` - `cta` - `descriptions_count` - `headlines_count` - `keywords` - `landing_page_url` - `platform` (string, required) - `product` (string, required) - `tone` (string) ### `list_creative_assets` (~66 tokens) List Creative Assets List generated creative assets (images and videos) from your artifact library, with approval status and platform-deployment mapping (free) [effect=read; scope=creative:read] Input parameters: - `asset_type` - `limit` (integer) - `offset` (integer) ### `upload_creative` (~119 tokens) Upload Creative Upload a generated creative asset to an ad platform and attach it to a campaign (5 credits) [effect=publish; scope=creative:publish; requires=campaignPublishing; externalMutation=true] Input parameters: - `account_id` - `ad_group_id` - `asset_type` (string) - `asset_url` (string, required) - `campaign_id` (string, required) - `description` - `form_id` - `headline` - `landing_url` - `name` - `platform` (string, required) ### `attach_audience` (~126 tokens) Attach Audience Attach (add), remove, or replace a matched audience on an existing campaign/ad-group/ad-set/line-item's targeting (5 credits). Supports linkedin, google, meta, tiktok, reddit, microsoft, stackadapt, x. [effect=write; scope=audiences:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `ad_group_id` - `audience_id` - `campaign_id` (string, required) - `facet` (string) - `mode` (string) - `platform` (string) - `segment_urn` ### `get_attribution` (~46 tokens) Get Attribution Multi-touch attribution analysis using Markov chains (5 credits) [effect=read; scope=measurement:read] Input parameters: - `conversion_type` - `date_range` (string) ### `measure_incrementality` (~57 tokens) Measure Incrementality Measure incremental ad impact via geo-lift or synthetic control [effect=read; scope=measurement:read] Input parameters: - `control_regions` - `method` (string) - `platform` (string, required) - `test_regions` ### `build_lookalike_audience` (~63 tokens) Build Lookalike Audience Build ML-based lookalike audience from seed customers [effect=write; scope=audiences:write; externalMutation=true] Input parameters: - `expansion_factor` (integer) - `platform` (string, required) - `seed_audience` (string, required) ### `research_campaign_opportunity` (~110 tokens) Research Campaign Opportunity Research real demand before planning a campaign: keyword volumes and CPCs, what competitors are actually running, and current trends. Run this BEFORE create_campaign_plan. [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `account_name` - `competitor_domains` - `geo_target` (string) - `include_trends` (boolean) - `landing_page_url` - `platforms` (string) - `seed_keywords` (string, required) ### `create_campaign_plan` (~67 tokens) Create Campaign Plan Create or update a campaign launch plan. Use plan_key for idempotency. [effect=write; scope=campaigns:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `brief_json` - `plan_key` (string, required) - `title` (string, required) ### `upsert_plan_entity` (~121 tokens) Upsert Plan Entity Add or update an entity (campaign, ad, tweet, go_link, etc.) within a campaign plan. [effect=write; scope=campaigns:plan; externalMutation=true] Input parameters: - `desired_state` (string) - `entity_type` (string, required) - `logical_key` (string, required) - `metadata_json` - `parent_logical_key` - `plan_id` (string, required) - `platform` (string, required) - `provider_account_id` - `remote_id` - `remote_ref_json` ### `publish_plan_document` (~103 tokens) Publish Plan Document Publish a campaign plan for review, generating a shareable URL. Moves the plan from building/draft to in_review; a reviewer approves it at share_url, then execute_campaign_plan launches it. Runs plan QA (incl. the live tracking preflight) and pins the scorecard to the document. [effect=publish; scope=workspace:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `expected_version` - `plan_id` (string, required) ### `approve_campaign_plan` (~71 tokens) Approve Campaign Plan Record the workspace owner's approval of a published campaign plan, moving it from in_review to approved so it can be launched. [effect=write; scope=campaigns:plan; requires=campaignPublishing] Input parameters: - `comment` - `expected_version` (integer, required) - `plan_id` (string, required) ### `execute_campaign_plan` (~71 tokens) Execute Campaign Plan Launch an approved campaign plan — activates all entities across platforms in dependency order. [effect=publish; scope=campaigns:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `execute_token` (string, required) - `plan_id` (string, required) - `qa_override_approved` (boolean) ### `get_plan_execution` (~46 tokens) Get Plan Execution Get execution status and per-entity step results for a campaign plan launch (free). [effect=read; scope=campaigns:read] Input parameters: - `plan_id` (string, required) ### `run_launch_preflight` (~74 tokens) Run Launch Preflight Run pre-launch conversion-tracking and landing-page checks at PLAN time, before presenting a campaign plan for approval. Read-only and free. Returns tracking issues and confirmation tokens. [effect=read; scope=campaigns:read] Input parameters: - `action_name` - `landing_page_url` - `platform` ### `setup_google_ads_trial_funnel` (~121 tokens) Setup Google Ads Trial Funnel Set up a complete Google Ads trial acquisition funnel: branded Search campaign (maximize clicks, builds conversion history), PMax campaign (maximize conversions), and Display retargeting campaign — all pointing to a Synter-hosted landing page. Requires an active Google Ads connection. [effect=write; scope=campaigns:write; externalMutation=true] Input parameters: - `business_name` (string, required) - `landing_page_url` (string, required) - `month_label` - `total_daily_budget` (number) - `trial_days` (integer) ### `create_document` (~67 tokens) Create Document Create a document in the Campaign IDE editor (free). Perfect for reports, audits, strategy docs, and plans that can be collaboratively edited. [effect=write; scope=workspace:write] Input parameters: - `content` (string, required) - `organization_id` - `title` (string, required) ### `create_campaign_import` (~135 tokens) Create Campaign Import Import an existing live ad campaign (Meta, Google, LinkedIn, TikTok, Reddit, X, Microsoft, etc.) into Synter UI as a workspace document (/campaigns/ide/). Pulls live campaign details, performance, and structure, creates a document in Synter UI, and returns the clickable URL so it appears in the user's workspace. [effect=write; scope=campaigns:write; requires=campaignPublishing; externalMutation=true] Input parameters: - `campaign_id` - `campaign_name` - `days` (integer) - `organization_id` - `platform` (string, required) ### `get_campaign_plan` (~50 tokens) Get Campaign Plan Fetch a campaign plan with its entities, budgets, desired states, and review/execution status (free). [effect=read; scope=campaigns:read] Input parameters: - `plan_id` (string, required) ### `get_launch_gate_policy` (~52 tokens) Get Launch Gate Policy Read what this workspace's Plan QA launch gate is set to — whether a failing QA review blocks a campaign launch, and where the user changes that. [effect=read; scope=campaigns:read] ### `delete_document` (~57 tokens) Delete Document Delete a Campaign IDE document by id or uuid (e.g. to remove a stale or duplicate doc). Only deletes documents you own. [effect=write; scope=workspace:write] Input parameters: - `document_id` - `uuid` ### `send_slack_message` (~73 tokens) Send Slack Message Post a message to a Slack channel via the Synter bot. channel = a channel ID (Cxxxx) or #name. The bot can only post to channels it's a member of. [effect=write; scope=workspace:notify] Input parameters: - `channel` (string, required) - `text` (string, required) ### `find_audience_signals` (~85 tokens) Find Audience Signals Find audience intent signals and semantic clusters from a natural-language description (e.g. 'RevOps leaders at B2B SaaS companies using Salesforce'). Returns matching intent clusters to use as targeting signals. [effect=read; scope=signals:read] Input parameters: - `entity_type` (string) - `max_results` (integer) - `query` (string, required) ### `get_pixel_destinations` (~62 tokens) Get Pixel Destinations List Synter Pixel sites and their CAPI event-forwarding destinations for the active workspace. Shows platform, enabled/disabled state, and configured IDs. Free — no credits. [effect=read; scope=tracking:read] Input parameters: - `site_key` ### `get_pixel_health` (~84 tokens) Get Pixel Health Pixel snippet + destination health for the active workspace: snippet installed, destinations configured, last successful CAPI delivery per adapter. Do not pause or scale from get_performance alone; read get_pixel_health, list_event_deliveries, and get_click_attribution first. Free — no credits. [effect=read; scope=tracking:read] Input parameters: - `site_key` ### `list_event_deliveries` (~86 tokens) List Event Deliveries Read event_deliveries fan-out rows (success/fail/destination) for the workspace pixel. Do not pause or scale from get_performance alone; confirm deliveries before acting. Free — no credits. [effect=read; scope=tracking:read] Input parameters: - `limit` (integer) - `platform` - `site_key` - `status` ### `get_click_attribution` (~100 tokens) Get Click Attribution Return stored click IDs and UTMs from pixel ingest plus Stripe first-touch (user_attribution, PR 9673). This is stored identifiers only — no first/last/linear model math. Do not pause or scale from get_performance alone. Free — no credits. [effect=read; scope=tracking:read] Input parameters: - `email` - `limit` (integer) - `site_key` - `user_id` ### `configure_pixel_destination` (~159 tokens) Configure Pixel Destination Create or update a Synter Pixel CAPI event-forwarding destination. Sets the platform-specific IDs needed to fan out conversion events server-side. Supports Google (customer_id + conversion_action_id), Meta/Reddit (pixel_id), LinkedIn (conversion_rule_id), TikTok (pixel_code), and Snapchat. Use action='disable' or action='enable' to toggle without changing settings. Free — no credits. [effect=write; scope=tracking:write; externalMutation=true] Input parameters: - `action` (string) - `conversion_action_id` - `conversion_rule_id` - `customer_id` - `pixel_code` - `pixel_id` - `platform` (string, required) - `site_key` ### `audit_account_structure` (~140 tokens) Audit Account Structure Audit an ad account's campaign structure (READ-ONLY, free). Flags the churn signatures that make an account a mess: duplicate campaign / ad group / ad names (case-insensitive, trimmed), ad groups with empty or invalid targeting, and 'rebuilt-not-edited' campaigns (a name with both a live and an archived copy). Reddit is fully supported (campaign / ad group / ad depth); Google is campaign-level. Writes nothing — use repair_account_structure to act on the findings. [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `account_name` - `platform` (string) ### `repair_account_structure` (~150 tokens) Repair Account Structure Repair an ad account's campaign structure. DRY-RUN BY DEFAULT — reports what it WOULD archive and changes nothing. Pass apply=true (only after customer approval) to ARCHIVE duplicate clutter (keeps the earliest of each same-name set) via PATCH configured_status=ARCHIVED — Reddit v3 has NO hard DELETE. Ad groups with empty targeting are FLAGGED, never auto-archived. Reddit apply is fully supported; Google apply is dry-run planning only. Free — no credits. [effect=write; scope=campaigns:structure; externalMutation=true] Input parameters: - `account_id` - `account_name` - `apply` (boolean) - `platform` (string) ### `get_account_changelog` (~121 tokens) Get Account Changelog Extract Google Ads changelog / mutation history (default request 90 days, capped to the Google Ads change_event API's 30-day maximum). Other catalog platforms return changelog_supported=false until a reader is implemented. Evaluates historical changes against Synter's autonomous agent tool and OAuth scope parity, calculates estimated monthly hours saved, and generates autonomous agent recommendations. [effect=read; scope=campaigns:read] Input parameters: - `account_id` - `account_name` - `lookback_days` (integer) - `platform` (string) ### `shopify_get_abandoned_checkouts` (~109 tokens) Shopify Get Abandoned Checkouts Get Shopify abandoned checkouts for cart-abandonment and recovery-rate reporting. Call this when diagnosing checkout drop-off or sizing a retargeting audience. Paginate with page_info. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `created_at_max` - `created_at_min` - `days` - `include_recovered` - `limit` - `page_info` ### `shopify_get_collections` (~78 tokens) Shopify Get Collections Get Shopify collections (smart and custom). Call this when segmenting a catalog for shopping or Performance Max campaigns. Paginate with page_info. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `limit` - `page_info` - `type` ### `shopify_get_customer_audience` (~124 tokens) Shopify Get Customer Audience Export a hashed Shopify customer audience for upload to Meta, Google, TikTok or LinkedIn. Call this to build a customer-match or lookalike seed from store purchase history. The underlying script always SHA-256 hashes customer identifiers before returning them. [effect=read; scope=audiences:read] Input parameters: - `account_id` - `account_name` - `days` - `include_address` - `marketing_consent_only` - `max_customers` - `min_spend` - `segment` ### `shopify_get_customers` (~159 tokens) Shopify Get Customers Aggregate a Shopify customer cohort into privacy-thresholded metrics. Days default to 30, round up to fixed 30, 90, or 365-day rolling UTC windows, and clamp above 365. Exact timestamp and pagination filters are deprecated, ignored, and echoed in deprecated_parameters_ignored. No customer-level records or pagination cursors are returned; cohorts smaller than 10 are suppressed. Use shopify_get_customer_audience when you need the hashed audience file itself. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `created_at_min` - `days` - `limit` - `page_info` - `updated_at_min` ### `shopify_get_discount_codes` (~100 tokens) Shopify Get Discount Codes Get Shopify discount codes and their price rules. Requires an assisted/custom Shopify connection with read_discounts; this is unavailable to public App Store installs. Call this to check which promotions are live before referencing an offer in ad copy or a landing page. Paginate with page_info. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `limit` - `page_info` ### `shopify_get_inventory_levels` (~89 tokens) Shopify Get Inventory Levels Get Shopify inventory levels per inventory item and location. Call this to confirm stock before scaling spend on a product, or to find which locations can fulfil demand. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `inventory_item_ids` - `limit` - `location_ids` - `max_pages` ### `shopify_get_inventory_status` (~91 tokens) Shopify Get Inventory Status Get a Shopify stock-health summary flagging low and out-of-stock products. Call this before increasing budget on a shopping campaign so you do not drive traffic to unavailable products. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `limit` - `low_stock_threshold` - `max_pages` - `status` ### `shopify_get_orders` (~125 tokens) Shopify Get Orders Get Shopify orders with financial and fulfillment status. Call this when the user asks about their Shopify store's orders, revenue by order, refunds, or unfulfilled orders. Paginate with page_info until next_page_info is absent. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `created_at_max` - `created_at_min` - `days` - `financial_status` - `fulfillment_status` - `limit` - `page_info` - `status` ### `shopify_get_product_feed` (~139 tokens) Shopify Get Product Feed Build a Shopify product feed (Google Merchant Center RSS 2.0 XML or CSV) and return it as data. Call this to inspect or refresh the catalog behind Google Shopping and Performance Max campaigns. It never hosts the feed at a public URL; use execute if you need it hosted. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `base_url` - `currency` - `exclude_out_of_stock` - `feed_title` - `format` - `include_variants` - `limit` - `status` ### `shopify_get_product_sales` (~100 tokens) Shopify Get Product Sales Get Shopify revenue broken down by product, vendor or product type. Call this to find the best sellers worth advertising and the long tail that is not converting. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `days` - `end_date` - `group_by` - `max_pages` - `start_date` - `top_n` ### `shopify_get_products` (~106 tokens) Shopify Get Products Get Shopify products, filterable by status, vendor, product type or collection. Call this before building a product feed or shopping campaign so ad copy matches the real catalog. Paginate with page_info. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `collection_id` - `limit` - `page_info` - `product_type` - `status` - `vendor` ### `shopify_get_sales_summary` (~93 tokens) Shopify Get Sales Summary Get aggregate Shopify revenue, order count and average order value over a date range. Call this to establish store-level baseline revenue before attributing ad spend, or for blended ROAS. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `days` - `end_date` - `max_pages` - `start_date` ### `shopify_get_shop` (~74 tokens) Shopify Get Shop Get Shopify shop identity and configuration: domain, currency, timezone, plan. Call this first when connecting a store, to confirm which shop the credentials point at before any other call. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `fields` ### `shopify_get_webhooks` (~80 tokens) Shopify Get Webhooks Get the Shopify webhooks currently registered on the store. Call this to verify conversion and order tracking is wired up before trusting Shopify-sourced conversion data. [effect=read; scope=commerce:read] Input parameters: - `account_id` - `account_name` - `address_contains` - `limit` - `topic` ### `shopify_create_discount` (~162 tokens) Shopify Create Discount Create a Shopify discount code and its price rule. Requires an assisted/custom Shopify connection with write_discounts; this is unavailable to public App Store installs. Call this when launching a promotion that ad creative or a landing page will reference. The value must be negative, for example -10 for 10 percent off. [effect=write; scope=commerce:write; externalMutation=true] Input parameters: - `account_id` - `account_name` - `code` (string, required) - `ends_at` - `min_subtotal` - `no_once_per_customer` - `starts_at` - `target_type` - `title` (string, required) - `type` - `usage_limit` - `value` ### `shopify_create_web_pixel` (~92 tokens) Shopify Create Web Pixel Activate the Synter Web Pixel extension on a Shopify store for checkout_completed conversion tracking. This is the supported path; Shopify stopped rendering ScriptTag pixels on the order-status page. Call this when setting up purchase tracking for a store. [effect=write; scope=tracking:write; externalMutation=true] Input parameters: - `account_id` - `account_name` - `site_key` (string, required) ### `shopify_create_webhook` (~90 tokens) Shopify Create Webhook Register a Shopify webhook so the store pushes events such as orders/paid to Synter. Call this when setting up order or refund tracking for a newly connected store. [effect=write; scope=commerce:write; externalMutation=true] Input parameters: - `account_id` - `account_name` - `address` (string, required) - `format` - `topic` (string, required) ### `klaviyo_get_campaign_metrics` (~98 tokens) Klaviyo Get Campaign Metrics Get Klaviyo campaign performance: opens, clicks, revenue, and unsubscribes. Call this when attributing revenue to email or SMS, or when comparing owned-channel results against paid campaigns for blended reporting. [effect=read; scope=email:read] Input parameters: - `account_id` - `account_name` - `campaign_id` - `channel` - `limit` - `list_recent` ### `klaviyo_get_campaigns` (~91 tokens) Klaviyo Get Campaigns Get Klaviyo email and SMS campaigns with their status (draft, scheduled, sent, cancelled). Call this to see what lifecycle marketing is already running before proposing a new send, or to find a campaign id for a metrics lookup. [effect=read; scope=email:read] Input parameters: - `account_id` - `account_name` - `channel` - `status` ### `klaviyo_get_flows` (~81 tokens) Klaviyo Get Flows Get Klaviyo automated flows and their live status. Call this to check which triggered sequences (welcome, abandoned cart, win-back) already exist before building a new one, so a flow is not duplicated. [effect=read; scope=email:read] Input parameters: - `account_id` - `account_name` - `status` ### `klaviyo_get_lists` (~76 tokens) Klaviyo Get Lists Get Klaviyo lists, and optionally segments too. Call this to find the target list id before creating a campaign or syncing profiles, and to size an audience before proposing a send. [effect=read; scope=email:read] Input parameters: - `account_id` - `account_name` - `include_segments` ### `klaviyo_get_templates` (~68 tokens) Klaviyo Get Templates Get Klaviyo email templates, filterable by name. Call this to reuse an existing branded template instead of generating raw HTML for a new campaign. [effect=read; scope=email:read] Input parameters: - `account_id` - `account_name` - `filter` ### `klaviyo_create_campaign` (~197 tokens) Klaviyo Create Campaign Create a Klaviyo email or SMS campaign as a DRAFT, optionally scheduled. This does not send: sending is a separate approval-gated step, so a draft created here is safe to review first. Call this when building a lifecycle send from a template or supplied HTML. [effect=write; scope=email:write; externalMutation=true] Input parameters: - `account_id` - `account_name` - `add_utm` - `channel` - `exclude_list_id` - `from_email` - `from_name` - `html_body` - `list_id` (string, required) - `local_timezone` - `name` (string, required) - `no_smart_sending` - `preview_text` - `reply_to` - `schedule_at` - `sms_body` - `subject` (string, required) - `template_id` ### `klaviyo_create_event` (~110 tokens) Klaviyo Create Event Send a custom event to a Klaviyo profile, such as an ad conversion with a monetary value. Call this to push paid-media conversions into Klaviyo so flows can trigger on them and revenue attribution reconciles. [effect=write; scope=email:write; externalMutation=true] Input parameters: - `account_id` - `account_name` - `email` (string, required) - `metric` (string, required) - `properties` - `time` - `value` ### `klaviyo_update_list_profiles` (~96 tokens) Klaviyo Update List Profiles Add or update profiles on a Klaviyo list from supplied JSON. Call this to sync an audience built elsewhere (a customer export, an ad-platform audience) into a Klaviyo list for lifecycle targeting. [effect=write; scope=email:write; externalMutation=true] Input parameters: - `account_id` - `account_name` - `list_id` (string, required) - `profiles_json` (string, required) ## Diagnostics Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/synter-media-ai-synter-ads/mcp-2#diagnostics ## Score history - 2026-10-07: 36 - 2026-10-05: 36 - 2026-10-04: 36 - 2026-10-03: 36 - 2026-10-02: 72 ## Common questions ### What is the io.github.Synter-Media-AI/synter-ads MCP server? io.github.Synter-Media-AI/synter-ads is an MCP server listed in the public MCP registry as io.github.Synter-Media-AI/synter-ads. Reporting across 19 ad platforms, campaign creation on 14, write actions on 16, via AI. This page covers its hosted endpoint (https://mcp.syntermedia.ai/mcp/). ### Is the io.github.Synter-Media-AI/synter-ads MCP server safe to use? io.github.Synter-Media-AI/synter-ads scores 36 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm. ### What tools does the io.github.Synter-Media-AI/synter-ads MCP server expose? io.github.Synter-Media-AI/synter-ads exposes 235 tools: get_organic_publishing_readiness, draft_organic_post, validate_organic_post, approve_organic_post, schedule_organic_post, and 230 more. Their descriptions and schemas cost roughly 25,044 tokens of context every time the server is loaded. ### Does the io.github.Synter-Media-AI/synter-ads MCP server require authentication? Yes. io.github.Synter-Media-AI/synter-ads asked us for credentials when we connected, so you will need to authorise it in your MCP client before it can do anything. ### Is the io.github.Synter-Media-AI/synter-ads MCP server still maintained? io.github.Synter-Media-AI/synter-ads is still listed as active in the MCP registry. We last reached this channel on 7 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced. ## Links - Remote endpoint: https://mcp.syntermedia.ai/mcp/ - Authorisation metadata: https://mcp.syntermedia.ai/.well-known/oauth-protected-resource/mcp - Repository: https://github.com/Synter-Media-AI/mcp-server - Changelog RSS feed: https://verifymcp.io/servers/synter-media-ai-synter-ads/mcp-2.xml - Changelog JSON feed: https://verifymcp.io/servers/synter-media-ai-synter-ads/mcp-2.json - HTML version of this page: https://verifymcp.io/servers/synter-media-ai-synter-ads/mcp-2