Update languages

MCPupdate_languages

WRITE$0.00001 / call

Features

Set the languages the site is served in — the call for 'we need docs in Spanish and German', «нужна документация на испанском». default_language is the docs' own source language — what the content is ALREADY written in, e.g. after writing or reading pages that are in Russian, call this with default_language: 'ru' so the site (and the Users/Activity table's "Original" language column) knows. It is free on every plan, unlike the rest of this tool: it is a fact about the docs, not a purchase. enabled_languages — TRANSLATING into other languages — REQUIRES PRO plan and REPLACES the whole set, so pass the existing languages plus the new ones (read them from get_workspace first). Enabling a language does not translate anything by itself: run_translation_pass starts the first pass, and later passes follow the workspace's translation mode. Supported codes: en, es, fr, de, pt, it, ru, zh, ja, ko, ar, hi, tr, pl, nl. Translated pages are served at https://.docsbook.io/// — language is always a PATH SEGMENT under the user subdomain, never a subdomain itself (never https://.docsbook.io/). default_language is silently dropped from enabled_languages if included, since the docs are already written in it and there is nothing to translate.

Input3

Authorizationheaderrequired

Your API key, for the REST call. Sent from your browser straight to the API — never to Docsbook, never stored.

workspace_idstringrequired

Numeric workspace id — OR the project as the user names it: 'owner/repo', the repo name alone, the site's display name, its docs URL or custom domain. Text is resolved server-side; an ambiguous name returns the candidates instead of guessing, so pass what the user said rather than calling list_workspaces first.

enabled_languagesstring[]

ISO language codes to enable

default_languagestring

Default language code

Output28

idnumber

repoFullNamestring

'owner/repo', or a Docsbook-hosted placeholder when the site was created from scratch.

customNamestring

null

site_urlstring

The live docs URL — report this verbatim, never build one from repoFullName.

customDomainstring

null

planstring

free | pro | business

visibilitystring

public | private

not_discoverablestring

Present ONLY when visibility is private, i.e. when no crawler and no answer engine can open this site. Says what that rules out — keyword work, SERP meta, crawler-facing sitemap/llms.txt tuning, backlinks, ranking readings, being cited by ChatGPT or Perplexity — and what is worth the run instead. A private SOURCE REPOSITORY is NOT this and does not rule anything out: Docsbook serves indexed public sites from private repositories.

discoverability_blocked_bystring

Alongside not_discoverable: "private" (the owner's choice) or "plan_locked" (the plan lapsed and Docsbook made it private — tell the owner before doing any work).

aiEnabledboolean

hasApiKeyboolean

Whether a REST bearer exists — never the key itself.

hasCustomAiKeyboolean

hasCustomTranslationKeyboolean

hasPasswordboolean

hasSourceOfTruthGraphboolean

Whether the semantic index has ever been built.

ssoobject

{ configured: false } or { issuer, clientId, allowedDomain, configured: true }.

plan_capabilitiesobject

What this plan unlocks.

upgrade_hintstring

null

cta_urlstring

null

cta_hintstring

average_product_price_centsnumber

null

revenue_hintstring

site_source_urlstring

null

site_source_hintstring

subheaderFoldersobject[]

Top-level folder placements, each carrying the placement it resolves to — "subheader_tab" (a tab in the category strip, its pages kept out of the root sidebar tree), "sidebar_tree" (an ordinary folder in the sidebar), "subheader_tab_and_sidebar_tree" (both) or "hidden". Read placement rather than re-deriving it from inSubheader / showInSidebar / hiddenInSidebar.

navigation_placement_hintstring

Present when the project has folder placements: what each one resolves to and why a tab's hiddenInSidebar is not a defect to fix.

publish_mismatch_warningstring

Present only when the live site does not show what was published.

……

Plus every other project setting on this row — branding colors/fonts, navigation, UI toggles, SEO/GEO/AEO flags, access rules, domain, languages — minus secrets.

Example input

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_languages",
    "arguments": {
      "workspace_id": "<workspace_id>"
    }
  }
}

Example output

{
  "id": 0,
  "repoFullName": "<repoFullName>",
  "customName": "<customName>",
  "site_url": "<site_url>",
  "customDomain": "<customDomain>",
  "plan": "<plan>",
  "visibility": "<visibility>",
  "not_discoverable": "<not_discoverable>",
  "discoverability_blocked_by": "<discoverability_blocked_by>",
  "aiEnabled": true,
  "hasApiKey": true,
  "hasCustomAiKey": true,
  "hasCustomTranslationKey": true,
  "hasPassword": true,
  "hasSourceOfTruthGraph": true,
  "sso": {},
  "plan_capabilities": {},
  "upgrade_hint": "<upgrade_hint>",
  "cta_url": "<cta_url>",
  "cta_hint": "<cta_hint>",
  "average_product_price_cents": "<average_product_price_cents>",
  "revenue_hint": "<revenue_hint>",
  "site_source_url": "<site_source_url>",
  "site_source_hint": "<site_source_hint>",
  "subheaderFolders": [],
  "navigation_placement_hint": "<navigation_placement_hint>",
  "publish_mismatch_warning": "<publish_mismatch_warning>",
  "…": "<…>"
}

更新于 Sep 24, 2026