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.