usefulapi

GitBook MCP server. Read spaces, collections, pages and content; search docs and manage GitBook organization spaces.

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://gitbook.usefulapi.io/mcp
Authenticate with GitBook when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "gitbook": {
      "url": "https://gitbook.usefulapi.io/mcp"
    }
  }
}

live16 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 16

Tool	Type	What it does
`gitbook_get_current_user`	read	Get current user Get the profile of the authenticated GitBook user. GitBook REST: GET /user.
`gitbook_list_organizations`	read	List organizations List the organizations the authenticated user belongs to. GitBook REST: GET /orgs.
`gitbook_list_spaces`	read	List spaces List all spaces in an organization. GitBook REST: GET /orgs/{organizationId}/spaces.
`gitbook_get_space`	read	Get space Get full details of a space by its ID. GitBook REST: GET /spaces/{spaceId}.
`gitbook_list_pages`	read	List pages List all pages in a space with their hierarchy and metadata. GitBook REST: GET /spaces/{spaceId}/content/pages.
`gitbook_get_page`	read	Get page Get a single page's content from a space by its page ID. GitBook REST: GET /spaces/{spaceId}/content/page/{pageId}.
`gitbook_search_space`	read	Search space Full-text search across all pages in a space. GitBook REST: GET /spaces/{spaceId}/search.
`gitbook_search_organization`	read	Search organization Search content across an entire organization. GitBook REST: GET /orgs/{organizationId}/search.
`gitbook_list_collections`	read	List collections List all collections in an organization. GitBook REST: GET /orgs/{organizationId}/collections.
`gitbook_get_collection`	read	Get collection Get a collection by its ID. GitBook REST: GET /collections/{collectionId}.
`gitbook_list_change_requests`	read	List change requests List change requests for a space. GitBook REST: GET /spaces/{spaceId}/change-requests.
`gitbook_list_comments`	read	List comments List top-level comments posted on a space. GitBook REST: GET /spaces/{spaceId}/comments.
`gitbook_create_change_request`	write	Create change request Create a new draft change request (branch) in a space. Safe: creates a draft; publishes nothing. GitBook REST: POST /spaces/{spaceId}/change-requests.
`gitbook_update_change_request`	write	Update change request Update a change request's subject or status. Edits draft metadata only. GitBook REST: PATCH /spaces/{spaceId}/change-requests/{changeRequestId}.
`gitbook_usage_status`	meta	Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached.
`gitbook_upgrade`	meta	Upgrade to Pro (unlimited) Subscribe to Pro for unlimited tool calls, monthly ($9) or yearly ($90). Returns a Stripe Checkout link.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.