GitBook

Opens a change request on a space. Published content is never edited directly: create a change request, edit pages within it, then submit/merge it. Returns the new change request id needed for those follow-ups. Pass a description to tell reviewers what changes and why. Pass siteFindingIds to link up to 25 site findings this change request fixes. Merging does not resolve outbound broken-link findings; the outbound checker confirms those fixes. See get_usage_guide("editing").

create_change_request

Describes one GitBook API operation found via search: its path/query parameters and request-body JSON Schema, so you can build params for invoke_operation. Read-only.

describe_operation

Returns a page from the space's main content as markdown plus its id, title and path. Look the page up by pageId or by path. For editing a change request, use get_usage_guide with topic editing for reading its content and using the optional concurrency guard. Links to other pages and files are stable references such as `/pages/<pageId>` or `/files/<fileId>`; keep them as they are when writing the content back. Find a space with get_site_structure; to list that space's pages, use the operation surface — invoke_operation getSpaceById to read its `revision`, then getRevisionById to get the revision's pages.

get_page

Returns the JSON Schema of a type that a tool's input schema leaves out, such as a document block, along with the types it contains. Call it when a schema says to, before building that part of the input. Any type still left out is named, so you can expand it in turn. For worked examples of document content, see get_usage_guide("editing").

get_schema_definition

Returns a site's navigation structure: its sections, groups, external links (with destination URLs), and published spaces, with the paths and ids needed to read content. Pass the organization id (the same one used with list_sites) and the site id. Use it to map a site before reading or editing. Find a site first with list_sites; read page content with get_page.

get_site_structure

Returns procedural guidance for working with GitBook through this server (content model and step-by-step recipes). Call it when unsure how to orient, read, or edit content. Omit topic to list available topics.

get_usage_guide

Runs one GitBook API operation discovered via search, for capabilities not covered by a curated tool. Pass operationId and params (path/query/body). Destructive operations are not available here; use the matching curated tool.

invoke_operation

Lists the topics and subtopics a site's content and visitor questions are organised under, ranked by how many Ask AI questions they drew over the range, with each one's answered rate, open findings and id. Use it to find which topics visitors ask about most or struggle with, to resolve a topic by name, or to discover a topic id before filtering Ask AI questions, answers or stats by topic (the `topic` parameter of getSiteQuestionStats, listSiteQuestions and listSiteQuestionAnswers). Use getSiteTopicById for a single topic's summary.

list_site_topics

Lists the published sites in a GitBook organization, the usual entry point for orientation. Returns each site's title, visibility, hostname and id. To reach site content, use this first to find a site, then get_site_structure to see the spaces (where content lives) within it. Not for listing a site's content directly (use get_site_structure).

list_sites

Reports a problem you hit while using this server's tools or operations, or an improvement worth making, so they can be fixed. Use it the moment you run into friction: a confusing tool or parameter, a call that failed or returned something unusable, a task that took far more calls than it should have, or something you needed that no tool or operation could do. It also takes suggestions when nothing went wrong; there is no category for those yet, so pick the one the improvement is about. Report the tool or operation itself, not the content it returned. Reporting is cheap and does not affect your current task, so prefer reporting over staying silent; then carry on with what you were doing.

report_tool_feedback