{
  "markdown": "<!-- mcp-name: io.github.xfloukiex-lab/toki-toki -->\n# ⏳ Toki Toki no Mi\n\n<img src=\"icon.png\" width=\"120\" align=\"right\" alt=\"Toki Toki no Mi icon\">\n\nAn MCP server that remembers **why** each decision was made — a local, searchable decision log.\n\nA [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server — one\nfocused tool you plug into an MCP-compatible client (Claude Desktop, Claude Code,\nCursor, and others).\n\n## What it does\n\nA conversation's context window forgets. A few sessions later, the reasoning\nbehind an architectural choice is gone, and you re-litigate decisions you already\nsettled — or quietly reverse them without noticing.\n\nToki Toki no Mi is a **causality ledger**. It records each decision, the\nalternatives you rejected, and why you chose as you did, then lets your assistant\nretrieve that history later — and flag a new proposal that contradicts a past\ndecision.\n\n## Usage\n\nTwo tools:\n\n- `log_causality_point` — record a decision, the rejected alternatives, and the justification\n- `time_leap_retrieval` — recall past decisions (all of them, or filtered by keyword)\n\nDecisions are stored locally in SQLite under `~/.grandline/` and also mirrored to\na Markdown file, so any external search tool can be pointed at the folder to read\nthem.\n\n**Tool reference:** `log_causality_point(decision_made, alternatives_rejected, justification)` · `time_leap_retrieval(query: str = \"\")`\n\n## How it works\n\n**Self-contained, no API key, fully local.** The ledger is a single SQLite file\non your machine with no external dependencies. Nothing is sent anywhere.\n\n## Install\n\nRequires Python 3.10 or newer.\n\n```bash\npip install toki-toki-mcp\n```\n\nThis installs the `toki-toki` command.\n\nThen register it with your MCP client — either run `claude mcp add toki-toki -- toki-toki`,\nor add this to the client's config (e.g. `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"toki-toki\": { \"command\": \"toki-toki\" }\n  }\n}\n```\n\nRestart the client and the tool is available.\n\n## The Grand Line stack\n\nToki Toki no Mi is part of a four-tool set. Each tool stands alone, but installing\nall of them unlocks a final surprise via **Laugh Tale**.\n\n| | Package | |\n|---|---|---|\n| 🗿 | [`road-poneglyph`](https://github.com/xfloukiex-lab/road-poneglyph) | Road Poneglyph |\n| ⚔️ | [`conquerors-haki`](https://github.com/xfloukiex-lab/conquerors-haki) | Conqueror's Haki |\n| ⏳ | [`toki-toki`](https://github.com/xfloukiex-lab/toki-toki) | Toki Toki no Mi  ·  **← this repo** |\n| 🏴‍☠️ | [`laugh-tale`](https://github.com/xfloukiex-lab/laugh-tale) | Laugh Tale |\n\n## Develop\n\n```bash\ngit clone https://github.com/xfloukiex-lab/toki-toki\ncd toki-toki\npython -m venv .venv && . .venv/Scripts/activate   # macOS/Linux: source .venv/bin/activate\npip install -e \".[dev]\"\npython tests/test_toki_toki.py\n```\n\n## Attribution & license\n\nReleased under the **Apache-2.0** license. The icon is original artwork\n(see `icon.svg`), generated locally; the repository ships no third-party assets.\n\n*This is a fan-inspired project. It is not affiliated with, sponsored by, or\nendorsed by the creators or rights holders of* One Piece *(Eiichiro Oda /\nShueisha / Toei Animation). \"One Piece\" and related names are used only as\nthematic flavour and remain the property of their respective owners.*\n",
  "bytes": 3294,
  "sha": "110e0303240d1e4f9080938fd8325d7843604092ce9b6e6b3405ffb27162f035",
  "repo_slug": "xfloukiex-lab/toki-toki",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_xfloukiex_lab_toki_toki_e12e33b5/readme"
}