Tarot Documentation

Tarot is a connected note-taking app with wikilinks, backlinks, graph view, and built-in MCP server for AI agent integration.

Quick Start

  1. Create an account at tarot.parlmarket.xyz
  2. Start writing notes with Markdown
  3. Use [[Note Title]] to link notes
  4. Press Ctrl+P to search
  5. Click the graph icon to visualize connections

Architecture

┌──────────────┐     ┌────────────┐     ┌──────────┐
│  Web App    │──── │  API      │──── │  Vault   │
│  :3333      │     │  :3456    │     │  JSON    │
└──────────────┘     └────┬───────┘     └──────────┘
                          │
                    ┌─────▼──────┐
                    │  MCP       │
                    │  Server    │
                    │  (stdio)   │
                    └────────────┘

Tech Stack

ComponentTechnology
FrontendNext.js 16 + Tailwind CSS
BackendNode.js HTTP (no framework)
StorageJSON files in vault directory
AuthToken-based + API keys
MCP@modelcontextprotocol/sdk
Markdownreact-markdown + remark-gfm