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)
| File | Size | Uploaded | |
|---|---|---|---|
| mcp_curiosity_engine-0.1.0.tar.gz | 12.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| 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
|