Marketing (all ad platforms)

Spend, results and ads across every connected ad platform. 8 tools: 8 read, 0 write.

Generated

This page is generated from the MCP server source on every docs build. Names, descriptions and arguments are exactly what tools/list returns.

Tool	Access	What it does
nc_get_marketing_stats	read	Total ad spend + impressions/clicks/platform leads across ALL platforms combined, plus CRM leads (new and returning), won deals and won revenue, per channel and in total.
nc_list_campaigns	read	List ad campaigns synced from Meta / Google / TikTok / LinkedIn.
nc_get_campaign_metrics	read	Ad SPEND + performance (impressions, clicks, spend, reach, leads, conversions, CTR, CPC, CPM) from the user’s synced Meta + Google + TikTok data.
nc_list_ads	read	List individual ads (creatives) synced from ad platforms.
nc_get_ad_metrics	read	Per-ad daily metrics over the last N days.
nc_top_performing_ads	read	Shortcut: rank your ads by the metric that matters.
nc_list_marketing_connections	read	List the user’s connected marketing platforms (Google Ads, Facebook/Meta, TikTok, LinkedIn, etc).
nc_validate_landing_page_url	read	Pre-flight check on a landing-page URL before launching an ad.

nc_get_marketing_stats

read Works with mcp:read.

Total ad spend + impressions/clicks/platform leads across ALL platforms combined, plus CRM leads (new and returning), won deals and won revenue, per channel and in total. Money is per currency (never added across currencies). Days are in the business time zone. Use for “total ad spend” or “what did the ads bring in”. Defaults to the last 30 days; pass date_from/date_to (YYYY-MM-DD) for an exact day like today.

Argument	Type	Required	Description
days	integer		Default: 30 · Min 1 · Max 365
model	string		Attribution model for CRM leads and revenue: last touch (default) or first touch. · One of: last, first
date_from	string		Optional YYYY-MM-DD (org-local). Overrides days. Use with date_to for an exact range like “today”.
date_to	string		Optional YYYY-MM-DD (org-local), inclusive.

nc_list_campaigns

read Works with mcp:read.

List ad campaigns synced from Meta / Google / TikTok / LinkedIn. Includes status, objective, daily/lifetime budgets, and platform ids. Use this to discover campaign_id values for nc_get_campaign_metrics.

Argument	Type	Required	Description
platform	string		Filter by platform: meta | google | tiktok | linkedin
status	string		Filter by campaign status (e.g. ACTIVE, PAUSED)
limit	integer		Default: 50 · Min 1 · Max 200

nc_get_campaign_metrics

read Works with mcp:read.

Ad SPEND + performance (impressions, clicks, spend, reach, leads, conversions, CTR, CPC, CPM) from the user’s synced Meta + Google + TikTok data. THE tool for “how much did I spend”, “spend today”, “how much on Meta/Google”. Set platform to isolate a channel (meta=Facebook/Meta, google=Google Ads). Rolled-up totals per campaign when campaign_id is omitted. Needs NO connection_id/ad_account_id.

Argument	Type	Required	Description
campaign_id	string		Optional — internal marketing_campaigns.id
platform	string		Optional — isolate one channel: meta | google | tiktok | linkedin
days	integer		Default: 30 · Min 1 · Max 365
date_from	string		Optional YYYY-MM-DD (org-local). Overrides days. Use with date_to for an exact range like “today”.
date_to	string		Optional YYYY-MM-DD (org-local), inclusive.
sort_by	string		Field to sort campaigns by (descending). Used only when campaign_id is omitted. · One of: spend, clicks, impressions, leads, conversions, ctr, cpc · Default: "spend"
limit	integer		Default: 20 · Min 1 · Max 100

nc_list_ads

read Works with mcp:read.

List individual ads (creatives) synced from ad platforms. Optionally filter by campaign_id, platform, or status. Use to discover ad_id values for nc_get_ad_metrics.

Argument	Type	Required	Description
campaign_id	string
platform	string
status	string
limit	integer		Default: 50 · Min 1 · Max 200

nc_get_ad_metrics

read Works with mcp:read.

Per-ad daily metrics over the last N days. When ad_id is omitted, returns rolled-up totals per ad for the period — answers “which ad creative performs best”.

Argument	Type	Required	Description
ad_id	string		Optional — internal marketing_ads.id
campaign_id	string		Optional — restrict to ads under a campaign
days	integer		Default: 30 · Min 1 · Max 365
sort_by	string		One of: spend, clicks, impressions, conversions, ctr, cpc · Default: "spend"
limit	integer		Default: 20 · Min 1 · Max 100

nc_top_performing_ads

read Works with mcp:read.

Shortcut: rank your ads by the metric that matters. Common asks: “best CTR ads this month”, “lowest CPC ads”, “most leads”. Returns ad name + campaign + the chosen metric value + supporting stats.

Argument	Type	Required	Description
metric	string		ctr/conversions/clicks/impressions sort descending; cpc/spend sort ascending (lower is better for CPC, depends for spend). · One of: ctr, cpc, conversions, clicks, impressions, spend · Default: "ctr"
platform	string		Optional — filter to meta/google/tiktok/linkedin
days	integer		Default: 30 · Min 1 · Max 365
min_impressions	integer		Drop ads with fewer impressions than this — avoids ranking statistical noise. · Default: 100 · Min 1
limit	integer		Default: 10 · Min 1 · Max 50

nc_list_marketing_connections

read Works with mcp:read.

List the user’s connected marketing platforms (Google Ads, Facebook/Meta, TikTok, LinkedIn, etc). Returns connection ids — pass them as connection_id to other marketing tools. Use this BEFORE asking the user which account; the answer is usually already there.

Argument	Type	Required	Description
service	string		Filter by service: google_ads | facebook | tiktok | linkedin | airtable. Omit to return all marketing connections.
active_only	boolean		Default: true

nc_validate_landing_page_url

read Works with mcp:read.

Pre-flight check on a landing-page URL before launching an ad. Server-side fetches the URL, follows redirects, returns final status + redirect chain + optional domain match. Use BEFORE create-campaign tools to avoid Google/Meta rejecting ads for unreachable URLs. https:// only.

Argument	Type	Required	Description
url	string	yes	Public https URL to check.
expected_domain	string		Optional. If provided, the final URL must resolve to this domain (e.g. nexacloser.com).
timeout_ms	integer		Default: 10000 · Min 1000 · Max 30000