Tools

Reference for all AirOps MCP tools

All available tools for accessing your AirOps workspace data. Each tool supports filtering, field selection, sorting, and pagination.

Workspace & Brand Kit

list_workspaces

List all workspaces you have access to.

Returns: Workspace ID, name, slug, and subscription tier.

---

list_brand_kits

List Brand Kits with optional related data.

Returns: Brand identity (name, URL, description), writing guidelines (tone, persona, rules, sample content), visual settings (colors, header case), and targeting (countries). Optionally includes product lines, competitors, audiences, and content types.

Parameter	Values
Filters	brand_name, brand_url, created_at, aeo_enabled
Sort	brand_name, created_at, prompts_count
Includes	product_lines, competitors, audiences, content_types

---

get_brand_kit

Get a specific Brand Kit by ID with all details.

Requires: id

Returns: Complete Brand Kit data including brand identity, writing guidelines, visual settings, and optionally related product lines, competitors, audiences, and content types.

---

list_brand_kit_competitors

List competitors for a Brand Kit.

Requires: brand_kit_id

Returns: Competitor ID, name, domain URL, and creation date.

Parameter	Values
Filters	name
Sort	name, created_at

---

list_topics

List topics configured for a Brand Kit.

Requires: brand_kit_id

Returns: Topic ID, name, and color.

---

list_personas

List personas configured for a Brand Kit.

Requires: brand_kit_id

Returns: Persona ID, title, and description.

---

AEO Prompts & Answers

list_aeo_prompts

List tracked AI prompts for a Brand Kit.

Requires: brand_kit_id

Returns: Prompt ID, text, keyword, whether brand is mentioned, volume, topic ID, timestamps, mention_rate, citation_rate, and trends.

Parameter	Values
Filters	text, strategy, brand_mentioned, topic_id, prompt_volume, mention_rate, citation_rate
Sort	text, created_at, prompt_volume, mention_rate, citation_rate
Includes	topic, opportunity_prompts, tags
Date filters	start_date, end_date, providers, countries, personas

---

get_prompt_answers

Get AI answers for a specific prompt.

Requires: prompt_id

Returns: Answer ID, text (truncated), provider, country, brand_mentioned, brand_cited, timestamps.

Parameter	Values
Filters	countries, personas
Sort	created_at
Includes	persona

---

get_answer

Get a specific AI answer by ID with full text content.

Requires: id

Returns: Full answer text (not truncated), provider, country, brand_mentioned, brand_cited, and optionally citations, mentions, and persona details.

Parameter	Values
Includes	citations, mentions, persona

Use this after get_prompt_answers to retrieve complete answer text with citation URLs and positions.

---

Citations & Domains

list_aeo_citations

List citations (URLs) with metrics for a Brand Kit. Shows individual URLs being cited in AI answers.

Requires: brand_kit_id

Returns: URL, domain name, domain category, citation count, citation share, citation rate, influence score, page type, brand sentiment, and trends.

Parameter	Values
Filters	domain_category, domain_id, topic_id, brand_mentioned, page_type, brand_referenced, brand_sentiment
Sort	citation_count, citation_share, citation_rate, influence_score
Date filters	start_date, end_date, providers, countries, personas

Domain categories: Owned, Competitors, Social, Communities, Reviews, Media, Educational, Marketplaces, Products, Affiliates, Other

---

get_aeo_citation

Get prompts citing a specific URL.

Requires: brand_kit_id, id (the citation/URL ID)

Returns: URL details, citation metrics, influence score breakdown, page type, brand sentiment, and mentioned competitors.

---

list_aeo_domains

List domains cited in AI answers for a Brand Kit. Aggregated by domain with citation metrics.

Requires: brand_kit_id

Returns: Domain ID, name, category, logo URL, citation count, URL count, citation share, citation rate, and trends.

Parameter	Values
Filters	domain_category, topic_id, brand_mentioned, page_type, brand_referenced, brand_sentiment
Sort	citation_count, citation_share, citation_rate
Date filters	start_date, end_date, providers, countries, personas

---

Page Analytics

list_pages

List pages with AEO, Google Search Console, and GA4 metrics.

Requires: brand_kit_id

Returns: For each page: URL, folder path, primary keyword, and metrics:

• AEO: citations_count, citation_rate, prompts_count, and trends

• GSC: clicks, impressions, ctr, position, and trends

• GA4: traffic, sessions, engagement, average_session_engagement, and trends

Parameter	Values
Filters	Any metric field, url, folder_name, primary_keyword, session_source, session_medium
Sort	All metric fields, url, folder_name
Smart filters	almost_page_one, losing_clicks, rankings_slipping, losing_ai_visibility, citation_rate_decline

Smart filters (use instead of manual filtering):

Filter	Description
almost_page_one	Pages ranking #11-20 (quick wins for page 1)
losing_clicks	Declining clicks with stable position
rankings_slipping	Position declining over time
losing_ai_visibility	Losing AEO citations
citation_rate_decline	Losing AI authority with stable SEO

---

get_page_details

Get detailed metrics for a specific page.

Requires: id

Returns: URL, folder, primary keyword, citation share, citation rate, unique cited questions count, GSC metrics (clicks, impressions, position, CTR), and all trends.

Parameter	Values
Date range	start_date, end_date

---

get_page_prompts

Get AI prompts that cite a specific page.

Requires: brand_kit_id, web_page_id

Returns: Prompt ID, text, keyword, topic_id, volume, total_answers, answers_with_citations, citation_rate, mention_rate, and trends.

Parameter	Values
Filters	providers, countries, personas, topic_ids
Includes	topic
Date range	start_date, end_date

---

Analytics

query_analytics

Query analytics with flexible metrics, dimensions, and filters. BI-style interface for custom reports.

Requires: brand_kit_id, metrics

Returns: Query results with requested metrics grouped by dimensions, plus metadata.

Metrics:

Metric	Description
mention_rate	% of answers mentioning brand (0-100)
share_of_voice	Brand mentions vs competitors (0-100)
citation_rate	% of answers citing brand domain (0-100)
citation_share	Brand citations vs all citations (0-100)
citation_count	Absolute citation count
sentiment_score	Average sentiment (0-100)
average_position	Mean rank in answer lists
answer_count	Total answers analyzed
first_mention_rate	% where brand is mentioned first (0-100)

Dimensions (max 3):

Dimension	Description
date	Group by time period
provider	Group by AI provider
topic	Group by tracked topic
competitor	Group by competitor
country	Group by region/country
persona	Group by customer persona
domain	Group by cited domain
domain_category	Group by citation source type

Parameter	Values
grain	daily, weekly, monthly, total (default: total)
Date range	start_date, end_date (default: last 30 days)
Filters	providers, topics, countries, personas, brand_mentioned
Limit	max rows (default 100, max 1000)
order_by	custom sort (e.g., "citation_count DESC")

---

Reports

create_report

Create a saved analytics report with visualization modules.

Requires: brand_kit_id, name, modules

Returns: Report ID, name, and URL to view in AirOps.

Module configuration:

Field	Description	Values
title	Display title	Any string
metrics	What to measure	mention_rate, share_of_voice, citation_rate, citation_share, citation_count, sentiment_score, average_position, answer_count, first_mention_rate
dimensions	How to group	date, provider, topic, country, persona, domain, competitor, domain_category
grain	Time aggregation	daily, weekly, monthly, total
visualization	Chart type	value (KPI), line (trend), bar (comparison), table (data)
filters	Data filters	start_date, end_date (required), providers, topic_ids, personas, region
layout	Grid position	x, y, w, h (optional)

---

list_reports

List saved analytics reports.

Requires: brand_kit_id

Returns: Report ID, name, created_at, updated_at.

Parameter	Values
Filters	name
Sort	name, created_at, updated_at
Includes	modules

---

get_report

Get a specific report by ID.

Requires: brand_kit_id, id

Returns: Report ID, name, timestamps. With includes: ['modules'], returns full module configurations.

---

Action Grids

create_action_grid

Create an action grid for page optimization with power agents.

Requires: brand_kit_id, action_type, rows

Returns: Grid ID and URL to view in AirOps.

Action types:

Action Type	Row Fields	Use Case
visibility_gap	url, folder, questions	Pages needing content refresh
popular_query_gap	keyword, questions, relative_volume_score	High-volume keywords to target
content_outreach	url, questions, competitors	Content for outreach campaigns
community_outreach	url, thread, questions	Community threads to engage
competitor_dominated_keyword	keyword, questions, competitors, mention_rate	Keywords competitors own
highly_cited_thread	cited_url, domain_url, questions, citation_rate	High-performing threads
rising_third_party_content	cited_url, domain_name, questions, citation_rates	Rising competitor content
losing_ai_visibility	url, folder, questions, citation_loss_percent	Pages losing citations
almost_page_one	url, folder, average_serp_position	Pages close to page 1
blue_ocean	keyword, questions	Untapped keyword opportunities

Each action type has specific row fields. The grid is created in AirOps with power agent columns configured for the action type.

---

Query Options

All list tools support:

Option	Description
Filters	Narrow by field values (EQUALS, CONTAINS, EQ, NEQ, GT, LT, GEQ, LEQ, IN)
Includes	Request related data in one call
Fields	Select specific fields to return
Sort	Order by supported fields (prefix - for descending)
Pagination	Control results with page and per_page (max 100)

---

AI Providers

Available provider values for filtering:

• chat_gpt

• gemini

• perplexity

• google_ai_mode

• google_ai_overview

---

Next Steps

• Use Cases — Example workflows

• FAQ — Common questions