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개
관측 실패버전이 기록되지 않음—
관측 실패버전이 기록되지 않음—