KnowledgeOwl MCP by usefulapi is an MCP server published by io.usefulapi, hosted at knowledgeowl.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 24 tools, including knowledgeowl_list_articles, knowledgeowl_get_article, knowledgeowl_list_categories, knowledgeowl_get_category, knowledgeowl_list_tags.
Read and write knowledge-base articles, categories, snippets, glossary, readers, and search data.
4,002 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
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:[...] }.
| Parameter | 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. |
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.
{
"name": "knowledgeowl_list_articles",
"title": "List articles",
"description": "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:[...] }.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List articles",
"readOnlyHint": true
}
}Fetch a single article by id. KnowledgeOwl API: GET /article/{id}.json. Returns { valid, data:{...} }.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The article id (a Mongo-style hex string). |
{
"name": "knowledgeowl_get_article",
"title": "Get an article",
"description": "Fetch a single article by id. KnowledgeOwl API: GET /article/{id}.json. Returns { valid, data:{...} }.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get an article",
"readOnlyHint": true
}
}List categories (the article tree/table of contents). KnowledgeOwl API: GET /category.json. Optionally filter by project_id. Returns { valid, page_stats, data:[...] }.
| Parameter | 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. |
{
"name": "knowledgeowl_list_categories",
"title": "List categories",
"description": "List categories (the article tree/table of contents). KnowledgeOwl API: GET /category.json. Optionally filter by project_id. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "List categories",
"readOnlyHint": true
}
}Fetch a single category by id. KnowledgeOwl API: GET /category/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The category id (a Mongo-style hex string). |
{
"name": "knowledgeowl_get_category",
"title": "Get a category",
"description": "Fetch a single category by id. KnowledgeOwl API: GET /category/{id}.json.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get a category",
"readOnlyHint": true
}
}List article tags. KnowledgeOwl API: GET /tag.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_tags",
"title": "List tags",
"description": "List article tags. KnowledgeOwl API: GET /tag.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List tags",
"readOnlyHint": true
}
}List reusable content snippets. KnowledgeOwl API: GET /snippet.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_snippets",
"title": "List snippets",
"description": "List reusable content snippets. KnowledgeOwl API: GET /snippet.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List snippets",
"readOnlyHint": true
}
}List glossary terms and definitions. KnowledgeOwl API: GET /glossaryterm.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_glossary_terms",
"title": "List glossary terms",
"description": "List glossary terms and definitions. KnowledgeOwl API: GET /glossaryterm.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List glossary terms",
"readOnlyHint": true
}
}List reader comments / feedback on articles. KnowledgeOwl API: GET /comment.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_comments",
"title": "List comments",
"description": "List reader comments / feedback on articles. KnowledgeOwl API: GET /comment.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List comments",
"readOnlyHint": true
}
}List readers (knowledge-base end users / audience accounts). KnowledgeOwl API: GET /reader.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_readers",
"title": "List readers",
"description": "List readers (knowledge-base end users / audience accounts). KnowledgeOwl API: GET /reader.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List readers",
"readOnlyHint": true
}
}Fetch a single reader by id. KnowledgeOwl API: GET /reader/{id}.json.
| Parameter | Type | Description |
|---|---|---|
| id * | string | The reader id (a Mongo-style hex string). |
{
"name": "knowledgeowl_get_reader",
"title": "Get a reader",
"description": "Fetch a single reader by id. KnowledgeOwl API: GET /reader/{id}.json.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Get a reader",
"readOnlyHint": true
}
}List files in the file library (images/attachments). KnowledgeOwl API: GET /file.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_files",
"title": "List files",
"description": "List files in the file library (images/attachments). KnowledgeOwl API: GET /file.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List files",
"readOnlyHint": true
}
}List article versions. KnowledgeOwl API: GET /articleversion.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_article_versions",
"title": "List article versions",
"description": "List article versions. KnowledgeOwl API: GET /articleversion.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List article versions",
"readOnlyHint": true
}
}List article revision history (read-only audit trail). KnowledgeOwl API: GET /articlerevision.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_article_revisions",
"title": "List article revisions",
"description": "List article revision history (read-only audit trail). KnowledgeOwl API: GET /articlerevision.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List article revisions",
"readOnlyHint": true
}
}List search suggestions / reader search analytics (what readers searched for). KnowledgeOwl API: GET /suggest.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_suggestions",
"title": "List search suggestions",
"description": "List search suggestions / reader search analytics (what readers searched for). KnowledgeOwl API: GET /suggest.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List search suggestions",
"readOnlyHint": true
}
}List search synonyms (terms treated as equivalent by search). KnowledgeOwl API: GET /synonym.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_synonyms",
"title": "List synonyms",
"description": "List search synonyms (terms treated as equivalent by search). KnowledgeOwl API: GET /synonym.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List synonyms",
"readOnlyHint": true
}
}List configured webhooks. KnowledgeOwl API: GET /webhook.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_webhooks",
"title": "List webhooks",
"description": "List configured webhooks. KnowledgeOwl API: GET /webhook.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List webhooks",
"readOnlyHint": true
}
}List authors/agents (the team members who write and manage content). KnowledgeOwl API: GET /agent.json. Returns { valid, page_stats, data:[...] }.
| Parameter | 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). |
{
"name": "knowledgeowl_list_authors",
"title": "List authors",
"description": "List authors/agents (the team members who write and manage content). KnowledgeOwl API: GET /agent.json. Returns { valid, page_stats, data:[...] }.",
"inputSchema": {
"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"
]
}
}
}
},
"annotations": {
"title": "List authors",
"readOnlyHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| path * | string | Full API path after the base, starting with "/", e.g. "/article.json?_page=2". |
{
"name": "knowledgeowl_request",
"title": "Raw read request",
"description": "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.",
"inputSchema": {
"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\"."
}
}
},
"annotations": {
"title": "Raw read request",
"readOnlyHint": true
}
}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.
| Parameter | 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". |
{
"name": "knowledgeowl_create_article",
"title": "Create an article",
"description": "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.",
"inputSchema": {
"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\"."
}
}
},
"annotations": {
"title": "Create an article",
"destructiveHint": true
}
}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.
| Parameter | 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. |
{
"name": "knowledgeowl_update_article",
"title": "Update an article",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Update an article",
"destructiveHint": true
}
}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.
| Parameter | 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". |
{
"name": "knowledgeowl_create_category",
"title": "Create a category",
"description": "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.",
"inputSchema": {
"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\"."
}
}
},
"annotations": {
"title": "Create a category",
"destructiveHint": true
}
}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.
| Parameter | 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. |
{
"name": "knowledgeowl_update_category",
"title": "Update a category",
"description": "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.",
"inputSchema": {
"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."
}
}
},
"annotations": {
"title": "Update a category",
"destructiveHint": true
}
}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.
| Parameter | 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). |
{
"name": "knowledgeowl_create_snippet",
"title": "Create a snippet",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Create a snippet",
"destructiveHint": true
}
}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.
| Parameter | 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). |
{
"name": "knowledgeowl_create_glossary_term",
"title": "Create a glossary term",
"description": "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.",
"inputSchema": {
"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)."
}
}
},
"annotations": {
"title": "Create a glossary term",
"destructiveHint": true
}
}Tools for KnowledgeOwl, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "List the articles in the Billing category that we have not updated this year."; "Show the comments that readers left on articles this month."; "Draft a new article "How to reset your password" in the Account category.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes KnowledgeOwl data. Free plan: 50 tool calls per month. Run knowledgeowl_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 knowledgeowl_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 knowledgeowl_upgrade without a plan: it returns both plans, each with a payment link for the user to open. knowledgeowl_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.