# knowledgeowl MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/io-usefulapi-knowledgeowl
- Repository: https://github.com/m190/usefulapi-mcp

## Install
- Endpoint: https://knowledgeowl.usefulapi.io/mcp
- Auth: Not captured

## Setup notes
- Remote endpoint: https://knowledgeowl.usefulapi.io/mcp

## Tools
- list_articles (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:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- get_article (Get an article) - Fetch a single article by id. KnowledgeOwl API: GET /article/{id}.json. Returns { valid, data:{...} }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_categories (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:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- get_category (Get a category) - Fetch a single category by id. KnowledgeOwl API: GET /category/{id}.json. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_tags (List tags) - List article tags. KnowledgeOwl API: GET /tag.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_snippets (List snippets) - List reusable content snippets. KnowledgeOwl API: GET /snippet.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_glossary_terms (List glossary terms) - List glossary terms and definitions. KnowledgeOwl API: GET /glossaryterm.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_comments (List comments) - List reader comments / feedback on articles. KnowledgeOwl API: GET /comment.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_readers (List readers) - List readers (knowledge-base end users / audience accounts). KnowledgeOwl API: GET /reader.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- get_reader (Get a reader) - Fetch a single reader by id. KnowledgeOwl API: GET /reader/{id}.json. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_files (List files) - List files in the file library (images/attachments). KnowledgeOwl API: GET /file.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_article_versions (List article versions) - List article versions. KnowledgeOwl API: GET /articleversion.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_article_revisions (List article revisions) - List article revision history (read-only audit trail). KnowledgeOwl API: GET /articlerevision.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_suggestions (List search suggestions) - List search suggestions / reader search analytics (what readers searched for). KnowledgeOwl API: GET /suggest.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_synonyms (List synonyms) - List search synonyms (terms treated as equivalent by search). KnowledgeOwl API: GET /synonym.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_webhooks (List webhooks) - List configured webhooks. KnowledgeOwl API: GET /webhook.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- list_authors (List authors) - List authors/agents (the team members who write and manage content). KnowledgeOwl API: GET /agent.json. Returns { valid, page_stats, data:[...] }. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- knowledgeowl_request (Raw read 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. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- create_article (Create an 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. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- update_article (Update an 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. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- create_category (Create a 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. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- update_category (Update a 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. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- create_snippet (Create a 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. Endpoint: https://knowledgeowl.usefulapi.io/mcp
- create_glossary_term (Create a 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. Endpoint: https://knowledgeowl.usefulapi.io/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.usefulapi
- Version: 1.0.0
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 18, 2026
- Source: https://registry.modelcontextprotocol.io