Skip to main content

mcp-curiosity-engine

Surface the notes you forgot you wrote — DMN replay for markdown vaults.

Surface the notes you've forgotten you wrote. Uses wikilink graph structure + file mtime to identify dormant notes (low link-in count, old, isolated) and the DMN-inspired replay cycle pattern from cognitive neuroscience: sample dormant notes with bias (40% random / 30% least-linked / 30% orphaned), generate cross-domain bridge queries between them, and surface the unexpected connections. Breaks the confirmation-bias loop where you only revisit the notes you already remember.

Install

pip install mcp-curiosity-engine
# or
uvx mcp-curiosity-engine

Usage

Claude Code

claude mcp add mcp-curiosity-engine -- mcp-curiosity-engine

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "curiosity_engine": {
      "command": "uvx",
      "args": ["mcp-curiosity-engine"]
    }
  }
}

MCP Tools

Tool Tier Description
find_dormant_notes Free List notes that are structurally dormant — low incoming wikilink count AND old mtime. These are the notes most at risk of being forgotten.
find_orphan_notes Free List notes with zero incoming wikilinks — structurally isolated, the extreme case of dormancy.
suggest_replay_cycle Pro Run the full DMN-inspired replay cycle: sample dormant notes with bias (40% random / 30% least-linked / 30% orphans), extract their concepts, generate cross-domain bridge queries between them, return notes to revisit. The core moat.
find_cross_domain_bridges Pro Surface pairs of notes from DIFFERENT top-level directories that share concepts. These are the surprise connections — ideas that span your vault's silos.
random_deep_cut Pro Pull a single random dormant note for serendipitous rediscovery. Think of it as your vault's shuffle-play button.

Pro tier

Unlocks the full DMN replay cycle, cross-domain bridge discovery, and random deep-cut sampling.

License activation — any one of these works:

# 1. Environment variable
export CURIOSITY_ENGINE_LICENSE="eyJhbGc..."

# 2. CLI flag
mcp-curiosity-engine --license-key "eyJhbGc..."

# 3. Config file
echo "eyJhbGc..." > ~/.mcp-curiosity-engine/license.jwt

Licenses are verified fully offline — no phone-home, no activation server. Get a license at https://github.com/onetrueclaude-creator/mcp-curiosity-engine#pro-tier.

Requirements

  • Python 3.10+

License

MIT

Metadata

Release files for mcp-curiosity-engine 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for mcp-curiosity-engine 0.1.0
File Size Uploaded
mcp_curiosity_engine-0.1.0.tar.gz 12.4 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for mcp-curiosity-engine 0.1.0
File Interpreter ABI Platform
mcp_curiosity_engine-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 26.5 kB

Release files / mcp_curiosity_engine-0.1.0.tar.gz

Download URL mcp_curiosity_engine-0.1.0.tar.gz
Size 12.4 kB
Tags Source
SHA-256 checksum
How to use checksums
6fadb961407f9b95f7c5c69a6cb3bace842f9e6981f53cccc4614d133b124a2d
BLAKE2b-256 checksum
How to use checksums
92f64b46c67c0745e469db0c960c81e8dbf14b7756da20af4740d32199ecd5b4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.4

Release files / mcp_curiosity_engine-0.1.0-py3-none-any.whl

Download URL mcp_curiosity_engine-0.1.0-py3-none-any.whl
Size 14.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
9b81485b5882ed4f202b34cd4800f9ce21df0229cc01c9e97326492f4f47f33b
BLAKE2b-256 checksum
How to use checksums
913a6aadf0277df057ed681bb6d06b43b5895f35243027bc6f48689c3fd9ea33
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.14.4

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page