# KnowledgeOwl MCP by usefulapi

> KnowledgeOwl MCP by usefulapi is an MCP server. Read and write knowledge-base articles, categories, snippets, glossary, readers, and search data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/knowledgeowl/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/knowledgeowl
- **MCP Registry name:** io.usefulapi/knowledgeowl
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://knowledgeowl.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/knowledgeowl-mcp-by-usefulapi
