Docuwiz MCP

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Docuwiz MCP": {
      "url": "https://mcp.docuwiz.io/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (46)

• login

  Sign in to Docuwiz with your email and password. Required before any workspace tool (guides, references, search, etc.). The session is held only in memory for this connection and is never stored or displayed.

  Parameters:

  • email (required) — string — Your Docuwiz account email.
  • password (required) — string — Your Docuwiz account password. Used once to sign in; never stored.

  Hints: read-only not declared · destructive no · idempotent not declared · open-world not declared

• logout destructive

  Sign out of Docuwiz and clear the in-memory session for this connection.

  Hints: read-only not declared · destructive yes · idempotent yes · open-world not declared

• whoami read-only

  Show the currently signed-in Docuwiz user, active workspace, and role.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• login_with_google

  Start signing in to Docuwiz through your browser (so you can use Google, SSO, or email/password). Returns a link and a short code to approve. After approving, call `complete_login`.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world yes

• complete_login

  Finish the browser sign-in started by `login_with_google` — waits for you to approve in the browser, then stores the session.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• list_workspaces read-only

  List the Docuwiz workspaces you belong to, with your role in each. The active workspace is the one you are currently signed into.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_workspace read-only

  Get details and settings for your active Docuwiz workspace.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_activity_logs read-only

  Get recent activity (who changed what) in your active workspace.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• list_references read-only

  List all API references (OpenAPI/Swagger specs) in your active workspace.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_reference read-only

  Get a single API reference — its revisions, status, and metadata — by reference id.

  Parameters:

  • referenceId (required) — string — The reference id (from list_references).

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_revision read-only

  Get the full OpenAPI/Swagger document for a specific spec revision by its schema id. Large specs are returned in slices — if the result says more characters remain, call again with the suggested `offset`.

  Parameters:

  • schemaId (required) — string — The schema id of the revision (found inside get_reference output).
  • offset — integer — Character offset to start from when the spec is larger than one response. Use the offset suggested by the previous call.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• import_reference

  Import an OpenAPI/Swagger spec as a new API reference in your workspace. Accepts JSON or YAML; YAML is converted automatically.

  Parameters:

  • name (required) — string — Display name for the reference (also used as the filename).
  • oasSpec (required) — string — The OpenAPI/Swagger document as JSON or YAML text.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• import_reference_from_url

  Import a spec that lives at a public https URL (e.g. a raw GitHub link). Use this instead of import_reference for large specs — the document is fetched server-side, so it is not subject to the client tool-argument size limit that truncates big specs pasted as text.

  Parameters:

  • name (required) — string — Display name for the reference (also used as the filename).
  • specUrl (required) — string — Public https URL to the OpenAPI/Swagger document (JSON or YAML).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world yes

• add_revision

  Add a new revision (updated spec) to an existing API reference. Accepts JSON or YAML.

  Parameters:

  • referenceId (required) — string — The reference id to add a revision to.
  • oasSpec (required) — string — The updated OpenAPI/Swagger document as JSON or YAML text.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• add_revision_from_url

  Add a new revision to an existing reference from a spec at a public https URL. Use this instead of add_revision for large specs — the document is fetched server-side, avoiding the client tool-argument size limit that truncates big specs pasted as text.

  Parameters:

  • referenceId (required) — string — The reference id to add a revision to.
  • specUrl (required) — string — Public https URL to the updated OpenAPI/Swagger document (JSON or YAML).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world yes

• publish_reference

  Publish (or change the status of) a specific revision of an API reference so it goes live in the docs.

  Parameters:

  • referenceId (required) — string — The reference id.
  • revision (required) — ['string', 'number'] — The revision number to publish.
  • status — string — Target status. Defaults to Published.

  Hints: read-only not declared · destructive not declared · idempotent yes · open-world not declared

• delete_reference destructive

  Permanently delete an API reference and all its revisions. Requires Site Admin role.

  Parameters:

  • referenceId (required) — string — The reference id to delete.

  Hints: read-only not declared · destructive yes · idempotent not declared · open-world not declared

• delete_revision destructive

  Delete a single revision of an API reference (the reference itself is kept). Requires Site Admin role.

  Parameters:

  • referenceId (required) — string — The reference id.
  • revision (required) — ['string', 'number'] — The revision number to delete.

  Hints: read-only not declared · destructive yes · idempotent not declared · open-world not declared

• list_guides read-only

  List all guides (documentation books) in your active workspace, with their versions and status.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_guide read-only

  Get a single guide with its version list and page tree, by guide id.

  Parameters:

  • guideId (required) — string — The guide id (from list_guides).

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• create_guide

  Create a new, empty guide in your active workspace.

  Parameters:

  • title (required) — string — The guide title.
  • guideType — string — Guide type. Defaults to 'guide'.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rename_guide

  Rename an existing guide.

  Parameters:

  • guideId (required) — string — The guide id.
  • name (required) — string — The new guide name.

  Hints: read-only not declared · destructive not declared · idempotent yes · open-world not declared

• delete_guide destructive

  Permanently delete a guide and all of its pages and versions.

  Parameters:

  • guideId (required) — string — The guide id to delete.

  Hints: read-only not declared · destructive yes · idempotent not declared · open-world not declared

• get_page read-only

  Get the full content of a guide page by page id. Large pages are returned in slices — if the result says more characters remain, call again with the suggested `offset`.

  Parameters:

  • pageId (required) — string — The page id.
  • offset — integer — Character offset to start from when the page is larger than one response. Use the offset suggested by the previous call.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• create_page

  Create a new page inside a guide version.

  Parameters:

  • guideId (required) — string — The guide id the page belongs to.
  • version (required) — string — The guide version (e.g. "1.0").
  • title (required) — string — The page title.
  • content — string — Page body — markdown or BlockNote JSON. May be empty for a blank page.
  • groupTitle — string — Optional existing group title to nest the page under. Omit for a top-level page.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• update_page

  Update a page's title and/or content.

  Parameters:

  • pageId (required) — string — The page id to update.
  • guideId (required) — string — The guide id the page belongs to.
  • version (required) — string — The guide version.
  • title — string — New title (omit to keep current).
  • content — string — New body — markdown or BlockNote JSON (omit to keep current).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• delete_page destructive

  Delete a page from a guide version.

  Parameters:

  • pageId (required) — string — The page id to delete.
  • guideId (required) — string — The guide id.
  • version (required) — string — The guide version.

  Hints: read-only not declared · destructive yes · idempotent not declared · open-world not declared

• create_version

  Create a new version of a guide, optionally copying content from an existing version.

  Parameters:

  • guideId (required) — string — The guide id.
  • version (required) — string — The new version label (e.g. "2.0").
  • targetVersion — string — Existing version to copy pages from (optional).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• publish_guide_version

  Publish or unpublish a guide version (set its status).

  Parameters:

  • guideId (required) — string — The guide id.
  • version (required) — string — The version label.
  • status — string — Target status. Defaults to Published.

  Hints: read-only not declared · destructive not declared · idempotent yes · open-world not declared

• delete_version destructive

  Delete a version of a guide.

  Parameters:

  • guideId (required) — string — The guide id.
  • version (required) — string — The version label to delete.

  Hints: read-only not declared · destructive yes · idempotent not declared · open-world not declared

• list_categories read-only

  List categories used to organise guides and references in your workspace.

  Parameters:

  • isCategory — boolean — Filter flag passed through to Docuwiz (optional).

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• create_category

  Create a category and optionally assign guides and references to it.

  Parameters:

  • title (required) — string — Category title.
  • description — string — Optional description.
  • selectedGuideIds — array — Guide ids to include (optional).
  • selectedReferenceIds — array — Reference ids to include (optional).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• update_category

  Update a category — rename, change description, or add/remove guides and references.

  Parameters:

  • categoryId (required) — string — The category id.
  • title — string — New title (optional).
  • description — string — New description (optional).
  • selectedGuideIds — array — Guide ids to add.
  • unselectedGuideIds — array — Guide ids to remove.
  • selectedReferenceIds — array — Reference ids to add.
  • unselectedReferenceIds — array — Reference ids to remove.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• delete_category destructive

  Delete a category (the guides/references in it are not deleted).

  Parameters:

  • categoryId (required) — string — The category id to delete.

  Hints: read-only not declared · destructive yes · idempotent not declared · open-world not declared

• list_recipes read-only

  List recipes (product guides) in your workspace.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• create_recipe

  Create a new recipe (product) with an optional set of items.

  Parameters:

  • name (required) — string — Recipe / product name.
  • items — array — Optional list of recipe items.
  • description — string — Optional description.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_recipe read-only

  Get a single recipe (product) and its items by product id.

  Parameters:

  • productId (required) — string — The recipe/product id.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• delete_recipe destructive

  Delete a recipe (product) by product id.

  Parameters:

  • productId (required) — string — The recipe/product id to delete.

  Hints: read-only not declared · destructive yes · idempotent not declared · open-world not declared

• list_templates read-only

  List available page templates (global and workspace-level).

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• get_template read-only

  Get the content of a single page template.

  Parameters:

  • templateId (required) — string — The template id.
  • scope (required) — string — Whether the template is global or workspace (tenant) scoped.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• search read-only

  Full-text search across your workspace — guide pages, API references, recipes, and endpoints.

  Parameters:

  • query (required) — string — The search query.
  • types — array — Optional content types to restrict the search to. Defaults to all.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• submit_feedback

  Send feedback about the documentation to the workspace owners.

  Parameters:

  • reaction (required) — string — A short reaction, e.g. "positive", "negative", "👍".
  • feedback (required) — string — The feedback message.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• preview_repo

  Scan a GitHub or GitLab repository for OpenAPI/Swagger specs and generate a live, shareable preview URL. No Docuwiz account or login is needed — the user just opens the URL. Public repos need no token. For private repos, ask the user for a read-only personal access token.

  Parameters:

  • repoUrl (required) — string — Full GitHub or GitLab repo URL, e.g. https://github.com/acme/api or https://github.com/acme/api/tree/develop
  • token — string — Personal access token — only for private repos. GitHub: 'repo' scope. GitLab: 'read_repository' scope.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world yes

• get_preview_status read-only

  Return the most recent preview URL generated by preview_repo in this session.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• validate_spec read-only

  Validate an OpenAPI/Swagger spec. Runs deterministic structural checks locally, and (if the client supports it) adds an AI best-practices review using the local model — no data is sent to Docuwiz.

  Parameters:

  • oasSpec (required) — string — The OpenAPI/Swagger document as JSON or YAML text.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

• enhance_spec read-only

  Improve an OpenAPI/Swagger spec's summaries and descriptions using the local model (MCP sampling) — without changing paths, methods, parameters, or schemas. Nothing is sent to Docuwiz; you can import the result with import_reference.

  Parameters:

  • oasSpec (required) — string — The OpenAPI/Swagger document as JSON or YAML text.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world not declared

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.