io.usefulapi/knowledgeowl
REMOTE · KNOWLEDGEOWL.USEFULAPI.IO · SCANNED AUG 3
Read and write knowledge-base articles, categories, snippets, glossary, readers, and search data.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score →
Endpoint Security46
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes. View diagnostics → Unverified
- HTTPS not yet verified: we couldn't determine whether a plaintext access path exists. View diagnostics → Unverified
- HSTS check failed: the Strict-Transport-Security header is absent. See how to fix → View diagnostics → Fail
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability0
- Transport check failed: declared streamable-http, but the endpoint returned HTTP 429. See how to fix → View diagnostics → Fail
Schema Quality & AI Usability0
- Schema not yet verified: we couldn't read the endpoint's schema.Unverified
Stability & Change Management0
- Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage0
- Tool coverage not yet verified: we couldn't read the endpoint's tools.Unverified
Capabilities0
- Capabilities not yet verified: we couldn't read the endpoint's capabilities.Unverified
Unverified: 4 categories
Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.
Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.
remote · knowledgeowl.usefulapi.io
claude mcp add --transport http io-usefulapi-knowledgeowl https://knowledgeowl.usefulapi.io/mcp
[mcp_servers.io-usefulapi-knowledgeowl] url = "https://knowledgeowl.usefulapi.io/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"io-usefulapi-knowledgeowl": {
"type": "remote",
"url": "https://knowledgeowl.usefulapi.io/mcp",
"enabled": true
}
}
} openclaw mcp add io-usefulapi-knowledgeowl --url https://knowledgeowl.usefulapi.io/mcp --transport streamable-http
mcp_servers:
io-usefulapi-knowledgeowl:
url: "https://knowledgeowl.usefulapi.io/mcp" {
"mcpServers": {
"io-usefulapi-knowledgeowl": {
"type": "http",
"url": "https://knowledgeowl.usefulapi.io/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 3 Aug 26 −53
- Endpoint reachability: reachable → not serving MCP ▼ security
- Authorization: pass → unverified ▼ security
- Stability: 0.20 → unverified ▼ security
- Transport: pass → fail ▼ security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: fail → unverified ▼ functional
- 2 Aug 26 +53
- Authorization: unverified → pass ▲ security
- Transport: fail → pass ▲ security
- MCP protocol: unverified → fail ▼ functional
- Endpoint reachability: not serving MCP → reachable ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Stability: unverified → 0.20 ▲ functional
- 1 Aug 26 −52
- Endpoint reachability: reachable → not serving MCP ▼ security
- Stability: 0.13 → unverified ▼ security
- Authorization: pass → unverified ▼ security
- Transport: pass → fail ▼ security
- Capabilities: fail → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- 31 Jul 26 +3
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 30 Jul 26 −2
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 29 Jul 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 28 Jul 26 0
- Stability: unverified → 0.03 ▲ functional
- 27 Jul 26 +56
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 3 Aug 2026 · Probed https://knowledgeowl.usefulapi.io/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=usefulapi.io | CN=WE1,O=Google Trust Services,C=US | 18 Jul 2026 | 16 Oct 2026 | ECDSA 256 | ECDSA-SHA256 | d9594ea7401a207c134b3eef9b01cd14 |
| SANs: usefulapi.io, knowledgeowl.usefulapi.io, *.knowledgeowl.usefulapi.io | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
DNSSEC insecure
Validation of knowledgeowl.usefulapi.io. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| io. | present | 57355 | 8 | Verified |
| usefulapi.io. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 429 |
| Header | Value |
|---|---|
| x-frame-options | SAMEORIGIN |
| referrer-policy | same-origin |
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://knowledgeowl.usefulapi.io/mcp | HTTP error | 429 | |
| http (plaintext) | http://knowledgeowl.usefulapi.io/mcp | Inconclusive | 429 |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.
create_article Create an article ~215
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.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | object | — | Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above. |
| name | string | yes | The article name/title (required). |
| project_id | string | yes | The knowledge base (project) id this article belongs to (required). |
| status | string | — | Publishing status, e.g. "published", "draft", "review". |
| url_hash | string | — | The article URL slug (e.g. "getting-started"). |
| visibility | string | — | Visibility, e.g. "public" or "private". |
No output schema declared.
No examples provided.
create_category Create a category ~208
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.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | object | — | Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above. |
| name | string | yes | The category name (required). |
| project_id | string | yes | The knowledge base (project) id this category belongs to (required). |
| status | string | — | Publishing status, e.g. "active". |
| type | string | — | The category type (e.g. "blank", "topic", "custom-content"). |
| url_hash | string | — | The category URL slug. |
| visibility | string | — | Visibility, e.g. "public" or "private". |
No output schema declared.
No examples provided.
create_glossary_term Create a glossary term ~135
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.
| Name | Type | Req | Description |
|---|---|---|---|
| definition | string | — | The term's definition. |
| fields | object | — | Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above. |
| project_id | string | yes | The knowledge base (project) id this glossary term belongs to (required). |
| term | string | yes | The glossary term (required). |
No output schema declared.
No examples provided.
create_snippet Create a snippet ~130
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.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | object | — | Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above. |
| name | string | yes | The snippet name (required). |
| project_id | string | yes | The knowledge base (project) id this snippet belongs to (required). |
No output schema declared.
No examples provided.
get_article Get an article ~54
Fetch a single article by id. KnowledgeOwl API: GET /article/{id}.json. Returns { valid, data:{...} }.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The article id (a Mongo-style hex string). |
No output schema declared.
No examples provided.
get_category Get a category ~44
Fetch a single category by id. KnowledgeOwl API: GET /category/{id}.json.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The category id (a Mongo-style hex string). |
No output schema declared.
No examples provided.
get_reader Get a reader ~44
Fetch a single reader by id. KnowledgeOwl API: GET /reader/{id}.json.
| Name | Type | Req | Description |
|---|---|---|---|
| id | string | yes | The reader id (a Mongo-style hex string). |
No output schema declared.
No examples provided.
knowledgeowl_request Raw read request ~107
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.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Full API path after the base, starting with "/", e.g. "/article.json?_page=2". |
No output schema declared.
No examples provided.
list_article_revisions List article revisions ~87
List article revision history (read-only audit trail). KnowledgeOwl API: GET /articlerevision.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_article_versions List article versions ~78
List article versions. KnowledgeOwl API: GET /articleversion.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_articles List articles ~109
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:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
| project_id | string | — | Filter to a single knowledge base (project) id. |
No output schema declared.
No examples provided.
list_authors List authors ~87
List authors/agents (the team members who write and manage content). KnowledgeOwl API: GET /agent.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_categories List categories ~107
List categories (the article tree/table of contents). KnowledgeOwl API: GET /category.json. Optionally filter by project_id. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
| project_id | string | — | Filter to a single knowledge base (project) id. |
No output schema declared.
No examples provided.
list_comments List comments ~80
List reader comments / feedback on articles. KnowledgeOwl API: GET /comment.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_files List files ~83
List files in the file library (images/attachments). KnowledgeOwl API: GET /file.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_glossary_terms List glossary terms ~84
List glossary terms and definitions. KnowledgeOwl API: GET /glossaryterm.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_readers List readers ~84
List readers (knowledge-base end users / audience accounts). KnowledgeOwl API: GET /reader.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_snippets List snippets ~78
List reusable content snippets. KnowledgeOwl API: GET /snippet.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_suggestions List search suggestions ~86
List search suggestions / reader search analytics (what readers searched for). KnowledgeOwl API: GET /suggest.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_synonyms List synonyms ~85
List search synonyms (terms treated as equivalent by search). KnowledgeOwl API: GET /synonym.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_tags List tags ~76
List article tags. KnowledgeOwl API: GET /tag.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
list_webhooks List webhooks ~79
List configured webhooks. KnowledgeOwl API: GET /webhook.json. Returns { valid, page_stats, data:[...] }.
| Name | Type | Req | Description |
|---|---|---|---|
| _page | integer | — | KnowledgeOwl pagination page number, 1-based. |
| params | object | — | Additional documented query-string filters/operators to send verbatim (merged with the typed params above). |
No output schema declared.
No examples provided.
update_article Update an article ~165
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.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | object | — | Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above. |
| id | string | yes | The article id to update (path only; required). |
| name | string | — | New article name/title. |
| status | string | — | New publishing status. |
| url_hash | string | — | New URL slug. |
| visibility | string | — | New visibility. |
No output schema declared.
No examples provided.
update_category Update a category ~157
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.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | object | — | Additional documented KnowledgeOwl fields to send in the JSON write body (e.g. current_version, body) — merged OVER the typed fields above. |
| id | string | yes | The category id to update (path only; required). |
| name | string | — | New category name. |
| status | string | — | New publishing status. |
| url_hash | string | — | New URL slug. |
| visibility | string | — | New visibility. |
No output schema declared.
No examples provided.