Tool Catalog

Tool Types

Read Safe to run anytime. Pulls data, analyzes performance, provides insights. No spending impact.
Write Requires user confirmation. Creates campaigns, updates budgets, modifies targeting. Affects spend.

Google Ads Tools (40+)

Hide View all Google Ads tools

Tool Name	Type	Description
`get_campaign_performance`	Read	Pull metrics for campaigns (spend, conversions, CPA, ROAS)
`research_keywords`	Read	Find keywords with real CPC data from Google Keyword Planner
`create_search_campaign`	Write	Launch Google Search campaign (created PAUSED)
`create_pmax_campaign`	Write	Launch Performance Max campaign (created PAUSED)
`analyze_wasted_spend`	Read	Find campaigns with wasted spend. Excludes learning-phase (< 14 days) and insufficient-data (< $20 spend) campaigns from waste totals.
`optimize_budget_allocation`	Read	Recommend budget shifts based on ROAS/CPA
`analyze_search_terms`	Read	Review actual search queries triggering your ads
`discover_existing_assets`	Read	Check if account has images/headlines/descriptions
`suggest_ad_content`	Read	Generate ad headlines and descriptions (Google char limits)
`validate_and_prepare_assets`	Read	Verify assets meet Google’s requirements before campaign creation
`update_campaign_budget`	Write	Change daily budget for existing campaigns
`pause_campaign`	Write	Stop campaigns or ad groups
`resume_campaign`	Write	Restart paused campaigns
`add_negative_keywords`	Write	Block irrelevant search terms
`manage_ad_extensions`	Write	Add sitelinks, callouts, structured snippets
`explain_performance_anomaly`	Read	Diagnose sudden CPA spikes or CTR drops
`help_user_upload`	Read	Guide user through asset upload process
`add_pmax_search_themes`	Write	Add search themes to a PMax campaign’s asset group (max 50). Guides Google’s automated targeting.
`get_pmax_search_themes`	Read	View current search themes on a PMax campaign (max 50 per asset group)
`remove_pmax_search_themes`	Write	Remove specific search themes from a PMax campaign
`add_pmax_audience_signal`	Write	Add audience signal to PMax campaign. Combines in-market, affinity, custom audiences, and user lists.
`get_pmax_audience_signals`	Read	View current audience signals on a PMax campaign
`remove_pmax_audience_signal`	Write	Remove an audience signal from a PMax campaign
`search_audiences`	Read	Search Google Ads audiences by keyword across in-market, affinity, and custom types
`get_campaign_targeting`	Read	View location targeting on existing campaigns
…and 15 more		Ad group management, bidding, geographic targeting, etc.

LinkedIn Ads Tools (30+)

Show View all LinkedIn Ads tools

Tool Name	Type	Description
`get_linkedin_campaign_performance`	Read	Pull metrics for LinkedIn campaigns (spend, clicks, conversions, cost per lead)
`get_linkedin_organizations`	Read	List user’s LinkedIn company pages (required before campaign creation)
`search_linkedin_targeting`	Read	Find B2B audiences by job title, industry, company size, seniority
`research_business_for_linkedin_targeting`	Read	Input competitor name, get targeting suggestions
`create_linkedin_image_campaign`	Write	Launch sponsored content campaign (created PAUSED). Supports campaign groups and creative naming.
`add_linkedin_campaign_to_group`	Write	Add a campaign to an existing campaign group
`add_linkedin_carousel_creative`	Write	Add carousel creative variations to campaigns
`discover_linkedin_assets`	Read	Check existing creatives in LinkedIn (includes videos uploaded via Campaign Manager)
`validate_and_prepare_linkedin_assets`	Read	Verify images meet LinkedIn requirements (1200x627px or 1200x1200px)
`add_linkedin_creative`	Write	Add new sponsored posts to existing campaigns
`analyze_linkedin_creative_performance`	Read	See which images/copy combinations perform best
`optimize_linkedin_budget`	Read	Recommend budget reallocation based on cost per lead
`update_linkedin_campaign`	Write	Change budgets, bids, or targeting
`pause_linkedin_campaign`	Write	Stop campaigns or ad groups
`explain_linkedin_anomaly`	Read	Diagnose sudden CTR, CPC, or conversion rate changes
`manage_linkedin_conversions`	Write	Set up and track conversion events (form fills, downloads)
…and 14 more		Lead gen forms, audience expansion, bid strategies, etc.

Meta Ads Tools (21)

Show View all 36 Meta Ads tools

Tool Name	Type	Description
`get_meta_campaign_performance`	Read	Pull metrics for Meta campaigns (Facebook + Instagram)
`search_meta_targeting`	Read	Find audiences by interests, demographics, behaviors
`select_meta_campaign_type`	Read	Choose: Image, Video, or Carousel based on creative assets
`discover_meta_assets`	Read	Check existing creatives in Meta
`validate_and_prepare_meta_assets`	Read	Verify image/video URLs meet Meta requirements (dimensions, file size)
`create_meta_image_campaign`	Write	Launch single-image campaign (created PAUSED)
`create_meta_video_campaign`	Write	Launch video campaign (created PAUSED)
`create_meta_carousel_campaign`	Write	Launch multi-card carousel campaign (created PAUSED)
`analyze_meta_ad_performance`	Read	Deep analysis of ad-level performance with recommendations
`analyze_meta_audiences`	Read	See which audience segments perform best (age, gender, interests)
`detect_meta_creative_fatigue`	Read	Identify ads losing effectiveness over time (declining CTR after 14+ days)
`optimize_meta_budget`	Read	Recommend budget reallocation based on ROAS/CPA
`optimize_meta_placements`	Read	Shift spend to best-performing placements (Feed, Stories, Reels)
`explain_meta_anomaly`	Read	Diagnose sudden CPA spikes or CTR drops
`update_meta_campaign`	Write	Change budgets, bids, or targeting
`pause_meta_campaign`	Write	Stop campaigns or ad sets
`browse_meta_targeting`	Read	Explore Meta’s targeting categories
`list_meta_custom_audiences`	Read	View custom audiences (database lists, lookalikes, website, engagement)
`add_meta_ad_set`	Write	Add ad sets to existing campaigns (lifetime budgets, end dates, placements)
`add_meta_ad`	Write	Add ads to existing ad sets
`analyze_meta_wasted_spend`	Read	Identify campaigns with poor ROAS and recommend cuts
`get_meta_audience_insights`	Read	Audience breakdown by age, gender, and interests
`resume_meta_campaign`	Write	Restart paused campaigns
`list_meta_campaigns`	Read	List all campaigns with status and budget
`get_meta_campaign_details`	Read	Detailed campaign info
`list_meta_ad_sets`	Read	List ad sets in a campaign
`list_meta_ads`	Read	List ads in an ad set
`update_meta_ad_set`	Write	Update ad set budgets, targeting, or schedule
`update_meta_ad`	Write	Update ad creative or status
`get_meta_ad_creatives`	Read	View creative details for ads
`create_meta_dco_ad`	Write	Create dynamic creative optimization ads
`duplicate_meta_campaign`	Write	Duplicate an existing campaign
`list_meta_lead_forms`	Read	View lead forms in your ad account
`get_meta_lead_form_submissions`	Read	Pull lead submissions from a form
`list_meta_instagram_accounts`	Read	View connected Instagram accounts
`list_meta_pixels`	Read	View Meta Pixels in your ad account

TikTok Ads Tools (31)

Show View all 31 TikTok Ads tools

Tool Name	Type	Description
`get_tiktok_campaign_performance`	Read	Campaign summary with TikTok-specific video and engagement metrics
`get_tiktok_ad_performance`	Read	Ad-level analysis with hook rate, video completion, and engagement
`analyze_tiktok_wasted_spend`	Read	ROAS-based waste detection with campaign status awareness
`optimize_tiktok_budget`	Read	Budget allocation recommendations based on performance
`detect_tiktok_creative_fatigue`	Read	Hook rate decline as the primary fatigue signal
`explain_tiktok_anomaly`	Read	Diagnose sudden changes in TikTok campaign performance
`get_tiktok_audience_insights`	Read	Age/gender breakdown with CPA ranking
`analyze_tiktok_geo_performance`	Read	Country-level performance analysis
`discover_tiktok_assets`	Read	Check existing videos in TikTok
`validate_and_prepare_tiktok_assets`	Read	Verify videos meet TikTok requirements (9:16 vertical, 5-60 seconds)
`upload_tiktok_images`	Write	Upload images to TikTok Asset Library
`create_tiktok_campaign`	Write	Launch in-feed video campaign (created PAUSED)
`add_tiktok_ad_group`	Write	Add ad group with full targeting to existing campaign
`add_tiktok_ad`	Write	Add ad to existing ad group (image, video, Spark Ads, Carousel)
`create_tiktok_carousel_card`	Write	Create carousel card from multiple images
`search_tiktok_targeting`	Read	Search interests, keywords, regions, languages, action categories, carriers, device models
`list_tiktok_campaigns`	Read	List all campaigns with status, objective, and budget
`get_tiktok_campaign_details`	Read	Detailed campaign info
`update_tiktok_campaign`	Write	Update campaign name, budget, budget mode
`pause_tiktok_campaign`	Write	Pause a TikTok campaign
`resume_tiktok_campaign`	Write	Resume a paused TikTok campaign
`list_tiktok_ad_groups`	Read	List ad groups, filter by campaign
`update_tiktok_ad_group`	Write	Update ad group name, budget, targeting, schedule
`pause_tiktok_ad_group`	Write	Pause a TikTok ad group
`resume_tiktok_ad_group`	Write	Resume a paused TikTok ad group
`list_tiktok_ads`	Read	List ads, filter by ad group or campaign
`pause_tiktok_ad`	Write	Pause a TikTok ad
`resume_tiktok_ad`	Write	Resume a paused TikTok ad
…and 3 more		Additional TikTok tools

Audit Tools (1)

Tool Name	Type	Description
`audit_conversion_tracking`	Read	Audit conversion tracking health across platforms. Checks Meta Pixel (event volume, CAPI, dedup), LinkedIn (conversion rules, CAPI, Insight Tag), and Google Ads (conversion actions, enhanced conversions, attribution). Returns health score (0-100), grade (A-F), and actionable recommendations.

Automation Tools (8)

Show View all 8 Automation tools

Tool Name	Type	Description
`schedule_brief`	Write	Schedule daily/weekly performance summaries via email or Slack
`create_monitor`	Write	Set alerts for CPA spikes, budget overspend, CTR drops
`list_monitors`	Read	View all active performance monitors
`delete_monitor`	Write	Remove a monitor
`generate_report_now`	Read	Generate ad-hoc cross-platform performance report
`list_scheduled_tasks`	Read	View all scheduled briefs and reports
`update_scheduled_task`	Write	Change frequency or parameters of scheduled briefs
`delete_scheduled_task`	Write	Remove a scheduled brief or report

System Tools (4)

Tool Name	Type	Description
`get_connections_status`	Read	Show all connected ad platforms and account IDs
`switch_primary_account`	Write	Change active ad account (for users managing multiple accounts)
`get_usage_status`	Read	Check Adspirer plan limits (tool calls used/remaining this month)
`get_business_profile`	Read	View user’s Adspirer account details and subscription info

Tool Call Best Practices

Always start with get_connections_status: Verify the correct ad account is active before using platform-specific tools
Chain Read tools before Write tools: Research, validate, then create. Never jump straight to campaign creation.
Ask for user confirmation before Write tools: Present the plan, get approval, then execute.
Never retry Write tools on error: If a campaign creation fails, report the error and wait for user input. Don’t auto-retry.
Format results as tables: Performance data should be scannable (columns: metric, value, change vs. previous period)

Input Format Requirements

Follow these rules when calling Adspirer tools to avoid validation errors:

IDs Must Be Strings

All IDs (campaign_id, ad_account_id, video_id, image_hash, ad_group_id, keyword_id, organization_id, creative_id) must be passed as quoted strings, never as bare integers.

// ✅ Correct
{"existing_video_id": "1333064875515942"}

// ❌ Wrong
{"existing_video_id": 1333064875515942}

Never Modify IDs

Copy IDs exactly as returned by list/discover tools. Do not round, truncate, or change any digits.

Always Call List/Discover Before Create/Update

Many tools require IDs from prior tool calls:

list_campaigns → get campaign_id before update/pause/structure
get_campaign_structure → get ad_group_id before keyword operations
discover_existing_assets → get image_hash, video_id before campaign creation
get_linkedin_organizations → get organization_id and account_id

Text Length Limits

The server will reject text that exceeds platform limits:

Field	Platform	Max Characters
Headline	Google Ads	30
Description	Google Ads	90
Sitelink text	Google Ads	25
Callout	Google Ads	25
primary_text	Meta Ads	125
Headline	Meta Ads	40

Meta Ad Copy Formatting

Meta primary_text supports emojis, line breaks (\n), and bullet points for higher engagement:

🔥 Limited Time Offer!

✅ Free Shipping
✅ 30-Day Returns
✅ Best Price Guarantee

👉 Shop now before it's gone!

Use emojis strategically (🔥 ✅ 🎯 💰 ⚡ 🚀 👉 ⭐ 💡 📈) and structure copy with line breaks and bullet points (•, ✅, ▸) for readability.

Enum Values Are Case-Insensitive

The server auto-normalizes casing. Common enum values:

status: ENABLED, PAUSED, ACTIVE, ARCHIVED
objective: OUTCOME_TRAFFIC, OUTCOME_SALES, OUTCOME_LEADS
match_type: EXACT, PHRASE, BROAD
date_range: last_7_days, last_30_days, last_90_days
campaign_type: search, pmax, image, video, carousel

Budgets Are Numbers

Pass budget fields as numbers, not strings. Budget is in the account’s local currency (not cents).

Keywords Format

For add_negative_keywords, each keyword must be an object with text and match_type fields:

// ✅ Correct
{"keywords": [{"text": "free", "match_type": "BROAD"}]}

// ❌ Wrong
{"keywords": ["free", "cheap"]}

Core Workflows — See how these tools fit into step-by-step processes
Skills Overview
Google Ads Integration
Meta Ads Integration
LinkedIn Ads Integration
TikTok Ads Integration

Getting Started

AI Clients

Ad Platforms

Agent Skills

Resources

Tool Types

Google Ads Tools (40+)

LinkedIn Ads Tools (30+)

Meta Ads Tools (21)

TikTok Ads Tools (31)

Audit Tools (1)

Automation Tools (8)

System Tools (4)

Tool Call Best Practices

Input Format Requirements

IDs Must Be Strings

Never Modify IDs

Always Call List/Discover Before Create/Update

Text Length Limits

Meta Ad Copy Formatting

Enum Values Are Case-Insensitive

Budgets Are Numbers

Keywords Format

Getting Started

AI Clients

Ad Platforms

Agent Skills

Resources

​Tool Types

​Google Ads Tools (40+)

​LinkedIn Ads Tools (30+)

​Meta Ads Tools (21)

​TikTok Ads Tools (31)

​Audit Tools (1)

​Automation Tools (8)

​System Tools (4)

​Tool Call Best Practices

​Input Format Requirements

​IDs Must Be Strings

​Never Modify IDs

​Always Call List/Discover Before Create/Update

​Text Length Limits

​Meta Ad Copy Formatting

​Enum Values Are Case-Insensitive

​Budgets Are Numbers

​Keywords Format

​Related Documentation

Tool Types

Google Ads Tools (40+)

LinkedIn Ads Tools (30+)

Meta Ads Tools (21)

TikTok Ads Tools (31)

Audit Tools (1)

Automation Tools (8)

System Tools (4)

Tool Call Best Practices

Input Format Requirements

IDs Must Be Strings

Never Modify IDs

Always Call List/Discover Before Create/Update

Text Length Limits

Meta Ad Copy Formatting

Enum Values Are Case-Insensitive

Budgets Are Numbers

Keywords Format

Related Documentation