Every tool the assistant can use.

The complete set of ScoutRival tools available over MCP — what each returns, the access level it needs, and what it costs. Reading is free and returns the full dashboard view; a few tools generate content or run a check and spend credits.

Your assistant sees these as named tools it can call on your behalf. You don't type the names — you ask in plain language ("what did my competitors do this week") and the assistant picks the right one. This page is the reference for what each returns, so you know what to expect.

// TWO THINGS TO KNOW

Access is the token level a tool needs — Read-only, Content or Full (see scopes). Cost is credits, charged exactly as in the app. Reading your data is always free and returns the whole view, not a summary. Tools marked job take a while, so they hand back a ticket the assistant checks for the result.

Brand & account

Tool	Returns	Access	Cost
`list_brands`	Your brands — name, site, plan, engine status.	Read-only	Free
`get_brand`	A brand's full profile — positioning, services, socials, colours, keyword count, engine status, voice summary.	Read-only	Free
`get_brand_voice`	The voice fingerprint — tone, formality, signature moves, dos and don'ts, and phrase rules. For writing on-brand copy.	Read-only	Free
`list_brand_keywords`	The brand's market keywords — intent, score, mapped service, competition, brand fit.	Read-only	Free
`get_credit_balance`	Your shared credit balance, plan and reset date.	Read-only	Free
`get_usage`	Credit usage for a window (7, 30 or 90 days, or the cycle).	Read-only	Free

Competitors

Tool	Returns	Access	Cost
`list_competitors`	Competitors tracked for a brand — name, site, monitored sources, paused state.	Read-only	Free
`get_competitor`	One competitor in full — profile, latest deep analysis (pressure score, teardown), and recent signals.	Read-only	Free
`list_recent_signals`	Recent detected competitor changes — what shipped, when, and on which channel.	Read-only	Free
`add_competitor`	Start tracking a competitor.	Full	5 credits after the first 5 per brand
`run_competitor_analysis` (job)	Run the deep AI teardown through a lens (fight, reposition, price up). Rate-limited to once a day per competitor.	Full	Free

Daily Brief

Tool	Returns	Access	Cost
`get_daily_brief`	Today's brief in full — verdict, next move, what each rival did, the suggested posts and blog idea.	Read-only	Free
`list_briefs`	The brief archive — past briefs with date, status and verdict.	Read-only	Free
`get_brief`	Any past brief in full, the same shape as today's.	Read-only	Free
`generate_daily_brief` (job)	Generate a fresh brief now (competitor scan, verdict, content ideas).	Content	Varies with the brief

AI Visibility

Tool	Returns	Access	Cost
`get_ai_visibility`	Your latest check — mention rate, share of voice and citation share (each with a range), per-engine cards, the competitor leaderboard, sentiment and the trend.	Read-only	Free
`get_ai_visibility_actions`	The prioritised fixes from the last check, each with the evidence and the points it would recover.	Read-only	Free
`list_ai_prompts`	Your tracked buyer prompts, each with its own visibility, rank and the rivals named on it.	Read-only	Free
`list_ai_answers`	The verbatim engine answers and their citations (each flagged good, stale or fabricated).	Read-only	Free
`get_ai_citations`	The source domains the engines cited, and which rivals they recommend — a list of where to earn a mention.	Read-only	Free
`quote_ai_visibility_check`	The exact credit cost of a check before you run it.	Read-only	Free
`run_ai_visibility_check` (job)	Run a check across your tracked prompts and engines.	Full	2 credits per answer

SEO & site audit

Tool	Returns	Access	Cost
`get_seo_audit`	Your latest SEO report — score and grade, pillar breakdown, fix cards with how-to guides, what's passing, and Core Web Vitals.	Read-only	Free
`run_seo_audit` (job)	Run an SEO audit at essential, standard or deep depth.	Full	Flat 30 / 40 / 50 by depth; first per depth free (plan-gated)
`get_site_ai_audit`	Your latest site AI-visibility audit — score, grade, six pillars and all thirty-one criteria with fixes.	Read-only	Free
`run_site_ai_audit` (job)	Run a site AI-visibility audit at essential, standard or deep depth.	Full	flat 30 / 40 / 50 by depth; first per depth free (plan-gated)

Traffic

Tool	Returns	Access	Cost
`get_traffic`	Search Console traffic (Google or Bing) — clicks, impressions, click-through and average position with changes, top queries, top pages, devices and countries. Needs a connected Search Console.	Read-only	Free
`get_search_ai_bridge`	Where search and AI disagree — you rank but AI doesn't cite you, or AI names you but you don't rank. Needs both Search Console and an AI check.	Read-only	Free

Content

Tool	Returns	Access	Cost
`generate_social_post`	A social post in your brand voice for a platform, with a suggested image prompt.	Content	2 credits
`generate_blog_titles`	SEO-minded title options for a topic.	Content	Free
`generate_blog_article` (job)	A complete brand-voiced SEO article, saved to BlogCraft as a draft.	Content	10 to 50 credits by length
`list_blog_articles`	Your BlogCraft articles — title, status, content score, word count.	Read-only	Free
`get_blog_article`	A full article — body, outline, SEO pack, content score, entities and history.	Read-only	Free
`list_content`	Your content items with their status.	Read-only	Free
`get_content`	The draft body behind a content item.	Read-only	Free
`approve_content`	Approve an item (moves it to the publish queue).	Content	Free
`schedule_content`	Schedule an item for a time.	Content	Free
`mark_content_published`	Mark an item published, with an optional live URL.	Content	Free

Publishing

Tool	Returns	Access	Cost
`publish_to_wordpress`	Push a BlogCraft article to your connected WordPress as a draft — never a live post. You publish it yourself.	Content	Free

Jobs & access levels

Tools marked job — full articles, audits, AI-visibility checks, briefs and competitor analyses — take longer than a normal reply. They hand your assistant a ticket straight away, and it checks back for the result with one more tool:

Tool	Returns	Access	Cost
`get_job`	The status and result of a running job.	Any	Free

The three access levels map to what you'd want a connection to be able to do: Read-only reads everything and spends nothing; Content adds writing content, generating a brief and saving WordPress drafts; Full adds running audits and checks and adding competitors. Choose the least you need — see scopes and access levels.

Still stuck?

Contact support