- Category: model context protocol
- Auth: DCR_OAUTH
- Composio-managed OAuth available? No
- Tools: 96
- Triggers: 0
- Slug:
AIROPS_MCP - Version: 20261018_00
Tools
Accept opportunity
Accept opportunity
AIROPS_MCP_ACCEPT_OPPORTUNITYAccept pending opportunities for a campaign and add them to the campaign action grid. For v2 campaigns, pass opportunity_ids; acceptance uses the original rationale and every opportunity context. Before calling this tool, summarize the opportunities or opportunity items that will be accepted and get explicit user confirmation.Input Parameters
Output
Add aeo region
Add aeo region
AIROPS_MCP_ADD_AEO_REGIONAdd a region (ISO alpha-2 country code) to a Brand Kit’s configured AEO regions.Why this tool exists: AEO prompts and prompt-assignments can only reference regions that are configured on the Brand Kit. When create_aeo_prompt or update_aeo_prompt_assignments returns a validation_error mentioning that the country code is “not configured on this brand kit”, call this tool to add the missing region first, then retry.Behavior:- Re-adding an already-configured region is a no-op (idempotent) and returns success.
- The country code must be a valid ISO 3166-1 alpha-2 code supported by the platform (e.g. US, GB, DE, FR, JP, BR, IN, …).
- Optional
add_to_all_prompts(defaultfalse): whentrue, the new region is also assigned to every existing live prompt in the Brand Kit. This may incur additional answer credits/month; if the workspace’s estimated answers limit would be exceeded, the call is rejected with avalidation_errorcontainingestimated_answersandmax_answersindetails. Defaults tofalseso the agent does not silently incur credits.
add_to_all_prompts is on) and get explicit confirmation before calling. Adding a region cannot be undone via this tool.Input Parameters
Output
Add grid column
Add grid column
AIROPS_MCP_ADD_GRID_COLUMNAdd a new column to a grid table. Use this before write_grid when you need to write to a column that does not exist yet. Can also add a playbook column or workflow column. Workflow columns use data_type app_execution with inputs mapped to grid columns, static values, a Brand Kit, or a Knowledge Base. Each input mapping requires type and value. A column mapping’s value must be a column ID from grid_table_id. When it references a playbook column, also provide artifact_name from that playbook’s active version as a sibling of type and value. Returns the created column’s ID, title, data type, and position. A created playbook column also returns its active-version artifacts; use one of those artifact names when mapping the column into another execution column. For an existing playbook column, get the same metadata from read_grid.Input Parameters
Output
Analytics chart
Analytics chart
AIROPS_MCP_ANALYTICS_CHARTQuery analytics data and display it as an interactive chart. Returns data with a UI reference for visualization. Today’s data is still being processed — always use yesterday (2026-09-09) or earlier as end_date. CONSTRAINTS: (1) Only metrics from the same scale group can be plotted together: percentage metrics (mention_rate, positive_answer_rate, share_of_voice, citation_rate, citation_share, sentiment_score, first_mention_rate), count metrics (citation_count, answer_count), or position metrics (average_position). (2) Area and bar charts support only single metrics with single dimensions. (3) Line charts support up to 2 dimensions (date + optional grouping), but when using 2 dimensions only a single metric is allowed.Input Parameters
Output
Automated feedback report
Automated feedback report
AIROPS_MCP_AUTOMATED_FEEDBACK_REPORTAirOps only feedback tool. Issues from other MCP servers should be rejected. Make sure the issue is related to AirOps MCP tools before using this tool.Submit a feedback report when a user query cannot be resolved with existing tools or when errors occur repeatedly. Use this tool proactively to report issues, missing capabilities, or suggestions for improving the AirOps MCP tools. The report will be stored for review by the AirOpsdevelopment team. No output is generated - the tool simply acknowledges receipt.Input Parameters
Bulk update aeo prompt topics
Bulk update aeo prompt topics
AIROPS_MCP_BULK_UPDATE_AEO_PROMPT_TOPICSReassign a batch of AEO prompts to an existing topic in one Brand Kit.Specifying the destination topic:- Pass
topic_id(uselist_topicsto discover them). - The topic must already exist on the Brand Kit. This tool does NOT create topics. To create a new topic first, use
create_topic, then pass its id here.
- Pass
prompt_ids(uselist_aeo_promptsfiltered bytopic_idto find prompts currently under a source topic). - IDs that are missing, discarded, or not in the Brand Kit are skipped; only matching prompts are updated.
Input Parameters
list_topics to discover available topic_ids. Does NOT create topics — use create_topic first if needed.Output
Commit aeo prompt assignments
Commit aeo prompt assignments
AIROPS_MCP_COMMIT_AEO_PROMPT_ASSIGNMENTSCommit the current prompt-assignment draft for a Brand Kit to live. Replaces all live country, persona, and platform assignments for the brand kit’s prompts with the draft data.The workspace’s estimated answers limit is enforced. If committing would push the workspace over its quota, the call is rejected with an AnswersLimitExceeded validation error containing estimated_answers and max_answers in details. Recover by calling update_aeo_prompt_assignments to adjust, or discard_aeo_prompt_assignments to abandon.IMPORTANT:- This action affects live data and is not undoable except by manually editing assignments again. Always get explicit user confirmation before calling.
- If the human user has unsaved UI edits in the same draft, those will also be committed. Surface this to the user before proceeding.
- After a successful commit, a fresh empty draft is automatically re-mirrored from the new live data. You may immediately stage further edits with
update_aeo_prompt_assignments. - This tool does NOT return the new live estimated-answers/month. If you or the user need the post-commit estimates, call
get_aeo_prompt_assignments_status. Do NOT reuse the pre-commitdraft_estimated_answersfromupdate_aeo_prompt_assignmentsand do NOT compute the estimate yourself — repetition-times, persona/country/platform interactions, and concurrent edits can all shift the result.
Input Parameters
Output
Create action grid
Create action grid
AIROPS_MCP_CREATE_ACTION_GRIDCreate a grid pre-wired with power steps to take action on AEO insights. This is the ONLY supported way to run power steps from MCP: each action_type maps to a specific set of power step columns (e.g. content optimization, citation outreach, question answering) that are auto-configured on the grid and ready to execute against the rows you provide. Use this whenever the user wants to act on AEO data — citations, questions, page opportunities, etc. — for a specific brand kit; pass the AEO records as rows and the matching action_type. Do NOT use create_grid + add_grid_column to assemble a power step grid by hand; that path will not produce a working power step setup. Use create_grid only for empty, general-purpose grids unrelated to AEO.Input Parameters
Output
Create aeo persona
Create aeo persona
AIROPS_MCP_CREATE_AEO_PERSONACreate a new AEO persona on a Brand Kit. Personas represent the characters used to simulate AI-search queries when measuring AI visibility, citations, and mentions.Behavior:titlemust be unique within the Brand Kit (max 200 chars) anddescriptionis required (max 5000 chars).- Optional
add_to_all_prompts(defaultfalse): whentrue, the new persona is also assigned to every existing live prompt in the Brand Kit. This may incur additional answer credits/month; if the workspace’s estimated answers limit would be exceeded, the call is rejected with avalidation_errorcontainingestimated_answersandmax_answersindetails. Defaults tofalseso the agent does not silently incur credits.
add_to_all_prompts is on) and get explicit confirmation before calling. You can verify the persona was created by calling list_personas sorted by created_at descending.Input Parameters
Output
Create aeo prompt
Create aeo prompt
AIROPS_MCP_CREATE_AEO_PROMPTCreate a new AEO prompt for a Brand Kit. Prompts are questions that can be asked about a brand to AI search engines, used to track AI visibility and citations.After creation, background jobs automatically analyze the prompt on search engines, extract keywords, and compute volume metrics.You can optionally assign countries, personas, and platforms to the prompt at creation time. The workspace’s estimated answers limit is enforced — if the assignments would push the workspace over its quota, creation is rejected.IMPORTANT: Always show the user exactly which fields you plan to use (text, topic_id, and any assignments) and ask for their confirmation before calling this tool. User confirmation is mandatory. You can verify the prompt was created by calling list_aeo_prompts sorted by created_at descending.A topic_id is required. If the user hasn’t specified a topic, use the list_topics tool first to discover available topics and either suggest one or ask the user to choose.Input Parameters
list_topics to discover available topics and either suggest one or ask the user to choose.list_personas to discover available personas.Output
Create aeo tag
Create aeo tag
AIROPS_MCP_CREATE_AEO_TAGCreate a new AEO tag on a Brand Kit. Tags are user-defined labels that can be applied to prompts via bulk_update_aeo_prompt_tags.Behavior:namemust be unique within the Brand Kit (case-insensitive). The model enforces this via a unique index on (brand_kit_id, lower(name)).coloris optional. If omitted, a color is auto-assigned from the platform palette. Valid colors: light_grey, grey, green, teal, blue, purple, lilac, pink, red, coral, orange.- This tool does NOT apply the new tag to any prompts. Use
bulk_update_aeo_prompt_tagswithoperation: 'add'to assign it afterward.
list_tags filtered by name.Input Parameters
Output
Create brand kit direct upload
Create brand kit direct upload
AIROPS_MCP_CREATE_BRAND_KIT_DIRECT_UPLOADInitiate a direct file upload for use with Brand Kit visual tools.This returns an upload URL (pointing directly to the storage service), upload headers, and a signed_id. The workflow is:- Call this tool with the Brand Kit ID and file metadata (filename, content_type, byte_size, checksum). The checksum must be the Base64-encoded MD5 digest of the file contents.
- Upload the file to the returned
upload_urlusing an HTTP PUT with all the providedupload_headers. No additional authentication is needed — the URL is a time-limited presigned URL. Example: curl -X PUT -H “Content-Type: <type>” -H “Content-MD5: <checksum>” —upload-file <path> “<upload_url>” - Pass the returned
signed_idto a manage tool (e.g. manage_brand_kit_logo_variant, manage_brand_kit_visual_example, or manage_brand_kit_font).
Input Parameters
Output
Create brand kit recap entry
Create brand kit recap entry
AIROPS_MCP_CREATE_BRAND_KIT_RECAP_ENTRYRecord a recap entry summarizing the changes you made to a Brand Kit.Call this once, near the end of a session that mutated the Brand Kit draft — not for every edit. Do not call this tool if you made no Brand Kit draft mutations this session (for example, you only read the Brand Kit, suggested edits the user rejected, or worked on Playbooks, Campaigns, or Insights). Never create a recap that says nothing changed. Put the evidence behind the changes in body_markdown: verbatim quotes, source URLs, and pages.Example: create_brand_kit_recap_entry( brand_kit_id: 123, title: “Refreshed tone & voice and added 2 regions”, body_markdown: “Made the tone more concise per the latest brand guidelines (https://acme.com/brand). Added US East and US West to support the Q3 launch.” )Input Parameters
Output
Create grid
Create grid
AIROPS_MCP_CREATE_GRIDCreate a new empty, general-purpose grid with the given name. The grid is created with a single empty sheet (zero rows, zero columns). Use add_grid_column to add columns and write_grid to add rows. If the user belongs to more than one workspace, workspace_id is required. Do not use this tool to act on AEO insights — use create_action_grid instead, which pre-populates power step columns and rows for a given AEO action type.Input Parameters
Output
Create grid sheet
Create grid sheet
Create opportunity
Create opportunity
AIROPS_MCP_CREATE_OPPORTUNITYCreate one pending opportunity for a Campaign. In interactive Quill or OAuth sessions, summarize the proposed name, description, and target resources and get explicit confirmation first. Campaign strategy Playbooks infer their own Campaign. Other Playbooks must provide play_id, inspect existing Opportunities before creating more, and may create pending Opportunities without interactive confirmation when the Campaign write feature is enabled. For page_refresh and page_creation Campaigns, read the matching Opportunity rationale skill and pass its complete Markdown brief unchanged in description.Input Parameters
Output
Create page
Create page
AIROPS_MCP_CREATE_PAGEAdd a web page to a Brand Kit’s AEO pages. The URL is normalized before the page is created, and the page is associated with the Brand Kit’s configured AEO domain.The URL must be unique within the Brand Kit.IMPORTANT: Always show the user the URL and Brand Kit you plan to use and get explicit confirmation before calling this tool. You can verify the page was created by calling list_pages filtered by URL.Input Parameters
Output
Create topic
Create topic
AIROPS_MCP_CREATE_TOPICCreate a new AEO topic on a Brand Kit. Topics are categories used to group AEO prompts.Behavior:namemust be unique within the Brand Kit.coloris optional. If omitted, a color is auto-assigned from the platform palette. Valid colors: light_grey, grey, green, teal, blue, purple, lilac, pink, red, coral, orange.- This tool does NOT create or assign prompts. Use
create_aeo_promptwith the returned topic ID to add prompts to the topic.
list_topics filtered by name.Input Parameters
Output
Delete aeo prompt
Delete aeo prompt
AIROPS_MCP_DELETE_AEO_PROMPTDelete an AEO prompt from a Brand Kit.Use list_aeo_prompts to find the prompt ID and verify the prompt text before deletion.IMPORTANT: This action is destructive. Always show the user the exact prompt text and get explicit confirmation before calling this tool.Input Parameters
Output
Delete aeo tag
Delete aeo tag
AIROPS_MCP_DELETE_AEO_TAGDelete an AEO tag from a Brand Kit.Behavior:- This is a HARD delete. The tag is removed from the Brand Kit entirely.
- All taggings on prompts that referenced this tag are also deleted (cascade via
Aeo::Tag has_many :taggings, dependent: :destroy). Every prompt that had this tag will lose it. - The response includes
tagged_prompts_count: the number of prompts that lost the tag. Use this to communicate the blast radius back to the user.
tagged_prompts_count (look it up first via list_tags + list_aeo_prompts if needed) and get explicit confirmation before calling.Input Parameters
Output
Delete brand kit writing rules
Delete brand kit writing rules
AIROPS_MCP_DELETE_BRAND_KIT_WRITING_RULESDelete one or more writing rules from a Brand Kit. This edits the Brand Kit draft version only; it does not change the active (live) version.A failure deleting one rule does not block or roll back the others: the response reports which rules were deleted and which could not be.IMPORTANT: Always show the user exactly which writing rules will be deleted and ask for confirmation before calling this tool.Input Parameters
Output
Delete grid column
Delete grid column
Delete topic
Delete topic
AIROPS_MCP_DELETE_TOPICDelete an AEO topic from a Brand Kit.Behavior:- This is a HARD delete. The topic is removed from the Brand Kit entirely.
- Deletion is blocked when the topic has associated prompts. Use
list_aeo_promptsfiltered bytopic_idto inspect prompts before deleting. - Candidate questions and question recommendations for the topic are deleted by model associations when the topic is deleted.
Input Parameters
Output
Discard aeo prompt assignments
Discard aeo prompt assignments
AIROPS_MCP_DISCARD_AEO_PROMPT_ASSIGNMENTSDiscard the current prompt-assignment draft for a Brand Kit. Throws away ALL uncommitted edits — both your own and any unsaved edits the human user made in the UI — and re-mirrors a fresh empty draft from live.Live assignments are never touched.IMPORTANT:- This action is destructive and unrecoverable. Pending UI edits the user has not committed will be lost.
- Always get explicit user confirmation before calling.
- Calling discard when no draft exists is a no-op; a fresh empty draft is still created so further
update_aeo_prompt_assignmentscalls work without setup.
Input Parameters
Output
Get aeo ad
Get aeo ad
AIROPS_MCP_GET_AEO_ADGet one ad observed in ChatGPT answers. The ‘id’ parameter is the observed_creative_id returned by list_aeo_ads.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - topic_id (EQ, IN): Filter by the topic IDs of the prompts the ad was observed under. An ad observed under several topics is returned for each of them. - prompt_id (EQ, IN): Filter by the prompt IDs the ad was observed under - brand_mentioned (EQUALS): Filter by prompt query type: brand or categoryOutput
Get aeo citation
Get aeo citation
AIROPS_MCP_GET_AEO_CITATIONGet prompts citing a specific URL. The ‘id’ parameter is the URL to look up.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - domain_category (EQUALS, IN): Filter by domain category - domain_id (EQ, IN): Filter by domain ID - topic_id (EQ, IN): Filter by topic ID - brand_mentioned (EQUALS): Filter by query type: brand or category - page_type (EQUALS): Filter by page type - brand_referenced (EQ): Filter by whether brand is referenced on the citing page - brand_sentiment (EQUALS): Filter by brand sentiment - mentioned_competitor_domains (IN): Filter by competitor domain IDs mentioned on the citing page - url (CONTAINS): Filter by case-insensitive substring match on the citation URL. Matches against the normalized URL (without scheme or www).Output
Get aeo page content update
Get aeo page content update
AIROPS_MCP_GET_AEO_PAGE_CONTENT_UPDATEGet a specific page content update by ID. Its change_detection object carries the detection status and categories, plus a nested changes array (the before/after diff) on this single-update fetch. Track content updates.Input Parameters
changes array (the before/after diff). Null when change detection has not run for the update, including workspaces where it is not enabled.writing_rules.text) filter within an included association and require that association in includes. Available fields: - url (EQUALS, CONTAINS): Filter by content update URL - type (EQ, IN): Filter by content update type - source (EQ, IN): Filter by content update source - brand_kit_id (EQ): Filter by Brand Kit ID - created_at (GT, LT, GEQ, LEQ): Filter by creation date - has_changes (EQ): Filter to content updates where change detection found at least one confirmed change (true) or found none / has no detection run (false)Output
Get aeo prompt assignments status
Get aeo prompt assignments status
AIROPS_MCP_GET_AEO_PROMPT_ASSIGNMENTS_STATUSInspect the current prompt-assignment draft state for a Brand Kit without modifying anything. Read-only.This is the authoritative source for workspace estimated-answers numbers (live and draft). Call it whenever you need them — never compute or guess them yourself. In particular:- At the start of a session, to detect a pre-existing draft from unsaved UI edits.
- Immediately after
commit_aeo_prompt_assignments, to read the new liveestimated_answers— the commit tool does not return them. - Before staging more changes via
update_aeo_prompt_assignments, to compare againstmax_answers.
has_draft: whether a draft session exists for this brand kit.has_changes: whether the draft has uncommitted edits relative to live (null if no draft).draft_id: the draft’s ID (null if no draft).live_estimated_answers: current workspace estimated answers/month based on live assignments.draft_estimated_answers: what the workspace estimated answers/month would be if the draft were committed now (null if no draft).max_answers: the workspace’s effective answers limit.limit_exceeded: whether committing the draft now would exceed the limit (false if no draft).
Input Parameters
Output
Get answer
Get answer
AIROPS_MCP_GET_ANSWERGet a specific AI answer by ID with full text content. Get a single AI answer with full details. Use this to retrieve the complete answer text (not truncated), citations, and mentions. Use includes parameter to get citations, mentions, and persona details.Input Parameters
Output
Get brand kit
Get brand kit
AIROPS_MCP_GET_BRAND_KITFetch a Brand Kit’s brand identity (writing_tone, writing_persona) and associated entities (product lines, audiences, content types, regions, writing rules, custom variables, visual/design assets). Call AFTER list_brand_kits confirms brand_management_enabled: true.Decision flow
- Specific entity by ID →
includes=["<type>"],filters=[{field: "<type>.id", operator: "EQ", value: <id>}]. - Entity by name (product_lines, content_types, audiences, regions, custom_variables, visual_examples) →
filters=[{field: "<type>.name", operator: "CONTAINS", value: "<fragment>"}]. - Find text content (“rule about tone”, “any mention of Red List”) → filter by the text field:
filters=[{field: "writing_rules.text", operator: "CONTAINS", value: "tone"}]. - Structural discovery → small
includeswithfields=["<type>.id","<type>.name"]only.
Scale (typical kit vs outliers)
Most kits are small — these rarely need filtering:- audiences, regions, usage_rules, palettes, content_samples: usually 0-2, rarely >10
- content_types, product_lines: usually 1-3
- writing_rules: usually 3, outliers exceed 200. Never include in full without a filter — filter by text (CONTAINS) or by id.
- competitors: usually 10, outliers exceed 250. Include via product_lines.competitors only when needed, and consider a name filter.
- custom_variables: outliers exceed 150. Filter by name (CONTAINS) for known variables (e.g. “Red List”), or by value (CONTAINS) for content.
- Scoped writing_rules via audience/region/content_type nesting: outliers exceed 200. Filter the parent by id or name first.
Writing rules — global vs scoped
Writing rules are EITHER global OR scoped to a single audience/content_type/region (never both). For content targeting a specific audience/region/content_type, fetch BOTH:- Top-level
writing_rulesinclude → global rules. - Nested writing_rules on the scoping parent → scoped rules. Merge client-side.
Anti-patterns
includes=["writing_rules","custom_variables","product_lines.competitors", "content_types.writing_rules"]without filters → blows context on outlier kits.- Calling without
fieldson a large kit → returns full text (template_outline, rule text, ICP) for every row. - Forgetting filters on
writing_rules,custom_variables, orcompetitors— those are the three biggest tails.
Versioning
version: "draft" reads pending edits; defaults to "active". Use active for on-brand output unless the user explicitly asks for draft.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - workspace_name (EQUALS, CONTAINS): Filter by workspace name - brand_name (EQUALS, CONTAINS): Filter by brand name - brand_url (EQUALS, CONTAINS): Filter by brand URL - status (EQUALS, IN): Filter by Brand Kit status - created_at (EQ, GT, LT, GEQ, LEQ): Filter by creation date - product_lines.id (EQ, IN): Filter by product line ID - product_lines.name (EQUALS, CONTAINS): Filter by product line name - product_lines.details (CONTAINS): Find product lines whose details contain a substring - product_lines.positioning (CONTAINS): Find product lines whose positioning contains a substring - product_lines.ideal_customer_profile (CONTAINS): Find product lines whose ICP contains a substring - audiences.id (EQ, IN): Filter by audience ID - audiences.name (EQUALS, CONTAINS): Filter by audience name - content_types.id (EQ, IN): Filter by content type ID - content_types.name (EQUALS, CONTAINS): Filter by content type name - content_types.template_outline (CONTAINS): Find content types whose template_outline contains a substring - regions.id (EQ, IN): Filter by region ID - regions.name (EQUALS, CONTAINS): Filter by region name - writing_rules.id (EQ, IN): Filter by writing rule ID - writing_rules.text (CONTAINS): Find writing rules containing a substring (case-insensitive) - custom_variables.id (EQ, IN): Filter by custom variable ID - custom_variables.name (EQUALS, CONTAINS): Filter by custom variable name (e.g. “Red List”) - custom_variables.value (CONTAINS): Find custom variables whose value contains a substring - logo_variants.id (EQ, IN): Filter by logo variant ID - logo_variants.name (EQUALS, CONTAINS): Filter by logo variant name - logo_sizes.id (EQ, IN): Filter by logo size ID - logo_sizes.name (EQUALS, CONTAINS): Filter by logo size name - usage_rules.id (EQ, IN): Filter by usage rule ID - usage_rules.applies_to (EQUALS, IN): Filter by category this rule applies to - usage_rules.name (CONTAINS): Find usage rules whose text contains a substring - palettes.id (EQ, IN): Filter by palette ID - palettes.name (EQUALS, CONTAINS): Filter by palette name - fonts.id (EQ, IN): Filter by font ID - fonts.name (EQUALS, CONTAINS): Filter by font name - type_sizes.id (EQ, IN): Filter by type size ID - type_sizes.font_id (EQ, IN): Filter by associated font ID - type_sizes.name (EQUALS, CONTAINS): Filter by type size name - visual_examples.id (EQ, IN): Filter by visual example ID - visual_examples.title (EQUALS, CONTAINS): Filter by visual example title - visual_use_cases.id (EQ, IN): Filter by visual use case ID - visual_use_cases.name (EQUALS, CONTAINS): Filter by visual use case nameOutput
Get campaign
Get campaign
AIROPS_MCP_GET_CAMPAIGNGet a campaign by ID, including action grid IDs needed to inspect or update its grid. Campaigns are Plays that coordinate strategy playbooks, action grids, and related opportunities for improving AEO performance.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - name (EQUALS, CONTAINS): Filter by campaign name - status (EQUALS, IN): Filter by campaign status - workspace_id (EQ, IN): Filter by workspace ID - brand_kit_id (EQ, IN): Filter by Brand Kit ID - resource_type (EQUALS, IN): Filter by campaign resource typeOutput
Get insights settings
Get insights settings
AIROPS_MCP_GET_INSIGHTS_SETTINGSGet AEO insights configuration for a Brand Kit, this includes the relevant information to use any AEO and analytics tools. Returns competitors, personas, prompt count, and other relevant information. Use list_brand_kits first to find Brand Kits with aeo_enabled: true.Input Parameters
Output
Get page details
Get page details
AIROPS_MCP_GET_PAGE_DETAILSGet AEO metrics for a specific web page. Page details include citation share, citation rate, unique cited questions count, and Google Search Console metrics (clicks, impressions, position, CTR) with trends.Input Parameters
Output
Get page prompts
Get page prompts
AIROPS_MCP_GET_PAGE_PROMPTSGet prompts citing a specific web page. Returns AI prompts that cite the page along with citation metrics (citation_rate, mention_rate) and trends. Use includes: [“topic”] to get topic details for each prompt.Prompts are the questions that can be asked about a brand or web page. They are the search queries that are used to get AI answers with citations and mentions.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - topic.name (EQUALS, CONTAINS): Filter by topic nameOutput
Get prompt answers
Get prompt answers
AIROPS_MCP_GET_PROMPT_ANSWERSGet AI answers for a specific prompt/question. Prompt answers are the AI answers for a specific question/prompt asked to multiple AI providers and the answers are aggregated. The answers include whether the brand was mentioned and cited in the answer. To get full answer text, citations, and mentions, use the get_answer tool with the answer ID.Input Parameters
Output
Get report
Get report
AIROPS_MCP_GET_REPORTGet a specific report by ID with its module configurations. Reports are saved analytics views for a Brand Kit. They contain modules that display different analytics metrics.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - name (EQUALS, CONTAINS): Filter by report nameOutput
Get sentiment theme answers
Get sentiment theme answers
AIROPS_MCP_GET_SENTIMENT_THEME_ANSWERSGet individual AI answers with sentiment details for a specific theme. Returns answer text, sentiment (positive/neutral/negative), confidence score, and provider. Use this to understand WHY a theme has a particular sentiment score. Today’s data is still being processed — always use yesterday (2026-09-09) or earlier as end_date.Input Parameters
Output
Knowledge base add file
Knowledge base add file
AIROPS_MCP_KNOWLEDGE_BASE_ADD_FILEStep 2 of the two-step file ingestion flow for a Knowledge Base. Consumes a signed_id returned by knowledge_base_create_direct_upload (step 1) plus the file’s metadata, and registers the document with the Knowledge Base. Returns immediately with the new document_id in pending status — poll knowledge_base_get_status to monitor indexing.Workflow:- Call
knowledge_base_create_direct_uploadwith the file metadata to get back asigned_idand a presignedupload_url. - PUT the file bytes to the
upload_urlwith the provided headers. - Call this tool with the
signed_id, the desiredname(used as the document’s display name), thedocument_typeMIME (must match the supported types), and an optionalmetadatahash.
metadata hash, if provided, is a single-level key/value object. It replaces any existing metadata on the document (no merge) and is filterable at search time via search_knowledge_base.Input Parameters
search_knowledge_base.content_type passed to knowledge_base_create_direct_upload, but may intentionally differ to select a different loader (e.g. registering a text/csv blob as text/plain to bypass CSV-specific parsing).Output
Knowledge base add urls
Knowledge base add urls
AIROPS_MCP_KNOWLEDGE_BASE_ADD_URLSBulk-ingest one or more web pages into a Knowledge Base. Each URL becomes a separate document that fetches and indexes asynchronously. The call returns immediately with the new document IDs in pending state — poll knowledge_base_get_status to check progress.URLs must be absolute and include the http:// or https:// scheme (e.g. https://example.com/page). No documents are created if any URL fails validation.The metadata hash, if provided, is applied identically to every document in the batch (single-level keys only); it replaces (not merges) any existing metadata and is filterable at search time.Input Parameters
http:// or https:// (e.g. https://example.com/page). Each URL becomes its own document. Bare hostnames without a scheme are rejected.Output
Knowledge base create direct upload
Knowledge base create direct upload
AIROPS_MCP_KNOWLEDGE_BASE_CREATE_DIRECT_UPLOADInitiate a direct file upload for a Knowledge Base. Returns a presigned S3 upload URL, the required upload headers, and a signed_id you’ll use with knowledge_base_add_file to register the document.This is the first call in the two-step file ingestion flow — large files (PDFs, DOCX, MD, HTML, etc.) don’t fit through the MCP transport, so the file bytes go directly from your client to S3.Workflow:- Call this tool with the file metadata (filename, content_type, byte_size, checksum). The checksum must be the Base64-encoded MD5 digest of the file contents.
- PUT the raw file bytes to the returned
upload_urlwith all the providedupload_headers. No additional authentication is needed — the URL is a time-limited presigned URL. - Pass the returned
signed_idtoknowledge_base_add_fileto register the document. Only after step 3 is the file searchable.
→ { signed_id: “abc…”, upload_url: “https://s3…”, upload_headers: { … } }
> knowledge_base_add_file(knowledge_base_id: 1, signed_id: “abc…”, name: “Q4 Report”, document_type: “application/pdf”)→ { document_ids: [42], status: “pending” }
Maximum file size is 256 MB.Input Parameters
Output
Knowledge base delete
Knowledge base delete
AIROPS_MCP_KNOWLEDGE_BASE_DELETEPermanently delete a Knowledge Base and ALL of its documents. This cascades through every document in the KB and drops the underlying vectors. This action cannot be undone.IMPORTANT: Always warn the user that deletion is permanent and irreversible, name the Knowledge Base being deleted, and ask for explicit confirmation before calling this tool.Input Parameters
Output
Knowledge base delete document
Knowledge base delete document
Knowledge base get document
Knowledge base get document
AIROPS_MCP_KNOWLEDGE_BASE_GET_DOCUMENTRead the full reconstructed text content of a Knowledge Base document end-to-end — the loader-extracted text from every chunk concatenated in position order.Use when chunked search results aren’t enough: summarizing a whole document, answering questions across an entire report, or reading back a doc before delete-and-recreate. For finding specific passages, prefer search_knowledge_base.Returns up to max_chars characters starting at offset (defaults to 0 and 200000). When the document is larger than the slice, the response includes next_offset (the value to pass on the next call to continue reading); when fully read, next_offset is null.For documents still indexing (status: pending) or in error (status: error), content may be empty — check status first.Content is reconstructed by joining chunks; minor overlap or duplication between adjacent chunks is possible depending on the original loader’s chunking strategy. For the original source file, use the existing download path outside MCP.Input Parameters
next_offset from a previous call to paginate.next_offset.Output
Knowledge base get status
Knowledge base get status
AIROPS_MCP_KNOWLEDGE_BASE_GET_STATUSGet the indexing status of a Knowledge Base and its documents. Returns a Knowledge Base–level rollup (status, pending and total document counts) plus a paginated list of per-document statuses. Use this to monitor indexing after writes — only documents with status “ready” are returned by search_knowledge_base. Pass the returned cursor back to fetch the next page; pass document_ids to filter to specific documents.Input Parameters
Output
Knowledge base manage
Knowledge base manage
AIROPS_MCP_KNOWLEDGE_BASE_MANAGECreate or update a Knowledge Base. Omit knowledge_base_id to create a new one; pass it to update an existing one. On create, name is required; pass workspace_id if you have access to more than one workspace. On update, only the fields you pass change.Input Parameters
Output
Knowledge base update document metadata
Knowledge base update document metadata
AIROPS_MCP_KNOWLEDGE_BASE_UPDATE_DOCUMENT_METADATAReplace a document’s user-facing metadata in full. Accepts a single-level hash that replaces (not merges) the existing user-facing metadata. To remove a key, pass the full new hash that omits it. To clear all metadata, pass {}. Filterable at search time via search_knowledge_base.Metadata-only — does not re-embed the document. Loader-derived metadata (scraped page metadata for URLs, chunker metadata for files) is not touched. Search filters may take a few seconds to reflect the new values.The document must be fully indexed (status: ready) before calling this tool. If indexing isn’t complete, the tool returns a validation error.Input Parameters
Output
List aeo ads
List aeo ads
AIROPS_MCP_LIST_AEO_ADSList ads observed in ChatGPT answers for a Brand Kit. Ads observed by AirOps in collected ChatGPT answers. Rows are unique ads: observations sharing the same normalized creative are grouped into one, with appearance counts describing how often that ad was observed. Covers ads AirOps has seen in its own answer collection, so it does not describe full market coverage, targeting intent, impression delivery, or advertiser spend.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - topic_id (EQ, IN): Filter by the topic IDs of the prompts the ad was observed under. An ad observed under several topics is returned for each of them. - prompt_id (EQ, IN): Filter by the prompt IDs the ad was observed under - brand_mentioned (EQUALS): Filter by prompt query type: brand or categoryOutput
List aeo advertisers
List aeo advertisers
AIROPS_MCP_LIST_AEO_ADVERTISERSList advertisers observed in ChatGPT answers for a Brand Kit. Advertisers observed by AirOps in collected ChatGPT answers. Rows roll up every observed ad to the advertiser that ran it, identified by canonical domain. Covers ads AirOps has seen in its own answer collection, so it does not describe full market coverage, targeting intent, impression delivery, or advertiser spend. Use list_aeo_ads for the individual ads behind these counts.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - topic_id (EQ, IN): Filter by the topic IDs of the prompts the advertiser was observed under - prompt_id (EQ, IN): Filter by the prompt IDs the advertiser was observed under - brand_mentioned (EQUALS): Filter by prompt query type: brand or categoryOutput
List aeo citations
List aeo citations
AIROPS_MCP_LIST_AEO_CITATIONSList citations (URLs) with metrics for a Brand Kit. Citations (URLs) with detailed metrics including influence score. Shows individual URLs being cited in AI answers with page-level context.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - domain_category (EQUALS, IN): Filter by domain category - domain_id (EQ, IN): Filter by domain ID - topic_id (EQ, IN): Filter by topic ID - brand_mentioned (EQUALS): Filter by query type: brand or category - page_type (EQUALS): Filter by page type - brand_referenced (EQ): Filter by whether brand is referenced on the citing page - brand_sentiment (EQUALS): Filter by brand sentiment - mentioned_competitor_domains (IN): Filter by competitor domain IDs mentioned on the citing page - url (CONTAINS): Filter by case-insensitive substring match on the citation URL. Matches against the normalized URL (without scheme or www).Output
List aeo domains
List aeo domains
AIROPS_MCP_LIST_AEO_DOMAINSList domains cited in AI answers for a Brand Kit. Cited domains aggregated by domain with citation metrics. Shows which domains are being cited in AI answers for a Brand Kit.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - domain_category (EQUALS, IN): Filter by domain category - topic_id (EQ, IN): Filter by topic ID - brand_mentioned (EQUALS): Filter by query type: brand or category - page_type (EQUALS): Filter by page type - brand_referenced (EQ): Filter by whether brand is referenced on the citing page - brand_sentiment (EQUALS): Filter by brand sentiment on the citing page - domain_name (CONTAINS): Filter by case-insensitive substring match on the domain name.Output
List aeo page content updates
List aeo page content updates
AIROPS_MCP_LIST_AEO_PAGE_CONTENT_UPDATESList page content updates for a workspace. Track content updates.Input Parameters
changes array (the before/after diff). Null when change detection has not run for the update, including workspaces where it is not enabled.writing_rules.text) filter within an included association and require that association in includes. Available fields: - url (EQUALS, CONTAINS): Filter by content update URL - type (EQ, IN): Filter by content update type - source (EQ, IN): Filter by content update source - brand_kit_id (EQ): Filter by Brand Kit ID - created_at (GT, LT, GEQ, LEQ): Filter by creation date - has_changes (EQ): Filter to content updates where change detection found at least one confirmed change (true) or found none / has no detection run (false)Output
List aeo prompts
List aeo prompts
AIROPS_MCP_LIST_AEO_PROMPTSList AEO prompts for a specific Brand Kit. Questions are the AI prompts that can be asked about a brand. They are used to get AI answers with citations and mentions.Input Parameters
list_personas to resolve to titles. - platforms: AI platforms currently assigned to the prompt (live). - est_answers_mo: Estimated monthly answer credits this prompt will consume given its current live country, persona, and platform assignments.writing_rules.text) filter within an included association and require that association in includes. Available fields: - text (EQUALS, CONTAINS): Filter by prompt text - strategy (EQ, IN): Filter by strategy: 0 = manual, 1 = deep_research - brand_mentioned (EQ): Filter by whether brand is mentioned - topic_id (EQ, IN): Filter by topic ID - prompt_volume (EQUALS, IN): Filter by prompt volume level - mention_rate (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by mention rate percentage (0-100) - positive_answer_rate (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by positive answer rate percentage (0-100) - citation_rate (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by citation rate percentage (0-100) - country (EQ, IN): Filter prompts by an assigned country (ISO alpha-2). EQ matches a single code; IN matches any in the list. - persona_id (EQ, IN): Filter prompts by an assigned persona ID. Use list_personas to discover persona IDs. - platform (EQ, IN): Filter prompts by an assigned AI platform.Output
List answers
List answers
AIROPS_MCP_LIST_ANSWERSList AI answers for a brand kit with filters for date range, providers, countries, prompt_id, and brand_mentioned. Individual AI answers with their cited URLs and brand/competitor mentions.Input Parameters
Output
List brand kits
List brand kits
AIROPS_MCP_LIST_BRAND_KITSList all Brand Kits the user has access to. Returns brand_management_enabled and aeo_enabled flags for each brand kit. Use get_brand_kit for brand management details, or get_insights_settings for AEO configuration. Optionally filter by workspace_name, workspace_id, brand_management_enabled, or aeo_enabled. IMPORTANT: If multiple brand kits are returned and the user has not specified which one to use, present the list and ask them to confirm. Do NOT arbitrarily pick one.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - workspace_name (EQUALS, CONTAINS): Filter by workspace name - brand_name (EQUALS, CONTAINS): Filter by brand name - brand_url (EQUALS, CONTAINS): Filter by brand URL - brand_management_enabled (EQ): Filter by whether the Brand Kit is enabled for brand management - aeo_enabled (EQ): Filter by whether AEO analytics data is availableOutput
List campaigns
List campaigns
AIROPS_MCP_LIST_CAMPAIGNSList campaigns the authenticated user has access to. Use get_campaign to retrieve action grid IDs and custom instructions for a campaign. Campaigns are Plays that coordinate strategy playbooks, action grids, and related opportunities for improving AEO performance.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - name (EQUALS, CONTAINS): Filter by campaign name - status (EQUALS, IN): Filter by campaign status - workspace_id (EQ, IN): Filter by workspace ID - brand_kit_id (EQ, IN): Filter by Brand Kit ID - resource_type (EQUALS, IN): Filter by campaign resource typeOutput
List grids
List grids
AIROPS_MCP_LIST_GRIDSList grids the authenticated user has access to. Use includes=[“grid_tables.grid_columns”] to get table and column structure needed for read_grid and write_grid calls. Grids are spreadsheet-like tables for organizing and processing data. Each grid contains one or more tables (sheets), and each table has columns and rows. Use includes to retrieve table and column structure needed for read_grid and write_grid calls.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - name (EQUALS, CONTAINS): Filter by grid name - workspace_id (EQ): Filter by workspace IDOutput
List knowledge bases
List knowledge bases
AIROPS_MCP_LIST_KNOWLEDGE_BASESList all Knowledge Bases the authenticated user has access to. Knowledge Bases store documents for semantic search. Use the status field to determine if a Knowledge Base is searchable (status: “ready”).Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - workspace_name (EQUALS, CONTAINS): Filter by workspace name - name (EQUALS, CONTAINS): Filter by Knowledge Base name. Use EQUALS for exact match, CONTAINS for partial. - workspace_id (EQ): Filter by workspace ID to list Knowledge Bases from a specific workspace.Output
List opportunities
List opportunities
List pages
List pages
AIROPS_MCP_LIST_PAGESList web pages with daily metrics (AEO citations, GSC clicks/impressions, GA4 traffic, and configured GA4 key events) for a brand kit. Supports filtering by metrics and text fields, sorting, and pagination.Web page metrics are the daily metrics of citations, clicks, impressions, traffic, and configured GA4 key events for a specific web page.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - clicks (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by GSC clicks count - impressions (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by GSC impressions count - ctr (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by click-through rate - position (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by average search position - citations_count (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by citation count - citation_rate (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by citation rate - prompts_count (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by prompts count - traffic (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by GA4 traffic - sessions (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by GA4 sessions - engagement (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by GA4 engaged sessions - average_session_engagement (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by average session duration - clicks_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by clicks change percentage - impressions_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by impressions change percentage - ctr_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by CTR change - position_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by position change percentage - citations_count_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by citations change percentage - citation_rate_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by citation rate change - prompts_count_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by prompts count change - traffic_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by traffic change percentage - sessions_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by sessions change percentage - engagement_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by engagement change percentage - average_session_engagement_diff (EQ, NEQ, GT, LT, GEQ, LEQ): Filter by average session duration change - last_refreshed_at (LEQ): Filter by pages last refreshed before a preset window. Valid values: 1m, 3m, 6m, 1y. - url (EQUALS, CONTAINS, STARTS_WITH, IN): Filter by page URL. Use CONTAINS for partial match. - folder_name (EQUALS, CONTAINS, STARTS_WITH, IN): Filter by folder/section name - primary_keyword (EQUALS, CONTAINS, STARTS_WITH, IN): Filter by primary keyword - session_source (EQUALS, CONTAINS, STARTS_WITH, IN): Filter by GA4 session source. Valid values: (direct), google, chatgpt.com, perplexity.ai, perplexity, reddit.com, gemini.google.com, youtube.com, linkedin, linkedin.com, lnkd.in, bing, claude.ai - session_medium (EQUALS, CONTAINS, STARTS_WITH, IN): Filter by GA4 session medium. Valid values: organic, cpc, email, social, direct, referral - tracked (EQ): Filter by tracked statusOutput
List personas
List personas
AIROPS_MCP_LIST_PERSONASList personas for a specific Brand Kit. Personas are the characters that can be used to ask questions about a brand. They are used to get AI answers with citations and mentions.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - title (EQUALS, CONTAINS): Filter by persona titleOutput
List reports
List reports
AIROPS_MCP_LIST_REPORTSList saved analytics reports for a specific Brand Kit. Reports are saved analytics views for a Brand Kit. They contain modules that display different analytics metrics.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - name (EQUALS, CONTAINS): Filter by report nameOutput
List topics
List topics
AIROPS_MCP_LIST_TOPICSList topics for a specific Brand Kit. Topics are the categories of questions that can be asked about a Brand Kit. They are used to group questions together and to create a taxonomy of questions.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - name (EQUALS, CONTAINS): Filter by topic nameOutput
List workspaces
List workspaces
AIROPS_MCP_LIST_WORKSPACESList all workspaces the authenticated user has access to. Workspaces are the top-level container for all resources in the AirOps platform. A user can have multiple workspaces, and each workspace can have multiple resources like Brand Kits, Pages, Prompts, etc.Input Parameters
writing_rules.text) filter within an included association and require that association in includes. Available fields: - name (EQUALS, CONTAINS): Filter by workspace name. Use EQUALS for exact match, CONTAINS for partial. - tier (EQ, IN): Filter by subscription tier. Use EQ for single tier, IN for multiple.Output
Manage brand kit audience
Manage brand kit audience
AIROPS_MCP_MANAGE_BRAND_KIT_AUDIENCECreate or update an audience for a Brand Kit draft. Omit id to create a new audience; provide id to update an existing one. On update, only provided fields are changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit competitor
Manage brand kit competitor
AIROPS_MCP_MANAGE_BRAND_KIT_COMPETITORCreate or update a competitor for a Brand Kit. Omit id to create a new competitor; provide id to update an existing one. On update, only provided fields are changed. Competitors must be associated with at least one product line from the same brand kit. This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit content sample
Manage brand kit content sample
AIROPS_MCP_MANAGE_BRAND_KIT_CONTENT_SAMPLECreate or update a content sample for a Brand Kit. Omit id to create a new content sample; provide id to update an existing one. On create, provide either url (content will be extracted asynchronously) or content (plain text, stored immediately). On update, only content, url, audience_ids, and region_ids can be changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit content type
Manage brand kit content type
AIROPS_MCP_MANAGE_BRAND_KIT_CONTENT_TYPECreate or update a content type for a Brand Kit. Omit id to create a new content type; provide id to update an existing one.On create, you may provide a sample_url to seed the content type with a content sample:- If only
sample_urlis provided (no content fields), the system will scrape the URL and use AI to generate all content type fields automatically. - If
sample_urlis provided along with content fields, the URL will be scraped for reference but the provided field values will be kept as-is. - If no
sample_urlis provided, the content type is created with the given fields only.
sample_url is ignored. This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit custom variable
Manage brand kit custom variable
AIROPS_MCP_MANAGE_BRAND_KIT_CUSTOM_VARIABLEBefore creating a custom variable, you MUST analyze the user’s intent and suggest the appropriate Brand Kit dimension instead. Map the request to these alternatives first:- Region + Writing Rule: For location/language-specific instructions (e.g., “US writing tone”, “UK spelling”)
- Audience + Writing Rule: For audience-specific guidelines (e.g., “developer tone”, “enterprise style”)
- Content Type: For format-specific rules (e.g., “blog post structure”, “email CTA”)
- Writing Rule (global): For general writing guidelines
- Writing Tone / Writing Persona: For overall voice and style
id to create a new custom variable; provide id to update an existing one. On create, name and value are required. On update, only provided fields are changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit font
Manage brand kit font
AIROPS_MCP_MANAGE_BRAND_KIT_FONTCreate or update a font for a Brand Kit. Omit id to create a new font; provide id to update an existing one. On update, only provided fields are changed.To attach a font file, either:- Use
signed_idwith the token from create_brand_kit_direct_upload after direct upload (preferred). - Use
file_urlwith a publicly accessible URL to a font file (TTF, OTF, WOFF, WOFF2, or EOT). Alternatively, providegoogle_font_linkwith a Google Fonts URL.
Input Parameters
Output
Manage brand kit logo size
Manage brand kit logo size
AIROPS_MCP_MANAGE_BRAND_KIT_LOGO_SIZECreate or update a logo size for a Brand Kit. Omit id to create a new logo size; provide id to update an existing one. On update, only provided fields are changed.At least one of width or height must be provided on create.This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit logo variant
Manage brand kit logo variant
AIROPS_MCP_MANAGE_BRAND_KIT_LOGO_VARIANTCreate or update a logo variant for a Brand Kit. Omit id to create a new logo variant; provide id to update an existing one. On update, only provided fields are changed.To attach a logo image, either:- Use
signed_idwith the token from create_brand_kit_direct_upload after direct upload (preferred). - Use
file_urlwith a publicly accessible URL to a PNG or SVG image.
usage_instructions when creating a logo variant — describe when and how to use this logo (e.g. “Primary logo for light backgrounds”, “Monochrome version for print materials”).This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit palette
Manage brand kit palette
AIROPS_MCP_MANAGE_BRAND_KIT_PALETTECreate or update a color palette for a Brand Kit. Omit id to create a new palette; provide id to update an existing one. On update, only provided fields are changed.This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit palette color
Manage brand kit palette color
AIROPS_MCP_MANAGE_BRAND_KIT_PALETTE_COLORCreate or update a color within a Brand Kit palette. Omit id to create a new color; provide id to update an existing one. On create, palette_id is required. On update, only provided fields are changed.This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit product line
Manage brand kit product line
AIROPS_MCP_MANAGE_BRAND_KIT_PRODUCT_LINECreate or update a product line for a Brand Kit. Omit id to create a new product line; provide id to update an existing one. On update, only provided fields are changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit region
Manage brand kit region
AIROPS_MCP_MANAGE_BRAND_KIT_REGIONCreate or update a region for a Brand Kit. Omit id to create a new region; provide id to update an existing one. On update, only provided fields are changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit type size
Manage brand kit type size
AIROPS_MCP_MANAGE_BRAND_KIT_TYPE_SIZECreate or update a type size for a Brand Kit. Omit id to create a new type size; provide id to update an existing one. On update, only provided fields are changed.This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit usage rule
Manage brand kit usage rule
AIROPS_MCP_MANAGE_BRAND_KIT_USAGE_RULECreate or update a usage rule for a Brand Kit. Omit id to create a new usage rule; provide id to update an existing one. On update, only provided fields are changed. applies_to is set on creation and cannot be changed.This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit visual example
Manage brand kit visual example
AIROPS_MCP_MANAGE_BRAND_KIT_VISUAL_EXAMPLECreate or update a visual example for a Brand Kit’s Data Visualization section. Omit id to create a new visual example; provide id to update an existing one. On update, only provided fields are changed.Visual examples must be grouped under a Visual Use Case — pass visual_use_case_id on create. Use manage_brand_kit_visual_use_case first if no use case exists yet.To attach an image, either:- Use
signed_idwith the token from create_brand_kit_direct_upload after direct upload (preferred). - Use
file_urlwith a publicly accessible URL to an image.
Input Parameters
manage_brand_kit_visual_use_case to create or list visual use cases on this brand kit.Output
Manage brand kit visual use case
Manage brand kit visual use case
AIROPS_MCP_MANAGE_BRAND_KIT_VISUAL_USE_CASECreate or update a Visual Use Case for a Brand Kit. A Visual Use Case is a named grouping of visual examples that share a common set of instructions for when and how to apply them (e.g., “Hero sections”, “Social posts”, “Email headers”).Omit id to create a new visual use case; provide id to update an existing one. On update, only provided fields are changed.This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Manage brand kit writing rule
Manage brand kit writing rule
AIROPS_MCP_MANAGE_BRAND_KIT_WRITING_RULECreate or update a writing rule for a Brand Kit. Omit id to create a new rule; provide id to update an existing one.Scoping: A rule can optionally be scoped to exactly one dimension — a single content type, audience, OR region. Provide at most one of content_type_id, audience_id, or region_id on create. They are mutually exclusive. A rule with no scoping is global (applies everywhere).Scoping is immutable: it is set on create only. On update, only text can be changed. This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be created or changed and ask for confirmation before calling this tool.Input Parameters
Output
Publish brand kit
Publish brand kit
Query analytics
Query analytics
AIROPS_MCP_QUERY_ANALYTICSQuery analytics data for a Brand Kit with flexible metrics, dimensions, and filters. Today’s data is still being processed — always use yesterday (2026-09-09) or earlier as end_date . “Use this to set appropriate date ranges when users ask about recent metrics without specifying dates. IMPORTANT: USE chart_image_url WHEN YOU NEED TO EMBED A CHART IN NOTION/GOOGLE DOCS, ETC.”Input Parameters
Output
Read grid
Read grid
AIROPS_MCP_READ_GRIDRead rows from a grid table. Returns rows as objects with column titles as keys. Use list_grids() to discover available grids and their table/column structure. Supports filtering by column values, selecting specific columns, and pagination. Returns up to 100 rows per page (default 50). Cell values are truncated to 500 characters by default (configurable up to 2000 via the truncate parameter); truncated values end with a marker showing their full length. Use read_grid_cell() to fetch the complete value of a specific cell. Playbook columns include active-version artifact metadata for mapping their outputs into playbook or workflow columns with add_grid_column().Input Parameters
Output
Read grid cell
Read grid cell
AIROPS_MCP_READ_GRID_CELLRead the full value of a single grid cell. read_grid() truncates cell values; use this tool when you need the complete content of one cell (e.g. a full article, brief, or HTML payload). Identify the cell via the row __id and column id returned by read_grid().Input Parameters
Output
Reject opportunity
Reject opportunity
AIROPS_MCP_REJECT_OPPORTUNITYReject pending opportunities for a campaign. For v2 campaigns, pass opportunity_ids; opportunity item selection and rejection reasons are v1-only. Before calling this tool, summarize the opportunities or opportunity items that will be rejected and get explicit user confirmation.Input Parameters
Output
Search knowledge base
Search knowledge base
Suggest brand kit edits
Suggest brand kit edits
AIROPS_MCP_SUGGEST_BRAND_KIT_EDITSSuggest edits to a Brand Kit’s fields without applying them. Returns a comparison of current vs suggested values for user review. The user will see a UI to accept or reject each suggestion before changes are applied.Only include fields you want to suggest changes for. Call this tool once per entity (e.g. once per audience, once per content type).Supported entity types and their fields:- brand_kit: brand_name, brand_url, brand_about, writing_persona, writing_tone
- audience: name, description
- content_type: name, template_outline, cta_text, cta_url, header_case, header_case_custom_value
- product_line: name, details, positioning, ideal_customer_profile, url
- region: name, description, icon_name (flag code in format flag-{iso2}, e.g. flag-us, flag-gb, flag-br)
- writing_rule: text, region_id (create only), content_type_id (create only), audience_id (create only)
- competitor: name, domain, details, product_line_ids
- content_sample: url (create only), content_type_id (create only), content (update only), audience_ids, region_ids
- custom_variable: name, value
- logo_variant: name, background_color, usage_instructions (to upload a logo image use manage_brand_kit_logo_variant directly with file_url)
- logo_size: name, width, height, usage_instructions
- font: name, usage_instructions, google_font_link, file_url (publicly accessible URL to a font file)
- type_size: name, weight, size, line_height, usage_instructions
- palette: name
Input Parameters
Output
Track aeo page content update
Track aeo page content update
AIROPS_MCP_TRACK_AEO_PAGE_CONTENT_UPDATETrack a page content update (publish/refresh) to correlate future analytics with content changes.Call this tool after a page is published or refreshed through a CMS (e.g. WordPress, Webflow, Contentful) or any MCP server that modifies page content. This lets AirOps correlate page performance metrics — AI visibility, citations, mentions — with specific content updates over time.The URL must match a domain configured in one of the workspace’s Brand Kits. If no matching Brand Kit domain is found, the content update cannot be created. If the URL matches multiple Brand Kits (for example regional variants sharing a domain), a content update is created for each, routed by the most specific brand_url path (e.g. “https://example.com/es/post” maps to the Brand Kit whose brand_url is “https://example.com/es/”).IMPORTANT: Always show the user exactly which fields you plan to use (url, type, source) and ask for their confirmation before calling this tool. User confirmation is mandatory.Input Parameters
Output
Update aeo prompt assignments
Update aeo prompt assignments
AIROPS_MCP_UPDATE_AEO_PROMPT_ASSIGNMENTSUpdate the country, persona, and platform assignments of one or more existing AEO prompts on a Brand Kit. Writes to the brand kit’s draft session ONLY — changes do NOT take effect until you call commit_aeo_prompt_assignments.Semantics:- For each entry in
prompts, a non-empty array REPLACES that prompt’s current draft assignments for the given dimension. - An empty array CLEARS that dimension on the prompt.
- Omitting a dimension or passing null leaves that dimension UNCHANGED.
- At most 100 prompts can be updated per call.
- Call
update_aeo_prompt_assignmentsto stage your changes in the draft. - Inspect
limit_exceededin the response. If true, the workspace would exceed its estimated-answers quota on commit. Adjust by callingupdate_aeo_prompt_assignmentsagain, or calldiscard_aeo_prompt_assignmentsto abandon. - When ready, call
commit_aeo_prompt_assignmentsto apply the draft to live. Always confirm with the user before committing.
- There is one draft per brand kit, shared between MCP and the human-facing UI.
- If the user has unsaved UI edits, your edits accumulate in the same draft. A subsequent commit will publish both sets of edits together; a discard will destroy both. Surface this to the user before committing or discarding.
list_aeo_prompts. To inspect current draft state without modifying it, use get_aeo_prompt_assignments_status.Input Parameters
Output
Update aeo tag
Update aeo tag
AIROPS_MCP_UPDATE_AEO_TAGUpdate an existing AEO tag’s name and/or color on a Brand Kit.Behavior:- At least one of
nameorcolormust be provided. - If
nameis provided, it must remain unique within the Brand Kit (case-insensitive). - Valid colors: light_grey, grey, green, teal, blue, purple, lilac, pink, red, coral, orange.
- Existing taggings on prompts are preserved — only the tag’s own attributes change.
list_tags.Input Parameters
Output
Update brand kit
Update brand kit
AIROPS_MCP_UPDATE_BRAND_KITUpdate a Brand Kit’s base fields. Only provided fields are changed. Use get_brand_kit first to see current values.Updatable fields include brand identity (name, URL, about) and writing style (persona, tone). This tool edits the Brand Kit draft version only; it does not change the active (live) version.IMPORTANT: Always show the user exactly which fields will be changed and ask for confirmation before calling this tool.Input Parameters
Output
Update grid column
Update grid column
AIROPS_MCP_UPDATE_GRID_COLUMNUpdate an existing grid column’s title, data type, or input mappings. Cannot reassign a playbook or workflow column to a different playbook or workflow, and cannot reposition a column. Passing inputs replaces the entire input mapping, not just the keys given, so include every input you want to keep, not only the ones changing. Returns the updated column’s ID, title, data type, and position.Input Parameters
Output
Update topic
Update topic
AIROPS_MCP_UPDATE_TOPICUpdate an existing AEO topic’s name and/or color on a Brand Kit.Behavior:- At least one of
nameorcolormust be provided. - If
nameis provided, it must remain unique within the Brand Kit. - Valid colors: light_grey, grey, green, teal, blue, purple, lilac, pink, red, coral, orange.
- Existing prompt assignments are preserved. This tool cannot move a topic to another Brand Kit.
list_topics.Input Parameters
Output
Write grid
Write grid
AIROPS_MCP_WRITE_GRIDCreate or update rows in a grid table. When mode is ‘create’, rows are added as new rows with column titles as keys. When mode is ‘update’, each row must include a ‘__id’ key with the row ID to update. To update a single cell, pass a single-element array with the row ID and the column to change. Maximum 1000 rows per operation.