Tool Reference

Digital Face exposes 15 tools via MCP. Your AI client calls these automatically when you describe what you want to do.

10Read

5Write

Overview

Tool	Type	Platform	Description
`check_connections`	Read	Cross	Verify which ad platforms are connected and their status.
`google_keyword_research`	Read	Google	Research keywords using Google Keyword Planner data.
`google_create_campaign`	Write	Google	Create a new Google Search campaign.
`google_get_campaigns`	Read	Google	List all campaigns in the connected Google Ads account with performance metrics for a date range.
`google_get_campaign_details`	Read	Google	Get detailed metrics for a specific campaign including impressions, clicks, conversions, cost, CTR, CPC, and ROAS.
`google_update_budget`	Write	Google	Adjust the daily budget for a Google Ads campaign.
`google_update_campaign_status`	Write	Google	Change the status of a Google Ads campaign.
`google_get_ad_groups`	Read	Google	List ad groups within a campaign with performance metrics.
`google_get_search_terms`	Read	Google	Get the search term report showing actual queries that triggered your ads, with performance data.
`google_add_negative_keywords`	Write	Google	Add negative keywords to a campaign to filter out irrelevant traffic.
`meta_get_campaigns`	Read	Meta	List Meta ad campaigns with performance metrics including reach, impressions, clicks, spend, and conversions.
`meta_get_adsets`	Read	Meta	List ad sets within a Meta campaign with targeting, budget, and performance data.
`meta_get_ads`	Read	Meta	List individual ads within an ad set with creative details and performance metrics.
`meta_get_creative_fatigue`	Read	Meta	Detect ad creatives with signs of fatigue: rising frequency combined with declining CTR or increasing CPA.
`meta_update_budget`	Write	Meta	Adjust the budget for a Meta campaign or ad set.

Detailed Reference

check_connectionsRead

Cross

Verify which ad platforms are connected and their status. Returns a list of active connections with platform type and account ID.

Example Prompt

"Check my connections"

google_keyword_researchRead

Google

Research keywords using Google Keyword Planner data. Returns search volume, competition level, CPC estimates, and related keyword ideas.

Parameters

Name	Type	Required	Description
`keywords`	`string[]`	Yes	Seed keywords to research (max 10)
`language`	`string`	No	Target language code (default: en)
`location`	`string`	No	Target location (default: US)

Example Prompt

"Research keywords for running shoes"

google_create_campaignWrite

Google

Create a new Google Search campaign. The campaign is always created in PAUSED state for safety. Includes ad group, keywords, and responsive search ad.

Parameters

Name	Type	Required	Description
`campaign_name`	`string`	Yes	Name for the new campaign
`daily_budget`	`number`	Yes	Daily budget in account currency
`keywords`	`string[]`	Yes	Keywords to target
`headlines`	`string[]`	Yes	Ad headlines (3-15, max 30 chars each)
`descriptions`	`string[]`	Yes	Ad descriptions (2-4, max 90 chars each)
`final_url`	`string`	Yes	Landing page URL

Example Prompt

"Create a campaign for running shoes with $50/day budget targeting best running shoes, buy running shoes online"

google_get_campaignsRead

Google

List all campaigns in the connected Google Ads account with performance metrics for a date range.

Parameters

Name	Type	Required	Description
`date_range`	`string`	No	Preset range: LAST_7_DAYS, LAST_30_DAYS, THIS_MONTH (default: LAST_30_DAYS)
`status`	`string`	No	Filter by status: ENABLED, PAUSED, REMOVED

Example Prompt

"Show my campaign performance for last 7 days"

google_get_campaign_detailsRead

Google

Get detailed metrics for a specific campaign including impressions, clicks, conversions, cost, CTR, CPC, and ROAS.

Parameters

Name	Type	Required	Description
`campaign_id`	`string`	Yes	Google Ads campaign ID
`date_range`	`string`	No	Preset range (default: LAST_30_DAYS)

Example Prompt

"Show details for campaign 12345678"

google_update_budgetWrite

Google

Adjust the daily budget for a Google Ads campaign. Changes are capped at 50% increase or decrease per call for safety.

Parameters

Name	Type	Required	Description
`campaign_id`	`string`	Yes	Google Ads campaign ID
`new_budget`	`number`	Yes	New daily budget in account currency

Example Prompt

"Increase the budget for campaign 12345678 to $75/day"

google_update_campaign_statusWrite

Google

Change the status of a Google Ads campaign. Supports ENABLED, PAUSED, and REMOVED.

Parameters

Name	Type	Required	Description
`campaign_id`	`string`	Yes	Google Ads campaign ID
`status`	`string`	Yes	New status: ENABLED, PAUSED, or REMOVED

Example Prompt

"Pause campaign 12345678"

google_get_ad_groupsRead

Google

List ad groups within a campaign with performance metrics.

Parameters

Name	Type	Required	Description
`campaign_id`	`string`	Yes	Google Ads campaign ID
`date_range`	`string`	No	Preset range (default: LAST_30_DAYS)

Example Prompt

"Show ad groups for campaign 12345678"

google_get_search_termsRead

Google

Get the search term report showing actual queries that triggered your ads, with performance data. Useful for finding negative keyword candidates.

Parameters

Name	Type	Required	Description
`campaign_id`	`string`	Yes	Google Ads campaign ID
`date_range`	`string`	No	Preset range (default: LAST_30_DAYS)
`min_impressions`	`number`	No	Minimum impressions threshold

Example Prompt

"Find search terms with zero conversions for campaign 12345678"

google_add_negative_keywordsWrite

Google

Add negative keywords to a campaign to filter out irrelevant traffic.

Parameters

Name	Type	Required	Description
`campaign_id`	`string`	Yes	Google Ads campaign ID
`keywords`	`string[]`	Yes	Negative keywords to add
`match_type`	`string`	No	BROAD, PHRASE, or EXACT (default: BROAD)

Example Prompt

"Add free and cheap as negative keywords to campaign 12345678"

meta_get_campaignsRead

Meta

List Meta ad campaigns with performance metrics including reach, impressions, clicks, spend, and conversions.

Parameters

Name	Type	Required	Description
`date_range`	`string`	No	Preset range (default: LAST_30_DAYS)
`status`	`string`	No	Filter by status: ACTIVE, PAUSED, ARCHIVED

Example Prompt

"Show my Meta campaigns"

meta_get_adsetsRead

Meta

List ad sets within a Meta campaign with targeting, budget, and performance data.

Parameters

Name	Type	Required	Description
`campaign_id`	`string`	Yes	Meta campaign ID
`date_range`	`string`	No	Preset range (default: LAST_30_DAYS)

Example Prompt

"Show ad sets for Meta campaign 23456789"

meta_get_adsRead

Meta

List individual ads within an ad set with creative details and performance metrics.

Parameters

Name	Type	Required	Description
`adset_id`	`string`	Yes	Meta ad set ID
`date_range`	`string`	No	Preset range (default: LAST_30_DAYS)

Example Prompt

"Show ads in ad set 34567890"

meta_get_creative_fatigueRead

Meta

Detect ad creatives with signs of fatigue: rising frequency combined with declining CTR or increasing CPA.

Parameters

Name	Type	Required	Description
`campaign_id`	`string`	No	Scope to a specific campaign (optional)
`threshold_frequency`	`number`	No	Frequency threshold (default: 3.0)

Example Prompt

"Check for creative fatigue across my Meta campaigns"

meta_update_budgetWrite

Meta

Adjust the budget for a Meta campaign or ad set. Changes are capped at 50% per call for safety.

Parameters

Name	Type	Required	Description
`object_id`	`string`	Yes	Campaign or ad set ID
`new_budget`	`number`	Yes	New daily or lifetime budget
`budget_type`	`string`	No	DAILY or LIFETIME (default: DAILY)

Example Prompt

"Increase the budget for Meta campaign 23456789 to $100/day"

Safety Note

All Write tools include safety guardrails
New campaigns are always created in PAUSED state
Budget changes are capped at 50% per adjustment
Your AI client will confirm before executing write operations