MCP tools - First Answer

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`).

Typical drill-down: 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.

​Brands

​Groups

​Dashboard

​Monitored prompts

​Competitors

​Cited sources

​Common parameters

​Related

Brands

Groups

Dashboard

Monitored prompts

Competitors

Cited sources

Common parameters

Related