GitBook MCP by usefulapi is an MCP server published by io.usefulapi, hosted at gitbook.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 14 tools, including gitbook_get_current_user, gitbook_list_organizations, gitbook_list_spaces, gitbook_get_space, gitbook_list_pages.
Read spaces, collections, pages and content; search docs and manage GitBook organization spaces.
3,965 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the profile of the authenticated GitBook user. GitBook REST: GET /user.
No parameters.
{
"name": "gitbook_get_current_user",
"title": "Get current user",
"description": "Get the profile of the authenticated GitBook user. GitBook REST: GET /user.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "Get current user",
"readOnlyHint": true
}
}List the organizations the authenticated user belongs to. GitBook REST: GET /orgs.
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
{
"name": "gitbook_list_organizations",
"title": "List organizations",
"description": "List the organizations the authenticated user belongs to. GitBook REST: GET /orgs.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List organizations",
"readOnlyHint": true
}
}List all spaces in an organization. GitBook REST: GET /orgs/{organizationId}/spaces.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
| organizationId * | string | The organization id. |
{
"name": "gitbook_list_spaces",
"title": "List spaces",
"description": "List all spaces in an organization. GitBook REST: GET /orgs/{organizationId}/spaces.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List spaces",
"readOnlyHint": true
}
}Get full details of a space by its ID. GitBook REST: GET /spaces/{spaceId}.
| Parameter | Type | Description |
|---|---|---|
| spaceId * | string | The space id. |
{
"name": "gitbook_get_space",
"title": "Get space",
"description": "Get full details of a space by its ID. GitBook REST: GET /spaces/{spaceId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"spaceId"
],
"properties": {
"spaceId": {
"type": "string",
"minLength": 1,
"description": "The space id."
}
}
},
"annotations": {
"title": "Get space",
"readOnlyHint": true
}
}List all pages in a space with their hierarchy and metadata. GitBook REST: GET /spaces/{spaceId}/content/pages.
| Parameter | Type | Description |
|---|---|---|
| spaceId * | string | The space id. |
| computed | boolean | Include computed properties in the response. |
| metadata | boolean | Include page metadata in the response. |
{
"name": "gitbook_list_pages",
"title": "List pages",
"description": "List all pages in a space with their hierarchy and metadata. GitBook REST: GET /spaces/{spaceId}/content/pages.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List pages",
"readOnlyHint": true
}
}Get a single page's content from a space by its page ID. GitBook REST: GET /spaces/{spaceId}/content/page/{pageId}.
| Parameter | Type | Description |
|---|---|---|
| format | string | Response format — 'document' (structured, default) or 'markdown'. |
| pageId * | string | The page id. |
| spaceId * | string | The space id. |
{
"name": "gitbook_get_page",
"title": "Get page",
"description": "Get a single page's content from a space by its page ID. GitBook REST: GET /spaces/{spaceId}/content/page/{pageId}.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Get page",
"readOnlyHint": true
}
}Full-text search across all pages in a space. GitBook REST: GET /spaces/{spaceId}/search.
| Parameter | 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. |
{
"name": "gitbook_search_space",
"title": "Search space",
"description": "Full-text search across all pages in a space. GitBook REST: GET /spaces/{spaceId}/search.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Search space",
"readOnlyHint": true
}
}Search content across an entire organization. GitBook REST: GET /orgs/{organizationId}/search.
| Parameter | 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. |
{
"name": "gitbook_search_organization",
"title": "Search organization",
"description": "Search content across an entire organization. GitBook REST: GET /orgs/{organizationId}/search.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Search organization",
"readOnlyHint": true
}
}List all collections in an organization. GitBook REST: GET /orgs/{organizationId}/collections.
| Parameter | 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. |
{
"name": "gitbook_list_collections",
"title": "List collections",
"description": "List all collections in an organization. GitBook REST: GET /orgs/{organizationId}/collections.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List collections",
"readOnlyHint": true
}
}Get a collection by its ID. GitBook REST: GET /collections/{collectionId}.
| Parameter | Type | Description |
|---|---|---|
| collectionId * | string | The collection id. |
{
"name": "gitbook_get_collection",
"title": "Get collection",
"description": "Get a collection by its ID. GitBook REST: GET /collections/{collectionId}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"collectionId"
],
"properties": {
"collectionId": {
"type": "string",
"minLength": 1,
"description": "The collection id."
}
}
},
"annotations": {
"title": "Get collection",
"readOnlyHint": true
}
}List change requests for a space. GitBook REST: GET /spaces/{spaceId}/change-requests.
| Parameter | 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. |
{
"name": "gitbook_list_change_requests",
"title": "List change requests",
"description": "List change requests for a space. GitBook REST: GET /spaces/{spaceId}/change-requests.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List change requests",
"readOnlyHint": true
}
}List top-level comments posted on a space. GitBook REST: GET /spaces/{spaceId}/comments.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Results per page. |
| status | string | Filter by comment status. |
| spaceId * | string | The space id. |
{
"name": "gitbook_list_comments",
"title": "List comments",
"description": "List top-level comments posted on a space. GitBook REST: GET /spaces/{spaceId}/comments.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List comments",
"readOnlyHint": true
}
}Create a new draft change request (branch) in a space. Safe: creates a draft; publishes nothing. GitBook REST: POST /spaces/{spaceId}/change-requests.
| Parameter | Type | Description |
|---|---|---|
| spaceId * | string | The space id. |
| subject | string | A title/subject for the change request. |
{
"name": "gitbook_create_change_request",
"title": "Create change request",
"description": "Create a new draft change request (branch) in a space. Safe: creates a draft; publishes nothing. GitBook REST: POST /spaces/{spaceId}/change-requests.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Create change request",
"destructiveHint": true
}
}Update a change request's subject or status. Edits draft metadata only. GitBook REST: PATCH /spaces/{spaceId}/change-requests/{changeRequestId}.
| Parameter | 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. |
{
"name": "gitbook_update_change_request",
"title": "Update change request",
"description": "Update a change request's subject or status. Edits draft metadata only. GitBook REST: PATCH /spaces/{spaceId}/change-requests/{changeRequestId}.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Update change request",
"destructiveHint": true
}
}Tools for GitBook, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which spaces do we have in our documentation organization?"; "Search our docs for anything about refund policy."; "Show me the page structure of our customer help space.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes GitBook data. Free plan: 50 tool calls per month. Run gitbook_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run gitbook_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run gitbook_upgrade without a plan: it returns both plans, each with a payment link for the user to open. gitbook_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.