Read spaces, collections, pages and content; search docs and manage GitBook organization spaces.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Create a new draft change request (branch) in a space. Safe: creates a draft; publishes nothing. GitBook REST: POST /spaces/{spaceId}/change-requests.
The space id.
A title/subject for the change request.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Create a new draft change request (branch) in a space. Safe: creates a draft; publishes nothing. GitBook REST: POST /spaces/{spaceId}/change-requests.
| Argument | Type | Description |
|---|---|---|
| spaceId* | string | The space id. |
| subject | string | A title/subject for the change request. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"subject": {
"type": "string",
"description": "A title/subject for the change request."
}
}
}Get a collection by its ID. GitBook REST: GET /collections/{collectionId}.
| Argument | Type | Description |
|---|---|---|
| collectionId* | string | The collection id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"collectionId"
],
"properties": {
"collectionId": {
"type": "string",
"minLength": 1,
"description": "The collection id."
}
}
}Get the profile of the authenticated GitBook user. GitBook REST: GET /user.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Get a single page's content from a space by its page ID. GitBook REST: GET /spaces/{spaceId}/content/page/{pageId}.
| Argument | Type | Description |
|---|---|---|
| format | string | Response format — 'document' (structured, default) or 'markdown'. |
| pageId* | string | The page id. |
| spaceId* | string | The space id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"spaceId",
"pageId"
],
"properties": {
"format": {
"enum": [
"document",
"markdown"
],
"type": "string",
"description": "Response format — 'document' (structured, default) or 'markdown'."
},
"pageId": {
"type": "string",
"minLength": 1,
"description": "The page id."
},
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
}
}
}Get full details of a space by its ID. GitBook REST: GET /spaces/{spaceId}.
| Argument | Type | Description |
|---|---|---|
| spaceId* | string | The space id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
}
}
}List change requests for a space. GitBook REST: GET /spaces/{spaceId}/change-requests.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
| status | string | Filter by change-request status, e.g. 'open', 'merged', 'draft'. |
| spaceId* | string | The space id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"spaceId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page."
},
"status": {
"type": "string",
"description": "Filter by change-request status, e.g. 'open', 'merged', 'draft'."
},
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
}
}
}List all collections in an organization. GitBook REST: GET /orgs/{organizationId}/collections.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
| nested | boolean | Include nested (sub-)collections in the response. |
| organizationId* | string | The organization id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"organizationId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page."
},
"nested": {
"type": "boolean",
"description": "Include nested (sub-)collections in the response."
},
"organizationId": {
"type": "string",
"minLength": 1,
"description": "The organization id."
}
}
}List top-level comments posted on a space. GitBook REST: GET /spaces/{spaceId}/comments.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
| status | string | Filter by comment status. |
| spaceId* | string | The space id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"spaceId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page."
},
"status": {
"type": "string",
"description": "Filter by comment status."
},
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
}
}
}List the organizations the authenticated user belongs to. GitBook REST: GET /orgs.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page."
}
}
}List all pages in a space with their hierarchy and metadata. GitBook REST: GET /spaces/{spaceId}/content/pages.
| Argument | Type | Description |
|---|---|---|
| spaceId* | string | The space id. |
| computed | boolean | Include computed properties in the response. |
| metadata | boolean | Include page metadata in the response. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"computed": {
"type": "boolean",
"description": "Include computed properties in the response."
},
"metadata": {
"type": "boolean",
"description": "Include page metadata in the response."
}
}
}List all spaces in an organization. GitBook REST: GET /orgs/{organizationId}/spaces.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
| organizationId* | string | The organization id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"organizationId"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page."
},
"organizationId": {
"type": "string",
"minLength": 1,
"description": "The organization id."
}
}
}Search content across an entire organization. GitBook REST: GET /orgs/{organizationId}/search.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
| query* | string | The full-text search query (required). |
| organizationId* | string | The organization id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"organizationId",
"query"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page."
},
"query": {
"type": "string",
"minLength": 1,
"description": "The full-text search query (required)."
},
"organizationId": {
"type": "string",
"minLength": 1,
"description": "The organization id."
}
}
}Full-text search across all pages in a space. GitBook REST: GET /spaces/{spaceId}/search.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
| query* | string | The full-text search query (required). |
| spaceId* | string | The space id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"spaceId",
"query"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page."
},
"query": {
"type": "string",
"minLength": 1,
"description": "The full-text search query (required)."
},
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
}
}
}Update a change request's subject or status. Edits draft metadata only. GitBook REST: PATCH /spaces/{spaceId}/change-requests/{changeRequestId}.
| Argument | Type | Description |
|---|---|---|
| status | string | A new status for the change request. |
| spaceId* | string | The space id. |
| subject | string | A new title/subject for the change request. |
| changeRequestId* | string | The change request id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"spaceId",
"changeRequestId"
],
"properties": {
"status": {
"type": "string",
"description": "A new status for the change request."
},
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"subject": {
"type": "string",
"description": "A new title/subject for the change request."
},
"changeRequestId": {
"type": "string",
"minLength": 1,
"description": "The change request id."
}
}
}