KnowledgeOwl MCP by usefulapi

Read and write knowledge-base articles, categories, snippets, glossary, readers, and search data.

使うべきか

品質と安全性

A
説明の品質
100%
スキーマの完全性
94%
命名の品質
77%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(4)

  • LOWTool 'knowledgeowl_list_glossary_terms' name length outside 3-30 rangeknowledgeowl_list_glossary_terms 内
  • LOWTool 'knowledgeowl_list_article_versions' name length outside 3-30 rangeknowledgeowl_list_article_versions 内
  • LOWTool 'knowledgeowl_list_article_revisions' name length outside 3-30 rangeknowledgeowl_list_article_revisions 内
  • LOWTool 'knowledgeowl_create_glossary_term' name length outside 3-30 rangeknowledgeowl_create_glossary_term 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~4,342トークン数(ツール定義)
~1.4 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 3.39%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

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

リモートエンドポイント

https://knowledgeowl.usefulapi.io/mcpstreamable-http

できること

ツール一覧

ツール(24)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢knowledgeowl_list_articles(project_id, _page, params)

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:[...] }.

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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

入力スキーマ

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

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.

入力スキーマ

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

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.

入力スキーマ

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

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.

入力スキーマ

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

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.

入力スキーマ

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

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.

入力スキーマ

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

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.

入力スキーマ

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

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.

入力スキーマ

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

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 24 件
検証済みバージョンは記録されていませんツール 24 件
検証済みバージョンは記録されていませんツール 24 件
検証済みバージョンは記録されていませんツール 24 件
観測失敗バージョンは記録されていません—
観測失敗バージョンは記録されていません—