MCP tools
Look up every tool a connected AI tool can use in Sonat, what it does, and whether it reads or changes your content.
You don't call these tools yourself. Your AI tool picks them based on what you ask. Knowing the names helps when your AI tool asks you to approve a step, or when you want to point it at a specific tool.
Read tools are available on every connection. Write tools appear only on Read & write connections made by a Writer, Admin or Owner, or with an API token that has the Writer or Admin role. A read-only connection doesn't see them at all.
Search and read
| Tool | What it does | Type |
|---|---|---|
search_knowledge_base | Searches your published documents and returns titles, matching snippets and links. Team and above. | Read |
ask_question | Answers a question from your published documentation, with links to the source topics. Team and above. | Read |
list_documents | Lists the documents in your organization with their IDs, titles and slugs. | Read |
get_document | Gets one document's details and structure. | Read |
get_draft_topic_tree | Gets a document's full topic tree, including unpublished drafts, with topic IDs. | Read |
get_topic_tree | Gets the published table of contents of a document, as readers see it. | Read |
get_topic_content | Reads a topic's current draft: title, body and format. | Read |
list_folders | Lists your folders, or the folders inside one folder. | Read |
list_document_images | Lists the images in a document's gallery, with their addresses. | Read |
search_images | Searches free stock photos by keyword and returns candidates with photographer credits. | Read |
fetch_url | Reads a public web page you gave it and returns the text. It treats the page as material to read, never as instructions. | Read |
AI Insights
These tools need Team or above. On Free they return an error.
| Tool | What it does | Type |
|---|---|---|
read_content_gaps | Lists the questions readers asked that your documentation couldn't answer, ranked by how often they failed, with the reason for each. | Read |
read_ai_insights_overview | Gives headline numbers for a date range: questions asked, answered, not answered, reader satisfaction and answer speed. | Read |
AI writing helpers
| Tool | What it does | Type |
|---|---|---|
summarize | Summarizes text into key points, as a paragraph or bullets. | Read |
rewrite | Rewrites text for a target tone, audience and reading level. | Read |
generate_content | Writes an article, procedure, how-to guide, FAQ, troubleshooting page or release note from source material you provide. | Read |
These helpers return text. They don't save anything until the AI uses a write tool.
Create and edit content
| Tool | What it does | Type |
|---|---|---|
create_document | Creates an empty document. Content goes into topics. | Write |
update_document | Changes a document's title, description or appearance. It doesn't change the document's web address. | Write |
create_topic | Creates a topic as a draft, inside a document or on its own. | Write |
update_topic | Changes a topic's title, body, slug or description. Only the fields it sends change. | Write |
upload_document_image | Adds an image to a document's gallery from a web address or file data. | Write |
publish_topic | Publishes the current drafts of one or more topics and returns their live links. | Write |
revert_topic | Restores a topic to an earlier version. | Write |
discard_topic | Throws away a topic's unpublished changes in one language. | Write |
Organize
| Tool | What it does | Type |
|---|---|---|
create_folder | Creates a folder. | Write |
update_folder | Renames a folder in one language. | Write |
move_folder_to_folder | Moves a folder into another folder or to the top level. | Write |
move_document_to_folder | Moves a document into a folder or to the top level. | Write |
move_topic_to_folder | Moves a standalone topic (one that isn't in a document) into a folder. | Write |
move_topic | Moves a topic under a different parent or changes its order in a document. Its subtopics move with it. | Write |
Delete
| Tool | What it does | Type |
|---|---|---|
delete_document | Deletes a document and all its topics. | Write |
delete_topic | Deletes a topic and its content. | Write |
delete_folder | Deletes a folder. | Write |
Support
| Tool | What it does | Type |
|---|---|---|
report_bug | Sends a bug report to the Sonat team for you. It doesn't change your content, but it's available only on Read & write connections. | Write |
Writing guidelines and other resources
Besides tools, Sonat gives your AI tool reference material it can read when it needs it:
- An authoring guide that explains how documents, topics and publishing work in Sonat.
- Writing guidelines for house style, terminology and content types such as how-to guides, tutorials, reference pages, release notes, troubleshooting pages, user manuals and runbooks.
- Your documents, each with its outline.
Ask for a guideline by name, for example "Follow the Sonat troubleshooting guideline."