KnowledgeOwl MCP by usefulapi

by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi

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

Deletes · 6Changes · 1

Compare Registry entry

24 tools: 6 can delete or cancel things, 1 change things and 17 only read.

Scanned Oct 21, 2026

Deletes or cancels6Claude Code: deny: see these tools
Can't be undone0Claude Code: ask
Changes things1Claude Code: ask: see these tools
Only reads17Claude Code: allow: see these tools

1 check matched something in the tool definitions. No finding is not a safety guarantee. How the checks work.

claude mcp add --transport http knowledgeowl https://knowledgeowl.usefulapi.io/mcp

Findings

Matches of fixed checks, with the text they matched.

1 warn

Warnknowledgeowl_request
The server marks "knowledgeowl_request" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
Matched text
annotations: {"readOnlyHint":true}; The name "knowledgeowl_request" says "request": a word for a change.
What this check looks for

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

24 tools

Deletes or cancels 6Removes, cancels or revokes something.Claude Code: deny

create_articleMUTATES KnowledgeOwl data: creates a new article.No findings
Why it is in this group
- The name "create_article" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it
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.
Annotations the server declares
- title: Create an article
- destructiveHint: true
create_categoryMUTATES KnowledgeOwl data: creates a new category (a node in the article tree).No findings
Why it is in this group
- The name "create_category" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it
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.
Annotations the server declares
- title: Create a category
- destructiveHint: true
create_glossary_termMUTATES KnowledgeOwl data: creates a glossary term and definition.No findings
Why it is in this group
- The name "create_glossary_term" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it
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.
Annotations the server declares
- title: Create a glossary term
- destructiveHint: true
create_snippetMUTATES KnowledgeOwl data: creates a reusable content snippet.No findings
Why it is in this group
- The name "create_snippet" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it
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.
Annotations the server declares
- title: Create a snippet
- destructiveHint: true
update_articleMUTATES KnowledgeOwl data: updates an existing article.No findings
Why it is in this group
- The name "update_article" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it
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.
Annotations the server declares
- title: Update an article
- destructiveHint: true
update_categoryMUTATES KnowledgeOwl data: updates an existing category.No findings
Why it is in this group
- The name "update_category" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it
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.
Annotations the server declares
- title: Update a category
- destructiveHint: true

Changes things 1Creates or changes something that can be changed back.Claude Code: ask

knowledgeowl_requestPower-user escape hatch: GET any KnowledgeOwl API path not wrapped by a dedicated tool.1 finding
Why it is in this group
- The name "knowledgeowl_request" says "request": a word for a change.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Findings
- Warn
  The server marks "knowledgeowl_request" read-only (readOnlyHint: true), and its own name, description or input give the class "write".
  Matched text
  annotations: {"readOnlyHint":true}; The name "knowledgeowl_request" says "request": a word for a change.
  What this check looks for
Description, as the server wrote it
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.
Annotations the server declares
- title: Raw read request
- readOnlyHint: true

Only reads 17Looks things up and changes nothing.Claude Code: allow

get_articleFetch a single article by id.No findings
Why it is in this group
- The name "get_article" says "get": a word for reading.
Description, as the server wrote it
Fetch a single article by id. KnowledgeOwl API: GET /article/{id}.json. Returns { valid, data:{...} }.
Annotations the server declares
- title: Get an article
- readOnlyHint: true
get_categoryFetch a single category by id.No findings
Why it is in this group
- The name "get_category" says "get": a word for reading.
Description, as the server wrote it
Fetch a single category by id. KnowledgeOwl API: GET /category/{id}.json.
Annotations the server declares
- title: Get a category
- readOnlyHint: true
get_readerFetch a single reader by id.No findings
Why it is in this group
- The name "get_reader" says "get": a word for reading.
Description, as the server wrote it
Fetch a single reader by id. KnowledgeOwl API: GET /reader/{id}.json.
Annotations the server declares
- title: Get a reader
- readOnlyHint: true
list_article_revisionsList article revision history (read-only audit trail).No findings
Why it is in this group
- The name "list_article_revisions" says "list": a word for reading.
Description, as the server wrote it
List article revision history (read-only audit trail). KnowledgeOwl API: GET /articlerevision.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List article revisions
- readOnlyHint: true
list_article_versionsList article versions.No findings
Why it is in this group
- The name "list_article_versions" says "list": a word for reading.
Description, as the server wrote it
List article versions. KnowledgeOwl API: GET /articleversion.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List article versions
- readOnlyHint: true
list_articlesList knowledge-base articles.No findings
Why it is in this group
- The name "list_articles" says "list": a word for reading.
Description, as the server wrote 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:[...] }.
Annotations the server declares
- title: List articles
- readOnlyHint: true
list_authorsList authors/agents (the team members who write and manage content).No findings
Why it is in this group
- The name "list_authors" says "list": a word for reading.
Description, as the server wrote it
List authors/agents (the team members who write and manage content). KnowledgeOwl API: GET /agent.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List authors
- readOnlyHint: true
list_categoriesList categories (the article tree/table of contents).No findings
Why it is in this group
- The name "list_categories" says "list": a word for reading.
Description, as the server wrote it
List categories (the article tree/table of contents). KnowledgeOwl API: GET /category.json. Optionally filter by project_id. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List categories
- readOnlyHint: true
list_commentsList reader comments / feedback on articles.No findings
Why it is in this group
- The name "list_comments" says "list": a word for reading.
Description, as the server wrote it
List reader comments / feedback on articles. KnowledgeOwl API: GET /comment.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List comments
- readOnlyHint: true
list_filesList files in the file library (images/attachments).No findings
Why it is in this group
- The name "list_files" says "list": a word for reading.
Description, as the server wrote it
List files in the file library (images/attachments). KnowledgeOwl API: GET /file.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List files
- readOnlyHint: true
list_glossary_termsList glossary terms and definitions.No findings
Why it is in this group
- The name "list_glossary_terms" says "list": a word for reading.
Description, as the server wrote it
List glossary terms and definitions. KnowledgeOwl API: GET /glossaryterm.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List glossary terms
- readOnlyHint: true
list_readersList readers (knowledge-base end users / audience accounts).No findings
Why it is in this group
- The name "list_readers" says "list": a word for reading.
Description, as the server wrote it
List readers (knowledge-base end users / audience accounts). KnowledgeOwl API: GET /reader.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List readers
- readOnlyHint: true
list_snippetsList reusable content snippets.No findings
Why it is in this group
- The name "list_snippets" says "list": a word for reading.
Description, as the server wrote it
List reusable content snippets. KnowledgeOwl API: GET /snippet.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List snippets
- readOnlyHint: true
list_suggestionsList search suggestions / reader search analytics (what readers searched for).No findings
Why it is in this group
- The name "list_suggestions" says "list": a word for reading.
Description, as the server wrote it
List search suggestions / reader search analytics (what readers searched for). KnowledgeOwl API: GET /suggest.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List search suggestions
- readOnlyHint: true
list_synonymsList search synonyms (terms treated as equivalent by search).No findings
Why it is in this group
- The name "list_synonyms" says "list": a word for reading.
Description, as the server wrote it
List search synonyms (terms treated as equivalent by search). KnowledgeOwl API: GET /synonym.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List synonyms
- readOnlyHint: true
list_tagsList article tags.No findings
Why it is in this group
- The name "list_tags" says "list": a word for reading.
Description, as the server wrote it
List article tags. KnowledgeOwl API: GET /tag.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List tags
- readOnlyHint: true
list_webhooksList configured webhooks.No findings
Why it is in this group
- The name "list_webhooks" says "list": a word for reading.
Description, as the server wrote it
List configured webhooks. KnowledgeOwl API: GET /webhook.json. Returns { valid, page_stats, data:[...] }.
Annotations the server declares
- title: List webhooks
- readOnlyHint: true

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Install

Pinned to version 1.16.3. Values in angle brackets are yours to fill in.

claude mcp add --transport http knowledgeowl https://knowledgeowl.usefulapi.io/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json

{
  "permissions": {
    "allow": [
      "mcp__knowledgeowl__list_articles",
      "mcp__knowledgeowl__get_article",
      "mcp__knowledgeowl__list_categories",
      "mcp__knowledgeowl__get_category",
      "mcp__knowledgeowl__list_tags",
      "mcp__knowledgeowl__list_snippets",
      "mcp__knowledgeowl__list_glossary_terms",
      "mcp__knowledgeowl__list_comments",
      "mcp__knowledgeowl__list_readers",
      "mcp__knowledgeowl__get_reader",
      "mcp__knowledgeowl__list_files",
      "mcp__knowledgeowl__list_article_versions",
      "mcp__knowledgeowl__list_article_revisions",
      "mcp__knowledgeowl__list_suggestions",
      "mcp__knowledgeowl__list_synonyms",
      "mcp__knowledgeowl__list_webhooks",
      "mcp__knowledgeowl__list_authors"
    ],
    "ask": [
      "mcp__knowledgeowl__knowledgeowl_request"
    ],
    "deny": [
      "mcp__knowledgeowl__create_article",
      "mcp__knowledgeowl__update_article",
      "mcp__knowledgeowl__create_category",
      "mcp__knowledgeowl__update_category",
      "mcp__knowledgeowl__create_snippet",
      "mcp__knowledgeowl__create_glossary_term"
    ]
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as knowledgeowl. Review it before you use it.

Keep track

Get told when this server's tools change: a new tool, a new description, a new class.

https://anlyon.dev/servers/io.usefulapi/knowledgeowl/changes.xml

An Atom feed. Works in any feed reader or Slack's RSS app.

Anlyon alternative

7 of these tools change something. Run those as governed actions.

Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.

Anlyon does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.

Import an OpenAPI spec →

Compare with other servers for the same product.

Source: MCP Registry · repository. Synced Oct 21, 2026, 19:23 UTC.

For agents: Markdown · JSON · report this listing