Skip to main content
Glama

xknow-mcp

npm license MCP

XKnow · MCP server page · Source · npm · MCP Registry

An MCP server for the XKnow Knowledge Base — a curated, cross-linked body of SEO, SaaS, and LLM-wiki knowledge. Give any MCP-capable agent (Claude, Cursor, Cline, opencode, and others) the ability to search and cite it.

  • Local and private. Runs on your machine over stdio. No server, no account, no API key.

  • Static data. The free layer is a snapshot of the public XKnow guides, bundled with the package. Nothing is fetched at query time.

  • Graph-aware. Beyond keyword search, explore_concept walks the cross-links between notes, so an agent can follow a topic instead of getting a flat list.

Quick start

Add it to your MCP client.

Claude Desktop (claude_desktop_config.json), Cursor, Cline, and most clients:

{
  "mcpServers": {
    "xknow": {
      "command": "npx",
      "args": ["-y", "xknow-mcp"]
    }
  }
}

Claude Code

claude mcp add xknow -- npx -y xknow-mcp

opencode (opencode.json)

{
  "mcp": {
    "xknow": { "type": "local", "command": ["npx", "-y", "xknow-mcp"], "enabled": true }
  }
}

Then ask your agent something like:

"Use the xknow tools to explain keyword difficulty and cite the source." "Search XKnow for SaaS pricing models and summarise the trade-offs."

Related MCP server: workspace-kb

Tools

Tool

What it does

search_knowledge

Ranked search over the knowledge base. Returns titles, snippets, and URLs.

get_page

Full text of one note by title or slug (preserves [[wikilinks]]).

explore_concept

A note plus its outbound links and backlinks — walks the knowledge graph.

list_topics

Lists every note grouped by section (seo, saas, blog).

lint_rules

The XKnow SEO/SaaS content self-check rubric — each rule with priority (P0–P3), reasoning, fix, and the knowledge-base notes that back it.

cite

Returns the canonical citation (title, description, URL) for a note.

Two knowledge layers

Layer

Content

How

Free (default)

The 57 public XKnow guides and blog posts

Bundled snapshot — just npx -y xknow-mcp

Full vault

Your purchased XKnow Knowledge Base (500+ linked notes)

npx -y xknow-mcp --vault /path/to/SEO-SaaS-Vault

The full-vault mode reads a local folder of Markdown notes, so your purchased copy never leaves your machine. Set it once with the XKNOW_VAULT environment variable if you prefer:

export XKNOW_VAULT="/path/to/SEO-SaaS-Vault"
npx -y xknow-mcp

How it works

xknow-mcp is a Node.js stdio server. The free layer is a static JSON snapshot generated from the public site and bundled in the package (data/knowledge.json); search is a small, dependency-free ranking pass over the bundled notes. Vault mode parses Markdown notes from a local folder on the fly. No network calls, no vector database, no telemetry.

Development

npm install
npm run build:data   # refresh data/knowledge.json from https://xknow.org/mcp/knowledge.json
npm run build        # tsc
npm run smoke        # exercise every tool over a real stdio connection

# also test against a local vault
SMOKE_VAULT=/path/to/SEO-SaaS-Vault npm run smoke

License

MIT — see LICENSE.

Available Tools

5 tools
citeGet a citation for a noteA

Return the canonical citation (title, description, URL) for a note, so an answer can attribute the XKnow source.

Inputs: slug (required).

explore_conceptExplore a concept and its graphA

Return a note together with the notes it links to (outbound) and the notes that link back to it (inbound). Use to walk the knowledge graph around a concept instead of a flat search.

Inputs: concept (required), depth.

get_pageGet a knowledge-base noteA

Fetch the full text of one note by title or slug. Use after search_knowledge to read the note before answering. Preserves [[wikilinks]].

Inputs: slug (required).

list_topicsList knowledge-base topicsA

List the available notes, grouped by section (seo, saas, blog). Use to discover what the knowledge base covers.

Inputs: section.

search_knowledgeSearch the XKnow knowledge baseA

Search curated, source-backed SEO, SaaS, and LLM-wiki knowledge. Returns ranked notes with a snippet and URL. Use this to ground answers about search-engine optimization, SaaS business models, or AI knowledge bases.

Inputs: query (required), limit, section.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 5 tools

    Disambiguation5/5

    Each tool targets a distinct operation: search, read, explore graph, list, and cite. No overlap in purpose or output, making selection straightforward.

    Naming Consistency4/5

    Mostly consistent verb_noun patterns (search_knowledge, get_page, explore_concept, list_topics), but 'cite' deviates as a bare verb without an object. Minor inconsistency.

    Tool Count5/5

    Five tools perfectly cover the core workflows of a knowledge retrieval server: discover, search, read, explore connections, and cite. Well-scoped with no extraneous tools.

    Completeness4/5

    Covers all essential operations for a read-only knowledge base. Missing tools for editing or adding notes, but the server appears curated and source-backed, so writes may be intentionally out of scope.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to perform local-first web search, fetch, crawl, extract, cache, research, and autonomous information gathering through MCP, with no API keys or cloud dependencies.
      841 npm
      AGPL 3.0
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables MCP-compatible AI agents to search, ask, and retrieve section-level cited answers from a local hybrid index over scattered notes, documents, and chat logs.
      -