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 (39)

Hide View all 39 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
…and 15 more		Ad group management, bidding, geographic targeting, etc.

LinkedIn Ads Tools (28)

Show View all 28 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)
`discover_linkedin_assets`	Read	Check existing creatives in LinkedIn
`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 (20)

Show View all 20 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
…and 3 more		Resume campaigns, audience insights, etc.

TikTok Ads Tools (4)

Tool Name	Type	Description
`get_tiktok_campaign_performance`	Read	Pull metrics for TikTok campaigns
`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)
`create_tiktok_campaign`	Write	Launch in-feed video campaign (created PAUSED)

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 (39)

LinkedIn Ads Tools (28)

Meta Ads Tools (20)

TikTok Ads Tools (4)

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 (39)

​LinkedIn Ads Tools (28)

​Meta Ads Tools (20)

​TikTok Ads Tools (4)

​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 (39)

LinkedIn Ads Tools (28)

Meta Ads Tools (20)

TikTok Ads Tools (4)

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