RootSmith Docs

MCP tools

Every tool the RootSmith MCP server offers, grouped by task, with the role each one needs.

A connected agent sees only the tools its person's role allows. Tools marked Admin need the Owner or Admin role. Each tool's full input and output schema comes from the server when the agent connects.

Start here

ToolWhat it doesAccess
get_workspaceThe team, your role and permissions, the sites, and unread notifications. Call it first.All
get_overviewWhat needs attention: drafts in review, failed publications, incomplete checks, and what's next.All
get_usageThe plan, credits used and reserved, question and site limits, and the renewal date.All

Sites and brand

ToolWhat it doesAccess
get_siteBrand profile, competitors, page types, integrations, publishing settings, and ideas.All
get_site_analysisAnalysis progress, issues, suggested brand profile values with evidence, and the report.All
create_siteAdds a website and starts analysis.Admin
update_siteRenames a site or changes its primary domain.Admin
delete_sitePermanently deletes a site and all its data. Needs the domain to confirm.Admin
start_site_analysisReads the website again for new suggestions.Admin
review_brand_suggestionAccepts or dismisses one suggested brand profile value.All
update_brand_profileChanges brand profile values.All
update_topic_preferencesReplaces the topic preferences that guide ideas.All
save_competitorAdds or updates a competitor.All
remove_competitorRemoves a competitor.All
suggest_page_type_setupDrafts writing and research guidance for a new page type.All
save_page_typeCreates or updates a page type.All

Publishing

ToolWhat it doesAccess
get_sdk_setupThe package, environment variables, files, and endpoint for the Next.js SDK.All
update_publishing_settingsSets approval mode, default schedule, delivery endpoint, and the fallback method.Admin
verify_publishing_connectionChecks that the site's SDK endpoint answers a signed request.Admin
publish_contentPublishes an approved page now, schedules it, or retries a failed publication.All
export_contentReturns the MDX file for a page published by MDX export.All
merge_pagesRewrites one live page to replace up to five others.All
retire_merged_pagesRetires the pages a published merge replaced.All

Content and ideas

ToolWhat it doesAccess
list_contentLists ideas, work in progress, or published pages, 25 per page.All
get_contentOne idea, draft, or page with its Markdown, brief, checks, sources, and publication.All
create_contentCreates a manual draft.All
save_contentSaves a new version of a draft's title, path, description, and Markdown.All
change_content_statusSends to review, approves, returns to draft, cancels a schedule, restores, or rejects.All
work_on_contentApproves, writes, revises, checks, researches, or refreshes an idea or page.All
update_idea_briefEdits an idea's title and brief before writing starts.All
find_more_ideasStarts finding new ideas for a site.All
set_target_questionsSets the tracked questions a page answers.All
set_content_insightSaves the team's first-hand experience, views, and data for a page.All

Automations

ToolWhat it doesAccess
list_automationsAutomations with their schedule, status, and recent runs.All
save_automationCreates or updates an automation for one page type.Admin
set_automation_statePauses or resumes an automation.Admin
retry_automation_runRetries the failed drafts or refreshes of one automation run.Admin

Questions and performance

ToolWhat it doesAccess
list_questionsTracked and suggested questions with the latest AI engine results.All
add_questionTracks a buyer question across AI engines.All
update_questionRewords a question or changes its status.All
suggest_questionsAdds about five suggested questions for a site.All
track_suggested_questionsTracks waiting suggestions until the team's question limit.All
get_ai_visibilityWhether each AI engine cites or mentions you or a competitor, per question.All
get_visibility_answersThe saved AI answers and citations for one question and engine.All
retry_visibility_checkAsks the AI engines again for answers missing from an incomplete check.All
get_performanceAI visibility and citation rates over time.All
get_outcomesAI citations and Google clicks for published pages at 14, 30, 60, and 90 days.All
get_search_performanceGoogle Search Console clicks, impressions, and position for a site.All
get_page_searchGoogle data and top queries for one published page.All
disconnect_search_consoleDisconnects Google Search Console from a site.Admin

Team and notifications

ToolWhat it doesAccess
list_membersTeam members and pending invitations.All
invite_memberEmails an invitation to join the team.Admin
list_notificationsYour latest 50 notifications and the unread count.All
mark_notifications_readMarks one, some, or all notifications as read.All
get_notification_settingsWhich notifications you also get by email.All
update_notification_settingsSets which notifications you also get by email.All

On this page