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

# Available MCP tools

> Every tool the AI Growth Agent MCP server exposes, with arguments and returns.

The server exposes 10 tools in three groups. Your MCP client's live tool list
is the source of truth — these tables mirror the registered schemas.

All tools act as the connected user via their bearer token. Every read tool
uses the session's current account unless an explicit `accountId` is passed.
There is no login tool: authentication happens at connection time via OAuth.

## Auth

| Tool            | Input                                                                       | Returns                                                                                                                                                                    |
| --------------- | --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `auth_status`   | —                                                                           | Session view `{user, accounts, currentAccountId, accessTokenExpiresAt}` (never the token), or a "not authenticated" message (not an error) when there is no session        |
| `list_accounts` | —                                                                           | `{accounts, currentAccountId}` from the token's claims                                                                                                                     |
| `set_account`   | `accountId` (int, required) — account to make current, from `list_accounts` | Updated `{currentAccountId, accounts}`; unknown IDs error with the valid accounts. Kept per user for the life of the server process; defaults to the token's first account |

## Content planner

| Tool                              | Input                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Returns                                                    |
| --------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------- |
| `content_planner_list_seed_terms` | `accountId?`, `showArchived?` (default `false`), `priorityTier?` (array of `high` — priority ≥ 15000, `standard` — 10000–14999, `backlog` — \< 10000; omit for all), `referenceUrl?` (substring on result URLs, case-insensitive, `-` prefix negates; `google-ranking` mode only, mutually exclusive with `agaFilter`), `agaFilter?` (restrict SERP results to this account's published articles), `mode?` (`google-ranking` / `google-mentions` / `chatgpt-ranking` / `chatgpt-mentions`, default `google-ranking`), `referenceBrand?` (brand substring filter for mention metrics; defaults to the account's default brand), `sortBy?` (`term` / `publishedCount` / `searchVolume` / `rankingQuestions` / `rankingQuestionsPercent` / `priority` / `mentionedQuestions` / `mentionedQuestionsPercent`), `sortOrder?` (`asc` / `desc`) | The main planner table (seed terms) plus aggregate metrics |
| `content_planner_list_questions`  | `seedId` (int, required — from `content_planner_list_seed_terms`), plus `accountId?`, `showArchived?`, `referenceUrl?`, `agaFilter?`, `mode?`, `referenceBrand?` (same meaning as above)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | Questions under one seed term                              |

## Reporting

| Tool                            | Input                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   | Returns                                                                                                      |
| ------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `reporting_get_trend`           | `accountId?`, `mode?` (`ranking` / `mention`, default `ranking`), `yAxis?` (`rate` percent / `absolute` counts, default `rate`), `period?` (`week` / `28days` / `3months` / `all`, default `all`)                                                                                                                                                                                                                                                                                                                                                                                       | Visibility trend over time (Overview tab): per-snapshot rate/counts plus a period-over-period comparison     |
| `reporting_get_available_dates` | `accountId?`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            | Metric snapshot dates (`YYYY-MM-DD`, ascending) usable as `startDate`/`endDate` for `reporting_get_wins`     |
| `reporting_get_wins`            | `accountId?`, `startDate?` (`YYYY-MM-DD`), `endDate?` (defaults to the most recent snapshot); dates must come from `reporting_get_available_dates`                                                                                                                                                                                                                                                                                                                                                                                                                                      | New rankings and brand mentions between two snapshots (Wins tab), including position movements               |
| `reporting_get_top_entities`    | `accountId?`, `mode` (required — `ranking` returns top domains, `mention` returns top brands), `campaign?` (restrict to campaign-tier seed terms, priority ≥ 15000; default `false`)                                                                                                                                                                                                                                                                                                                                                                                                    | Top ranking domains or top brand mentions across the account's active questions                              |
| `reporting_get_urls`            | `accountId?`, `view?` (`domain` / `url`, default `domain`), `agaFilter?` (`all` / `aga` / `non-aga`, default `all`), `search?` (case-insensitive substring on the normalized host), `host?` (`url` view only; exact normalized host), `channel?` (`any` / `organic` / `ai`, default `any`), `sort?` (`questions` / `seeds` / `organicQuestions` / `aiQuestions` / `avgOrganicPosition` / `avgAiPosition`, default `questions`; null `avg*Position` values sort last), `order?` (`asc` / `desc`, default `desc`), `limit?` (page size 1–200, default 50, clamped), `offset?` (default 0) | Paginated URL/domain analysis (Top URLs tab) across active questions with organic vs AI counts and positions |

## Rate limits

The growflow-v2 backend rate-limits to roughly 200 requests per minute. Prefer
filtered queries over repeated full-list polling.