usefulapi

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

Claude

Open Settings → Connectors → Add custom connector
Paste this URL:
https://knowledgeowl.usefulapi.io/mcp
Authenticate with KnowledgeOwl when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

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

live26 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 26

Tool	Type	What it does
`list_articles`	read	List articles List knowledge-base articles, optionally filtered by project_id (a single knowledge base). KnowledgeOwl API: GET /article.json.
`get_article`	read	Get an article Fetch a single article by id, returning its full record. KnowledgeOwl API: GET /article/{id}.json.
`list_categories`	read	List categories List categories (the article tree / table of contents), optionally filtered by project_id. KnowledgeOwl API: GET /category.json.
`get_category`	read	Get a category Fetch a single category by id from the article tree. KnowledgeOwl API: GET /category/{id}.json.
`list_tags`	read	List tags List article tags used to label and group content. KnowledgeOwl API: GET /tag.json.
`list_snippets`	read	List snippets List reusable content snippets that can be embedded across articles. KnowledgeOwl API: GET /snippet.json.
`list_glossary_terms`	read	List glossary terms List glossary terms and their definitions. KnowledgeOwl API: GET /glossaryterm.json.
`list_comments`	read	List comments List reader comments and feedback left on articles. KnowledgeOwl API: GET /comment.json.
`list_readers`	read	List readers List readers (knowledge-base end users / audience accounts). KnowledgeOwl API: GET /reader.json.
`get_reader`	read	Get a reader Fetch a single reader by id. KnowledgeOwl API: GET /reader/{id}.json.
`list_files`	read	List files List files in the file library (images and attachments). KnowledgeOwl API: GET /file.json.
`list_article_versions`	read	List article versions List article versions. KnowledgeOwl API: GET /articleversion.json.
`list_article_revisions`	read	List article revisions List the article revision history (read-only audit trail of changes). KnowledgeOwl API: GET /articlerevision.json.
`list_suggestions`	read	List search suggestions List reader search suggestions / analytics — what readers searched for. KnowledgeOwl API: GET /suggest.json.
`list_synonyms`	read	List synonyms List search synonyms (terms treated as equivalent by search). KnowledgeOwl API: GET /synonym.json.
`list_webhooks`	read	List webhooks List configured webhooks for the account. KnowledgeOwl API: GET /webhook.json.
`list_authors`	read	List authors List authors/agents — the team members who write and manage content. KnowledgeOwl API: GET /agent.json.
`knowledgeowl_request`	read	Raw read request Power-user escape hatch: GET any KnowledgeOwl API path not covered by a dedicated tool. Read-only (GET only).
`create_article`	write	Create an article Create a new knowledge-base article. KnowledgeOwl API: POST /article.json.
`update_article`	write	Update an article Update an existing article; only included fields change. KnowledgeOwl API: PUT /article/{id}.json.
`create_category`	write	Create a category Create a new category (a node in the article tree). KnowledgeOwl API: POST /category.json.
`update_category`	write	Update a category Update an existing category; only included fields change. KnowledgeOwl API: PUT /category/{id}.json.
`create_snippet`	write	Create a snippet Create a reusable content snippet. KnowledgeOwl API: POST /snippet.json.
`create_glossary_term`	write	Create a glossary term Create a glossary term and its definition. KnowledgeOwl API: POST /glossaryterm.json.
`knowledgeowl_usage_status`	meta	Usage status (free-tier meter) Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter.
`knowledgeowl_upgrade`	meta	Upgrade to Pro (unlimited) Subscribe to the Pro plan for UNLIMITED KnowledgeOwl tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free). Returns a Stripe Checkout link.

Pricing

Plan	Price	Limit
Free	$0	100 tool calls / month
Pro	$9/mo · $90/yr	Unlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.