> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstanswer.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools

> Reference for all 16 tools exposed by the First Answer MCP server to analyze brand AI visibility.

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.

<Note>
  **Start here:** call `list_brands` first to obtain `brand_id` values. Almost every other tool requires a `brand_id`.
</Note>

## 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

<Tip>
  * **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.
</Tip>

## Related

* [Introduction](/mcp/introduction) — connect Cursor, Claude, and other MCP clients.