Skip to content
MCP server

KnowledgeOwl MCP by usefulapi

Read and write knowledge-base articles, categories, snippets, glossary, readers, and…

Install
Runs
Remotely
Version
1.41.0
Listing updated
4 days ago

About KnowledgeOwl MCP by usefulapi

KnowledgeOwl MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

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

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://knowledgeowl.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "knowledgeowl": {
      "url": "https://knowledgeowl.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "knowledgeowl": {
      "type": "http",
      "url": "https://knowledgeowl.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (24)

Read directly from the server.

knowledgeowl_list_articles
List knowledge-base articles. KnowledgeOwl API: GET /article.json. Optionally filter by project_id (the knowledge base). Returns the list envelope { valid, page_stats, data:[...] }.
knowledgeowl_get_article
Fetch a single article by id. KnowledgeOwl API: GET /article/{id}.json. Returns { valid, data:{...} }.
knowledgeowl_list_categories
List categories (the article tree/table of contents). KnowledgeOwl API: GET /category.json. Optionally filter by project_id. Returns { valid, page_stats, data:[...] }.
knowledgeowl_get_category
Fetch a single category by id. KnowledgeOwl API: GET /category/{id}.json.
knowledgeowl_list_tags
List article tags. KnowledgeOwl API: GET /tag.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_snippets
List reusable content snippets. KnowledgeOwl API: GET /snippet.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_glossary_terms
List glossary terms and definitions. KnowledgeOwl API: GET /glossaryterm.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_comments
List reader comments / feedback on articles. KnowledgeOwl API: GET /comment.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_readers
List readers (knowledge-base end users / audience accounts). KnowledgeOwl API: GET /reader.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_get_reader
Fetch a single reader by id. KnowledgeOwl API: GET /reader/{id}.json.
knowledgeowl_list_files
List files in the file library (images/attachments). KnowledgeOwl API: GET /file.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_article_versions
List article versions. KnowledgeOwl API: GET /articleversion.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_article_revisions
List article revision history (read-only audit trail). KnowledgeOwl API: GET /articlerevision.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_suggestions
List search suggestions / reader search analytics (what readers searched for). KnowledgeOwl API: GET /suggest.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_synonyms
List search synonyms (terms treated as equivalent by search). KnowledgeOwl API: GET /synonym.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_webhooks
List configured webhooks. KnowledgeOwl API: GET /webhook.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_list_authors
List authors/agents (the team members who write and manage content). KnowledgeOwl API: GET /agent.json. Returns { valid, page_stats, data:[...] }.
knowledgeowl_request
Power-user escape hatch: GET any KnowledgeOwl API path not wrapped by a dedicated tool. READ-ONLY — only GET is allowed. Pass the FULL API path after the base, starting with a slash, INCLUDING any query string, e.g. "/article.json?_page=2" or "/category/abc123.json". Returns the parsed JSON.
knowledgeowl_create_article
MUTATES KnowledgeOwl data: creates a new article. KnowledgeOwl API: POST /article.json (JSON). Required by the API: project_id, name, status, url_hash, visibility, and current_version (a nested object `{ <lang>: { title, body, ... } }` — pass it via the `fields` passthrough). Returns the created article.
knowledgeowl_update_article
MUTATES KnowledgeOwl data: updates an existing article. KnowledgeOwl API: PUT /article/{id}.json (JSON — only included fields change). Use the `fields` passthrough for current_version (title/body) and any other documented field. The path id is never sent in the body.
knowledgeowl_create_category
MUTATES KnowledgeOwl data: creates a new category (a node in the article tree). KnowledgeOwl API: POST /category.json (JSON). Required by the API: type, project_id, url_hash, name, visibility, status. Pass extra documented fields via `fields`. Returns the created category.
knowledgeowl_update_category
MUTATES KnowledgeOwl data: updates an existing category. KnowledgeOwl API: PUT /category/{id}.json (JSON — only included fields change). Use the `fields` passthrough for any other documented field. The path id is never sent in the body.
knowledgeowl_create_snippet
MUTATES KnowledgeOwl data: creates a reusable content snippet. KnowledgeOwl API: POST /snippet.json (JSON). Pass the snippet body/content and any other documented field via `fields` (e.g. snippet_text/body). Returns the created snippet.
knowledgeowl_create_glossary_term
MUTATES KnowledgeOwl data: creates a glossary term and definition. KnowledgeOwl API: POST /glossaryterm.json (JSON). Pass extra documented fields via `fields`. Returns the created glossary term.

KnowledgeOwl MCP by usefulapi FAQ

How do I add KnowledgeOwl MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http knowledgeowl https://knowledgeowl.usefulapi.io/mcp