The First Answer MCP server exposes 16 read-only tools your assistant can call to explore brands, prompts, competitors, and cited sources. Use this page as a map of what each tool does and how tools fit together.
Start here: call list_brands first to obtain brand_id values. Almost every other tool requires a brand_id.
Brands
| Tool | What it does |
|---|
list_brands | Lists brands in your workspaces (paginated). Entry point — use returned id as brand_id everywhere else. |
get_brand | Returns full detail for one brand (description, features, website, country, language). |
Groups
| Tool | What it does |
|---|
list_groups | Lists prompt groups (categories) for a brand. Use group_id from results to filter get_dashboard, list_monitored_prompts, and list_cited_sources. |
Dashboard
| Tool | What it does |
|---|
get_dashboard | Aggregated metrics for a date range: prompt counts, mention rates, sentiment, competitor count, brands_ranking, top and lowest performing prompts. Optional filters: group_id, ai_model. |
Monitored prompts
| Tool | What it does |
|---|
list_monitored_prompts | Lists monitored prompts with summary stats (mentions, mention rate, sentiment, positions). Requires brand_id, start_date, end_date. |
get_monitored_prompt | Deep dive on one prompt: metrics plus daily time series for your brand vs competitors. |
get_monitored_prompt_responses | Full text of AI responses (markdown/plain), mentions, sentiment, citations, and search queries per response. |
get_monitored_prompt_citations | Domains and URLs cited for that prompt only. |
get_monitored_prompt_search_queries | Search queries the AI ran while answering that prompt. |
Competitors
| Tool | What it does |
|---|
list_monitored_competitors | Lists competitors tracked with the brand (ids, names, descriptions). |
get_monitored_competitor | Detail for one competitor (monitored_competitor_id). |
Cited sources
| Tool | What it does |
|---|
list_cited_sources | Brand-wide list of domains cited across prompts (impact, counts, AI models). Optional search, group_id. |
list_cited_urls | Flat ranking of URLs across all domains; optional search, monitored_prompt_id. |
get_cited_source_urls | URLs inside one domain; needs domain_id from list_cited_sources. |
get_cited_source_related_prompts | Which prompts cite a given domain. |
get_cited_source_url_related_prompts | Which prompts cite a specific URL (domain_id + url_id). |
list_cited_sources → get_cited_source_urls → get_cited_source_url_related_prompts.
Common parameters
- Dates: use
start_date and end_date in YYYY-MM-DD where required.
ai_model (optional): chat_gpt, perplexity, bing_copilot, google_ai, gemini, grok, google_ai_mode.- Pagination: tools that list data accept
page (default 1) and per_page (default 100, max 100). Fetch additional pages when results exceed one page.
- Introduction — connect Cursor, Claude, and other MCP clients.
