Tools & Skills

Available MCP tools for accessing your AirOps workspace data

The AirOps MCP server provides tools for accessing your workspace data. Each tool supports filtering, field selection, sorting, and pagination.

Tools

Workspace & Brand Kit

list_workspaces

List all workspaces you have access to.

Returns: Workspace ID, name, slug, and subscription tier for each workspace.

---

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
Sort	brand_name, created_at

---

get_brand_kit

Get a specific Brand Kit by ID with all details.

Requires: id

Returns: Complete Brand Kit data including all brand identity fields, 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_aeo_prompts

List tracked AI prompts for a Brand Kit. These are the questions being monitored across AI providers.

Requires: brand_kit_id

Returns: Prompt ID, text, keyword, whether brand is mentioned, relative volume score, topic ID, and timestamps. Optionally includes associated topic, opportunity prompts, answers, and tags.

Parameter	Values
Filters	text, strategy, brand_mentioned, topic_id
Sort	text, created_at, relative_volume_score

---

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, and three metric groups:

• AEO metrics: citations count, citation rate, prompts count, and trends

• GSC metrics: clicks, impressions, CTR, position, and trends

• GA4 metrics: traffic, sessions, engagement, avg session duration, and trends

Parameter	Values
Filters	folder, any metric field with operators (EQ, GT, LT, etc.)
Sort	clicks, impressions, ctr, position, citations_count, citation_rate, traffic, sessions, engagement
Date range	start_date, end_date (defaults to last 30 days)
GA4 filters	session_source, session_medium

---

get_page_details

Get detailed metrics for a specific page.

Requires: brand_kit_id, page_id

Returns: Full page data including URL, folder, tracking status, primary keyword, all metric groups (AEO, GSC, GA4), plus a summary with total prompts citing the page, top AI providers, and average citation position.

Parameter	Values
Date range	start_date, end_date

---

get_page_prompts

Get AI prompts that cite a specific page.

Requires: brand_kit_id, page_id

Returns: For each prompt: question text, AI provider (ChatGPT, Perplexity, Gemini, Claude), citation position in the response, last seen timestamp, and answer count.

Parameter	Values
Filters	provider

---

get_prompt_answers

Get AI answers for a specific prompt citing a page.

Requires: brand_kit_id, page_id, prompt_id

Returns: For each answer: AI provider, full answer text, citation position, cited URL, analysis timestamp, and sentiment.

---

find_opportunity_pages

Find pages matching opportunity criteria using smart filters.

Requires: brand_kit_id, filter

Returns: Pages matching the filter with relevant metrics and an opportunity score (0-1).

Available filters:

Filter	Description
almost_page_one	Pages ranking #11-20 (quick wins to reach page 1)
losing_clicks	Declining clicks with stable position
rankings_slipping	Position declining over 90 days
declining_citations	Losing AEO visibility
citation_rate_decline	Losing AI authority with stable SEO

Parameter	Values
Date range	start_date, end_date
Limit	max results (default 20, max 100)

---

Query Options

All list tools support these options:

• Filters: Narrow results by field values using operators like EQUALS, CONTAINS, GT, LT, IN

• Includes: Request related data in a single call (e.g., include competitors with Brand Kits)

• Fields: Select specific fields to return

• Sort: Order by supported fields, prefix with - for descending

• Pagination: Control result count with page and per_page (max 100)

These options have default values and can be overwritten by the agent given the context of your query.

Skills

Skills are higher-level capabilities that combine multiple tools to accomplish complex tasks. They provide guided workflows for common use cases.

Coming Soon

Skills are currently in development. Check back for updates on available skills for competitive analysis, content audits, and automated reporting.

---

• Getting Started — Setup instructions and troubleshooting

• Usage Examples — Example prompts and tips for effective queries