# RootSmith

> RootSmith helps a team plan, write, publish, and measure website content that AI assistants and search engines cite. These docs explain how to connect a website and an AI agent to RootSmith.

Instructions for agents:

- To install RootSmith in a website codebase, read [Install with an agent](https://docs.rootsmith.io/docs/agents/install.md) first and follow it step by step.
- Every page is Markdown at its URL plus `.md`. A request with `Accept: text/markdown` also gets Markdown.
- All pages in one file: https://docs.rootsmith.io/llms-full.txt
- Never put the RootSmith connection secret in source code, a chat, or a commit. Only the person can copy it from RootSmith.

## Get started

- [Introduction](https://docs.rootsmith.io/docs.md): RootSmith finds the questions your buyers ask AI assistants, then plans, writes, publishes, and measures the pages that get you named in the answers.
- [Quickstart](https://docs.rootsmith.io/docs/quickstart.md): Add your website, review your brand profile, connect publishing, and publish your first page from the RootSmith dashboard.
- [How RootSmith works](https://docs.rootsmith.io/docs/how-it-works.md): The core records in RootSmith, such as teams, sites, brand profiles, page types, questions, ideas, and content, and how a page moves from idea to published.

## Connect your website

- [Choose how to publish](https://docs.rootsmith.io/docs/publishing.md): Pick the way approved RootSmith pages reach your website. Use the Next.js SDK, a static site deploy hook, a signed webhook, or MDX export.
- [Next.js SDK](https://docs.rootsmith.io/docs/publishing/nextjs.md): Install @rootsmithio/next in a Next.js App Router site so RootSmith pages render on your domain and refresh the moment you publish.
- [Static sites](https://docs.rootsmith.io/docs/publishing/static-sites.md): Publish to a Next.js static export with a deploy hook. RootSmith starts a new build of your site each time you publish.
- [Webhooks](https://docs.rootsmith.io/docs/publishing/webhooks.md): Receive each published page as a signed JSON request and save it in any stack. Verify the signature and render the version marker.
- [MDX export](https://docs.rootsmith.io/docs/publishing/mdx-export.md): Download each published page as an MDX file with front matter and a version marker, then add it to your site yourself.
- [Troubleshooting](https://docs.rootsmith.io/docs/publishing/troubleshooting.md): Fix common connection, publishing, and live-check problems with the RootSmith SDK, deploy hooks, and webhooks.

## Agents

- [Install with an agent](https://docs.rootsmith.io/docs/agents/install.md): Give your coding agent one prompt and it connects your website to RootSmith. This page is the step-by-step guide the agent follows.
- [Connect your agent](https://docs.rootsmith.io/docs/agents/connect.md): Add the RootSmith MCP server to Claude Code, Codex, Cursor, or another MCP client so your agent can do anything you can do in RootSmith.
- [MCP tools](https://docs.rootsmith.io/docs/agents/tools.md): Every tool the RootSmith MCP server offers, grouped by task, with the role each one needs.