See Filter Compatibility for the authoritative filter contract and the coverage of every MCP tool.
get_prompts
List monitored prompts (queries) for a brand.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | The brand ID |
status | string | No | Filter: PENDING, IN_PROGRESS, COMPLETED |
topic | string | No | Filter by topic ID from list_topics |
tag | string | No | Filter by tag ID from list_tags |
limit | number | No | Max prompts (default: 50) |
offset | number | No | Pagination offset |
Returns
| Field | Type | Description |
|---|---|---|
id | string | Prompt ID |
text | string | The prompt text |
type | string | Funnel stage: TOFU, MOFU, BOFU |
topic | object | Assigned topic ID and label, or null |
tags | array | Assigned tag IDs, labels, and colors |
monitoringEnabled | boolean | Whether scheduled monitoring is enabled |
frequency | string | Effective monitoring frequency |
frequencyInherited | boolean | Whether frequency comes from the brand default |
boostCount | number | Responses requested per model and run |
status | string | Processing status |
lastGenerationDate | string | Last time responses were generated |
answersCount | number | Total response count |
Example output
## Monitored Prompts
Showing 3 of 156 prompts
### 1. "best project management software 2025"
- ID: prompt-abc-123
- Status: COMPLETED
- Type: TOFU
- Topic: Project Management (ID: topic-123)
- Tags: Priority (ID: tag-456)
- Monitoring: enabled, weekly (brand default), boost ×2
- Answers: 48
- Last checked: 2025-01-28
### 2. "Acme Corp vs Northstar Work"
- ID: prompt-def-456
- Status: COMPLETED
- Type: BOFU
- Answers: 32
- Last checked: 2025-01-28
### 3. "how to improve team productivity"
- ID: prompt-ghi-789
- Status: COMPLETED
- Type: TOFU
- Answers: 56
- Last checked: 2025-01-27
Example prompts
What prompts am I monitoring?
Show me my BOFU queries
List prompts with the "pricing" tag
OAuth scope
Requires:read:prompts
get_prompt_answers
Get AI responses for a specific prompt across all providers.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | The brand ID |
promptId | string | Yes | The prompt ID (from get_prompts) |
provider | string | No | Filter by AI provider |
limit | number | No | Max answers (default: 20) |
Returns
| Field | Type | Description |
|---|---|---|
id | string | Answer ID |
text | string | Response preview (first 500 chars) |
provider | string | AI provider name |
modelId | string | Specific model used |
createdAt | string | Response date |
sentiment | number | Sentiment score (if brand mentioned) |
brandMentioned | boolean | Whether brand appears |
Example output
## AI Responses for: "best project management software 2025"
Found 8 responses
### 1. ChatGPT (GPT-5)
Date: 2025-01-28
Brand mentioned: Yes
Sentiment: 82/100
Preview: "For project management in 2025, several excellent options stand out. **Acme Corp** offers robust features for team collaboration..."
### 2. Perplexity Pro
Date: 2025-01-28
Brand mentioned: No
Preview: "The top project management tools include Northstar Work, TaskHarbor, and Acme Corp. Each offers different collaboration features..."
### 3. Claude (Sonnet)
Date: 2025-01-27
Brand mentioned: Yes
Sentiment: 79/100
Preview: "Based on recent reviews, I'd recommend considering **Acme Corp** for enterprise teams that need..."
Example prompts
How do AI providers answer "best project management software"?
Show me ChatGPT's response to my pricing query
Compare how different AIs respond to this prompt
OAuth scope
Requires:read:prompts
get_answers
Browse and filter all AI responses for a brand.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | The brand ID |
provider | string | No | Filter by AI provider |
topic | string | No | Filter by topic ID |
tag | string | No | Filter by tag ID |
startDate | string | No | Start date (YYYY-MM-DD) |
endDate | string | No | End date (YYYY-MM-DD) |
limit | number | No | Max answers (default: 50) |
offset | number | No | Pagination offset |
Returns
| Field | Type | Description |
|---|---|---|
id | string | Answer ID |
promptText | string | The prompt that was asked |
provider | string | AI provider name |
createdAt | string | Response date |
brandMentioned | boolean | Whether brand appears |
sourceCited | boolean | Whether brand domain is cited |
Example output
## AI responses
Showing 10 of 2,340 responses
| Date | Provider | Prompt | Brand | Source |
|------|----------|--------|-------|--------|
| 2025-01-28 | ChatGPT | best project management so... | Yes | Yes |
| 2025-01-28 | Perplexity | top collaboration tools | No | No |
| 2025-01-28 | Claude | Acme Corp review | Yes | Yes |
| 2025-01-27 | Gemini | workflow automation soft... | Yes | No |
Example prompts
Show me responses from this week
Find responses where my brand was mentioned
List Perplexity responses from January
OAuth scope
Requires:read:answers
get_answer_details
Get full details of a specific AI response including text, competitors, and sources.Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
brandId | string | Yes | The brand ID |
answerId | string | Yes | The answer ID (from other tools) |
Returns
| Section | Description |
|---|---|
| Response | Full text, provider, model, date |
| Prompt | Original prompt text and type |
| Competitors | All brands mentioned with position and sentiment |
| Sources | All URLs cited with domain and position |
| Enrichment | AI-extracted topic, keywords, summary, answer type |
Example output
## AI response details
**Prompt:** "best project management software 2025"
**Provider:** ChatGPT (GPT-5)
**Date:** 2025-01-28
### Response
For project management in 2025, several options stand out. **Acme Corp** offers team collaboration features including real-time editing, Gantt charts, and automated workflows. Other contenders in this synthetic sample include Northstar Work for visual project tracking and TaskHarbor for task management...
### Analysis
- Topic: Project Management Software
- Type: Comparison
- Keywords: project management, collaboration, Gantt charts, workflows
**Summary:** Comparison of project management tools highlighting Acme Corp's collaboration features.
### Competitors mentioned
1. **Northstar Work** #1 - DIRECT (sentiment: 78/100)
2. **Acme Corp** #2 - SELF (sentiment: 82/100)
3. **TaskHarbor** #3 - DIRECT (sentiment: 75/100)
### Sources cited
1. reviews.example (#1)
https://reviews.example/project-management
2. acme.example [YOUR SITE] (#2)
https://www.acme.example/features
3. software-guide.example (#3)
https://software-guide.example/project-management
Example prompts
Show me the full details of that response
What sources were cited in that ChatGPT answer?
Who was mentioned in that response?
OAuth scope
Requires:read:answers