GitBook MCP by usefulapi
Read spaces, collections, pages and content; search docs and manage GitBook organization spaces.
Sollte ich dies verwenden
Qualität und Sicherheit
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"gitbook": {
"url": "https://gitbook.usefulapi.io/mcp"
}
}
}Remote-Endpunkte
https://gitbook.usefulapi.io/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (14)
🟢gitbook_get_current_user
Get the profile of the authenticated GitBook user. GitBook REST: GET /user.
Eingabe-Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_list_organizations(page, limit)
List the organizations the authenticated user belongs to. GitBook REST: GET /orgs.
Eingabe-Schema
{
"type": "object",
"properties": {
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_list_spaces(organizationId, page, limit)
List all spaces in an organization. GitBook REST: GET /orgs/{organizationId}/spaces.
Eingabe-Schema
{
"type": "object",
"properties": {
"organizationId": {
"type": "string",
"minLength": 1,
"description": "The organization id."
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_get_space(spaceId)
Get full details of a space by its ID. GitBook REST: GET /spaces/{spaceId}.
Eingabe-Schema
{
"type": "object",
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
}
},
"required": [
"spaceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_list_pages(spaceId, metadata, computed)
List all pages in a space with their hierarchy and metadata. GitBook REST: GET /spaces/{spaceId}/content/pages.
Eingabe-Schema
{
"type": "object",
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"metadata": {
"description": "Include page metadata in the response.",
"type": "boolean"
},
"computed": {
"description": "Include computed properties in the response.",
"type": "boolean"
}
},
"required": [
"spaceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_get_page(spaceId, pageId, format)
Get a single page's content from a space by its page ID. GitBook REST: GET /spaces/{spaceId}/content/page/{pageId}.
Eingabe-Schema
{
"type": "object",
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"pageId": {
"type": "string",
"minLength": 1,
"description": "The page id."
},
"format": {
"description": "Response format — 'document' (structured, default) or 'markdown'.",
"type": "string",
"enum": [
"document",
"markdown"
]
}
},
"required": [
"spaceId",
"pageId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_search_space(spaceId, query, page, limit)
Full-text search across all pages in a space. GitBook REST: GET /spaces/{spaceId}/search.
Eingabe-Schema
{
"type": "object",
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"query": {
"type": "string",
"minLength": 1,
"description": "The full-text search query (required)."
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"spaceId",
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_search_organization(organizationId, query, page, limit)
Search content across an entire organization. GitBook REST: GET /orgs/{organizationId}/search.
Eingabe-Schema
{
"type": "object",
"properties": {
"organizationId": {
"type": "string",
"minLength": 1,
"description": "The organization id."
},
"query": {
"type": "string",
"minLength": 1,
"description": "The full-text search query (required)."
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"organizationId",
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_list_collections(organizationId, page, limit, nested)
List all collections in an organization. GitBook REST: GET /orgs/{organizationId}/collections.
Eingabe-Schema
{
"type": "object",
"properties": {
"organizationId": {
"type": "string",
"minLength": 1,
"description": "The organization id."
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"nested": {
"description": "Include nested (sub-)collections in the response.",
"type": "boolean"
}
},
"required": [
"organizationId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_get_collection(collectionId)
Get a collection by its ID. GitBook REST: GET /collections/{collectionId}.
Eingabe-Schema
{
"type": "object",
"properties": {
"collectionId": {
"type": "string",
"minLength": 1,
"description": "The collection id."
}
},
"required": [
"collectionId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_list_change_requests(spaceId, status, page, limit)
List change requests for a space. GitBook REST: GET /spaces/{spaceId}/change-requests.
Eingabe-Schema
{
"type": "object",
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"status": {
"description": "Filter by change-request status, e.g. 'open', 'merged', 'draft'.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"spaceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢gitbook_list_comments(spaceId, status, page, limit)
List top-level comments posted on a space. GitBook REST: GET /spaces/{spaceId}/comments.
Eingabe-Schema
{
"type": "object",
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"status": {
"description": "Filter by comment status.",
"type": "string"
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"limit": {
"description": "Results per page.",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"spaceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gitbook_create_change_request(spaceId, subject)
Create a new draft change request (branch) in a space. Safe: creates a draft; publishes nothing. GitBook REST: POST /spaces/{spaceId}/change-requests.
Eingabe-Schema
{
"type": "object",
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"subject": {
"description": "A title/subject for the change request.",
"type": "string"
}
},
"required": [
"spaceId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴gitbook_update_change_request(spaceId, changeRequestId, subject, status)
Update a change request's subject or status. Edits draft metadata only. GitBook REST: PATCH /spaces/{spaceId}/change-requests/{changeRequestId}.
Eingabe-Schema
{
"type": "object",
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
},
"changeRequestId": {
"type": "string",
"minLength": 1,
"description": "The change request id."
},
"subject": {
"description": "A new title/subject for the change request.",
"type": "string"
},
"status": {
"description": "A new status for the change request.",
"type": "string"
}
},
"required": [
"spaceId",
"changeRequestId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Nachweis