> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/mcp-server/tools-and-support/tools/prompts-and-answers.md).

# Prompts & Answers

Read tracked prompts and AI answers, and configure prompt tracking for a Brand Kit.

Read tracked prompts and AI answers, and configure prompt tracking for a Brand Kit.

See [plan access](broken://pages/GlhqboJgu5fTfPseY3y1#plan-access) and [query options](broken://pages/GlhqboJgu5fTfPseY3y1#query-options) for shared requirements.

## 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, tags                                                                                |
| **Date filters** | start\_date, end\_date, providers, countries, personas                                     |

Use `fields` to select output values and `filters` to narrow the list. `providers` is a top-level metrics parameter, not an output field or filter. `keyword` is an output field, not a filter. To match prompt text, use `text EQUALS` or `text CONTAINS`; `text IN` is unsupported. Invalid field/operator combinations return a validation error.

***

### `create_aeo_prompt`

Create a new tracked AEO prompt for a Brand Kit. Background jobs analyze the prompt, extract keywords, and compute volume metrics after creation.

**Requires:** `brand_kit_id`, `text`, `topic_id`

**Optional fields:** `countries`, `persona_ids`, `platforms`

{% hint style="warning" %}
Creating prompts can affect answer volume. Confirm the prompt text, topic, and assignments with the user before calling this tool.
{% endhint %}

***

### `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, and the prompt's read-only `intent_stage` (`awareness`, `consideration`, `evaluation`, `purchase`, or `null`).

| 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, read-only `intent_stage`, 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.

***

### `list_answers`

List AI answers across a Brand Kit with filters for date range, providers, countries, personas, and other AEO dimensions. Use this when you need answers across many prompts instead of answers for one prompt.

**Requires:** `brand_kit_id`

Each answer includes the prompt's read-only `intent_stage`, or `null` when classification is unavailable.

***

## AEO Setup and Prompt Management

### `create_aeo_persona`

Create a new AEO persona for a Brand Kit. Personas represent the user perspectives used to simulate AI search queries.

**Requires:** `brand_kit_id`, `title`, `description`

**Optional fields:** `add_to_all_prompts`

***

### `add_aeo_region`

Add an ISO alpha-2 country code to a Brand Kit's configured AEO regions.

**Requires:** `brand_kit_id`, `country_code`

**Optional fields:** `add_to_all_prompts`

***

### `list_tags`

List AEO tags configured for a Brand Kit.

**Requires:** `brand_kit_id`

| Parameter   | Values            |
| ----------- | ----------------- |
| **Filters** | name              |
| **Sort**    | name, created\_at |

***

### `create_aeo_tag`

Create a new AEO tag on a Brand Kit. Tags are user-defined labels that can be applied to prompts.

**Requires:** `brand_kit_id`, `name`

**Optional fields:** `color`

***

### `update_aeo_tag`

Update an AEO tag's name or color. Existing prompt taggings are preserved.

**Requires:** `brand_kit_id`, `tag_id`

**Fields:** `name`, `color`

***

### `delete_aeo_tag`

Delete an AEO tag from a Brand Kit and remove it from every prompt that uses it.

**Requires:** `brand_kit_id`, `tag_id`

{% hint style="warning" %}
This action permanently deletes the tag and removes its prompt taggings. Confirm the tag and impact before calling it.
{% endhint %}

***

### `bulk_update_aeo_prompt_tags`

Add or remove one or more tags across a batch of AEO prompts in one transaction.

**Requires:** `brand_kit_id`, `prompt_ids`, `operation`, `tag_ids`

**Operations:** `add`, `remove`

***

### `update_aeo_prompt_assignments`

Stage draft assignment changes for one or more AEO prompts. Assignments include countries, personas, and platforms. Changes do not become live until `commit_aeo_prompt_assignments` runs.

**Requires:** `brand_kit_id`, `prompts`

**Prompt fields:** `prompt_id`, `countries`, `persona_ids`, `platforms`

***

### `get_aeo_prompt_assignments_status`

Inspect the current prompt-assignment draft state for a Brand Kit. Use this to check whether a draft exists, whether it has changes, and whether committing it would exceed the workspace answer limit.

**Requires:** `brand_kit_id`

***

### `commit_aeo_prompt_assignments`

Commit the current prompt-assignment draft to live. This replaces live country, persona, and platform assignments with the draft state.

**Requires:** `brand_kit_id`

{% hint style="warning" %}
This affects live AEO tracking assignments. Confirm with the user before committing.
{% endhint %}

***

### `discard_aeo_prompt_assignments`

Discard the current prompt-assignment draft and create a fresh draft from live assignments.

**Requires:** `brand_kit_id`

{% hint style="warning" %}
This discards all pending assignment edits in the shared draft, including unsaved UI edits. Confirm with the user before calling it.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/mcp-server/tools-and-support/tools/prompts-and-answers.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.