knowledgeowl_create_article

MUTATES KnowledgeOwl data: creates a new article. KnowledgeOwl API: POST /article.json (JSON). Required by the API: project_id, name, status, url_hash, visibility, and current_version (a nested object `{ <lang>: { title, body, ... } }` — pass it via the `fields` passthrough). Returns the created article.

destructive

Argument	Type	Description
name*	string	The article name/title (required).
fields	object	Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.
status	string	Publishing status, e.g. "published", "draft", "review".
url_hash	string	The article URL slug (e.g. "getting-started").
project_id*	string	The knowledge base (project) id this article belongs to (required).
visibility	string	Visibility, e.g. "public" or "private".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The article name/title (required)."
    },
    "fields": {
      "type": "object",
      "description": "Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "status": {
      "type": "string",
      "description": "Publishing status, e.g. \"published\", \"draft\", \"review\"."
    },
    "url_hash": {
      "type": "string",
      "description": "The article URL slug (e.g. \"getting-started\")."
    },
    "project_id": {
      "type": "string",
      "description": "The knowledge base (project) id this article belongs to (required)."
    },
    "visibility": {
      "type": "string",
      "description": "Visibility, e.g. \"public\" or \"private\"."
    }
  }
}

knowledgeowl_create_category

MUTATES KnowledgeOwl data: creates a new category (a node in the article tree). KnowledgeOwl API: POST /category.json (JSON). Required by the API: type, project_id, url_hash, name, visibility, status. Pass extra documented fields via `fields`. Returns the created category.

destructive

Argument	Type	Description
name*	string	The category name (required).
type	string	The category type (e.g. "blank", "topic", "custom-content").
fields	object	Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.
status	string	Publishing status, e.g. "active".
url_hash	string	The category URL slug.
project_id*	string	The knowledge base (project) id this category belongs to (required).
visibility	string	Visibility, e.g. "public" or "private".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The category name (required)."
    },
    "type": {
      "type": "string",
      "description": "The category type (e.g. \"blank\", \"topic\", \"custom-content\")."
    },
    "fields": {
      "type": "object",
      "description": "Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "status": {
      "type": "string",
      "description": "Publishing status, e.g. \"active\"."
    },
    "url_hash": {
      "type": "string",
      "description": "The category URL slug."
    },
    "project_id": {
      "type": "string",
      "description": "The knowledge base (project) id this category belongs to (required)."
    },
    "visibility": {
      "type": "string",
      "description": "Visibility, e.g. \"public\" or \"private\"."
    }
  }
}

knowledgeowl_create_glossary_term

MUTATES KnowledgeOwl data: creates a glossary term and definition. KnowledgeOwl API: POST /glossaryterm.json (JSON). Pass extra documented fields via `fields`. Returns the created glossary term.

destructive

Argument	Type	Description
term*	string	The glossary term (required).
fields	object	Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.
definition	string	The term's definition.
project_id*	string	The knowledge base (project) id this glossary term belongs to (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_id",
    "term"
  ],
  "properties": {
    "term": {
      "type": "string",
      "description": "The glossary term (required)."
    },
    "fields": {
      "type": "object",
      "description": "Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "definition": {
      "type": "string",
      "description": "The term's definition."
    },
    "project_id": {
      "type": "string",
      "description": "The knowledge base (project) id this glossary term belongs to (required)."
    }
  }
}

knowledgeowl_create_snippet

MUTATES KnowledgeOwl data: creates a reusable content snippet. KnowledgeOwl API: POST /snippet.json (JSON). Pass the snippet body/content and any other documented field via `fields` (e.g. snippet_text/body). Returns the created snippet.

destructive

Argument	Type	Description
name*	string	The snippet name (required).
fields	object	Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.
project_id*	string	The knowledge base (project) id this snippet belongs to (required).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project_id",
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "The snippet name (required)."
    },
    "fields": {
      "type": "object",
      "description": "Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "project_id": {
      "type": "string",
      "description": "The knowledge base (project) id this snippet belongs to (required)."
    }
  }
}

knowledgeowl_get_article

Fetch a single article by id. KnowledgeOwl API: GET /article/{id}.json. Returns { valid, data:{...} }.

read-only

Argument	Type	Description
id*	string	The article id (a Mongo-style hex string).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The article id (a Mongo-style hex string)."
    }
  }
}

knowledgeowl_get_category

Fetch a single category by id. KnowledgeOwl API: GET /category/{id}.json.

read-only

Argument	Type	Description
id*	string	The category id (a Mongo-style hex string).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The category id (a Mongo-style hex string)."
    }
  }
}

knowledgeowl_get_reader

Fetch a single reader by id. KnowledgeOwl API: GET /reader/{id}.json.

read-only

Argument	Type	Description
id*	string	The reader id (a Mongo-style hex string).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The reader id (a Mongo-style hex string)."
    }
  }
}

knowledgeowl_list_article_revisions

List article revision history (read-only audit trail). KnowledgeOwl API: GET /articlerevision.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_article_versions

List article versions. KnowledgeOwl API: GET /articleversion.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_articles

List knowledge-base articles. KnowledgeOwl API: GET /article.json. Optionally filter by project_id (the knowledge base). Returns the list envelope { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).
project_id	string	Filter to a single knowledge base (project) id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "project_id": {
      "type": "string",
      "description": "Filter to a single knowledge base (project) id."
    }
  }
}

knowledgeowl_list_authors

List authors/agents (the team members who write and manage content). KnowledgeOwl API: GET /agent.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_categories

List categories (the article tree/table of contents). KnowledgeOwl API: GET /category.json. Optionally filter by project_id. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).
project_id	string	Filter to a single knowledge base (project) id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "project_id": {
      "type": "string",
      "description": "Filter to a single knowledge base (project) id."
    }
  }
}

knowledgeowl_list_comments

List reader comments / feedback on articles. KnowledgeOwl API: GET /comment.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_files

List files in the file library (images/attachments). KnowledgeOwl API: GET /file.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_glossary_terms

List glossary terms and definitions. KnowledgeOwl API: GET /glossaryterm.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_readers

List readers (knowledge-base end users / audience accounts). KnowledgeOwl API: GET /reader.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_snippets

List reusable content snippets. KnowledgeOwl API: GET /snippet.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_suggestions

List search suggestions / reader search analytics (what readers searched for). KnowledgeOwl API: GET /suggest.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_synonyms

List search synonyms (terms treated as equivalent by search). KnowledgeOwl API: GET /synonym.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_tags

List article tags. KnowledgeOwl API: GET /tag.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_list_webhooks

List configured webhooks. KnowledgeOwl API: GET /webhook.json. Returns { valid, page_stats, data:[...] }.

read-only

Argument	Type	Description
_page	integer	KnowledgeOwl pagination page number, 1-based.
params	object	Additional documented query-string filters/operators to send verbatim (merged with the typed params above).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "_page": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": 1,
      "description": "KnowledgeOwl pagination page number, 1-based."
    },
    "params": {
      "type": "object",
      "description": "Additional documented query-string filters/operators to send verbatim (merged with the typed params above).",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    }
  }
}

knowledgeowl_request

Power-user escape hatch: GET any KnowledgeOwl API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Pass the FULL API path after the base, starting with a slash, INCLUDING any query string, e.g. "/article.json?_page=2" or "/category/abc123.json". Returns the parsed JSON.

read-only

Argument	Type	Description
path*	string	Full API path after the base, starting with "/", e.g. "/article.json?_page=2".

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Full API path after the base, starting with \"/\", e.g. \"/article.json?_page=2\"."
    }
  }
}

knowledgeowl_update_article

MUTATES KnowledgeOwl data: updates an existing article. KnowledgeOwl API: PUT /article/{id}.json (JSON — only included fields change). Use the `fields` passthrough for current_version (title/body) and any other documented field. The path id is never sent in the body.

destructive

Argument	Type	Description
id*	string	The article id to update (path only; required).
name	string	New article name/title.
fields	object	Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.
status	string	New publishing status.
url_hash	string	New URL slug.
visibility	string	New visibility.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The article id to update (path only; required)."
    },
    "name": {
      "type": "string",
      "description": "New article name/title."
    },
    "fields": {
      "type": "object",
      "description": "Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "status": {
      "type": "string",
      "description": "New publishing status."
    },
    "url_hash": {
      "type": "string",
      "description": "New URL slug."
    },
    "visibility": {
      "type": "string",
      "description": "New visibility."
    }
  }
}

knowledgeowl_update_category

MUTATES KnowledgeOwl data: updates an existing category. KnowledgeOwl API: PUT /category/{id}.json (JSON — only included fields change). Use the `fields` passthrough for any other documented field. The path id is never sent in the body.

destructive

Argument	Type	Description
id*	string	The category id to update (path only; required).
name	string	New category name.
fields	object	Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.
status	string	New publishing status.
url_hash	string	New URL slug.
visibility	string	New visibility.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "The category id to update (path only; required)."
    },
    "name": {
      "type": "string",
      "description": "New category name."
    },
    "fields": {
      "type": "object",
      "description": "Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above.",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {}
    },
    "status": {
      "type": "string",
      "description": "New publishing status."
    },
    "url_hash": {
      "type": "string",
      "description": "New URL slug."
    },
    "visibility": {
      "type": "string",
      "description": "New visibility."
    }
  }
}

KnowledgeOwl MCP by usefulapi

Try it

knowledgeowl_create_article Destructive

KnowledgeOwl MCP by usefulapi

Try it

knowledgeowl_create_article Destructive

Tools (24)