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
| Tool | What it does | Access |
|---|---|---|
get_workspace | The team, your role and permissions, each site with its setup steps, and unread notifications. Call it first. | All |
get_overview | What needs attention: drafts in review, failed publications, incomplete checks, and what's next. | All |
search_workspace | Finds sites, content, and tracked questions that match a name, title, path, or text. | All |
get_usage | The plan, articles used and reserved, question and site limits, and the renewal date. | All |
Sites and brand
| Tool | What it does | Access |
|---|---|---|
get_site | Setup steps, brand profile, competitors, page types, integrations, publishing settings, and ideas. | All |
get_site_analysis | Analysis progress, issues, suggested brand profile values with evidence, and the report. | All |
create_site | Adds a website and starts analysis. | Admin |
update_site | Renames a site, changes its primary domain, or sets its country. | Admin |
delete_site | Permanently deletes a site and all its data. Needs the domain to confirm. | Admin |
start_site_analysis | Reads the website again for new suggestions. | Admin |
get_ai_readiness | The site's AI readiness score and what to fix so AI search can reach and understand it. | All |
check_ai_readiness | Checks AI readiness again. Takes up to 30 seconds. | Admin |
review_brand_suggestion | Accepts or dismisses one suggested brand profile value. | All |
update_brand_profile | Changes brand profile values. | All |
update_topic_preferences | Replaces the topic preferences that guide ideas. | All |
update_writing_preferences | Replaces the writing preferences that every article follows. | All |
save_competitor | Adds or updates a competitor. | All |
remove_competitor | Removes a competitor. | All |
suggest_page_type_setup | Drafts writing and research guidance for a new page type. | All |
save_page_type | Creates or updates a page type, and can turn off suggested ideas for it. | All |
Publishing
| Tool | What it does | Access |
|---|---|---|
get_sdk_setup | The package, environment variables, files, endpoint, and secret link for the Next.js SDK. | All |
update_publishing_settings | Sets approval mode, default schedule, delivery endpoint, and the fallback method, including the WordPress sign-in. | Admin |
verify_publishing_connection | Checks that the site's SDK endpoint answers a signed request. | Admin |
publish_content | Publishes a page now, schedules it, cancels a schedule, or retries a failed publication. | All |
export_content | Returns the MDX file for a page published by MDX export. | All |
merge_pages | Rewrites one live page to replace up to five others. | All |
retire_merged_pages | Retires the pages a published merge replaced. | All |
Content and ideas
| Tool | What it does | Access |
|---|---|---|
list_content | Lists ideas, work in progress, or published pages, 25 per page. | All |
get_content | One idea, draft, or page with its Markdown, flags, checked facts, sources, publication, and what the latest feedback taught us (learned). Can include saved versions. | All |
create_content | Creates a manual draft. | All |
save_content | Saves a new version of a draft's title, path, description, and Markdown. | All |
delete_content | Permanently deletes a draft or published page. SDK and deploy hook sites drop the page; other copies stay. | All |
write_idea | Writes an idea in the background. Claims we can't confirm stay in the text with a flag. Takes an optional team note. | All |
dismiss_idea | Removes an idea, with an optional reason and note. | All |
request_changes | Revises a draft from feedback and learns preferences; get_content then shows what was saved. Facts it gives count as the team's. Parts we couldn't do get flags. | All |
resolve_flag | Answers a flag with a fact or a source link to revise the claim, saves a true business claim as a fact, or closes it. | All |
check_facts | Checks the facts in a draft's current text and adds flags. It never changes the text. | All |
approve_content | Approves a draft, with optional feedback for future articles. Publishes it when the site publishes right away by default. | All |
reject_content | Closes an unpublished draft, with an optional reason and note. | All |
restore_content | Restores an earlier version, a rejected draft, or a removed idea. | All |
refresh_content | Rewrites a live page with new research. The live version stays up until the update is published. | All |
manage_content_work | Retries a failed job, stops a running one, or hides a suggested refresh. | All |
find_more_ideas | Starts finding new ideas for a site, for one page type and a short request if given. Skips ideas-off types. Daily limit. | All |
add_ideas | Adds the team's own ideas for one page type. Each becomes a new idea that write_idea can write. | All |
set_target_questions | Sets the tracked questions a page answers. | All |
Automations
| Tool | What it does | Access |
|---|---|---|
list_automations | Automations with their schedule, status, and recent runs. | All |
save_automation | Creates or updates an automation for one page type. | Admin |
set_automation_state | Pauses or resumes an automation. | Admin |
retry_automation_run | Retries the failed drafts or refreshes of one automation run. | Admin |
Questions and performance
| Tool | What it does | Access |
|---|---|---|
list_questions | Tracked and suggested questions with latest results and the pages that answer. | All |
add_question | Tracks a buyer question across AI engines. | All |
update_question | Rewords a question or changes its status. | All |
suggest_questions | Adds about five suggested questions for a site. | All |
track_suggested_questions | Tracks waiting suggestions until the team's question limit. | All |
get_ai_visibility | Whether each AI engine cites you, mentions you, or names which competitor. | All |
get_visibility_answers | The saved AI answers and citations for one question and engine. | All |
retry_visibility_check | Asks the AI engines again for answers missing from an incomplete check. | All |
get_performance | AI visibility and citation rates over time. | All |
get_outcomes | AI citations and Google clicks for published pages at 14, 30, 60, and 90 days. | All |
get_search_performance | Google Search Console clicks, impressions, and position for a site. | All |
get_page_search | Google data and top queries for one published page. | All |
disconnect_search_console | Disconnects Google Search Console from a site. | Admin |
Team and notifications
| Tool | What it does | Access |
|---|---|---|
list_members | Team members and pending invitations. | All |
invite_member | Emails an invitation to join the team. | Admin |
list_notifications | Your latest 50 notifications and the unread count. | All |
mark_notifications_read | Marks one, some, or all notifications as read. | All |
get_notification_settings | Which notifications you also get by email. | All |
update_notification_settings | Sets which notifications you also get by email. | All |