toki-toki-mcp

⏳ Toki Toki no Mi

An MCP server that remembers why each decision was made — a local, searchable decision log.

A Model Context Protocol (MCP) server — one focused tool you plug into an MCP-compatible client (Claude Desktop, Claude Code, Cursor, and others).

What it does

A conversation's context window forgets. A few sessions later, the reasoning behind an architectural choice is gone, and you re-litigate decisions you already settled — or quietly reverse them without noticing.

Toki Toki no Mi is a causality ledger. It records each decision, the alternatives you rejected, and why you chose as you did, then lets your assistant retrieve that history later — and flag a new proposal that contradicts a past decision.

Usage

Two tools:

• log_causality_point — record a decision, the rejected alternatives, and the justification
• time_leap_retrieval — recall past decisions (all of them, or filtered by keyword)

Decisions are stored locally in SQLite under ~/.grandline/ and also mirrored to a Markdown file, so any external search tool can be pointed at the folder to read them.

Tool reference: log_causality_point(decision_made, alternatives_rejected, justification) · time_leap_retrieval(query: str = "")

How it works

Self-contained, no API key, fully local. The ledger is a single SQLite file on your machine with no external dependencies. Nothing is sent anywhere.

Install

Requires Python 3.10 or newer.

pip install toki-toki-mcp

This installs the toki-toki command.

Then register it with your MCP client — either run claude mcp add toki-toki -- toki-toki, or add this to the client's config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "toki-toki": { "command": "toki-toki" }
  }
}

Restart the client and the tool is available.

The Grand Line stack

Toki Toki no Mi is part of a four-tool set. Each tool stands alone, but installing all of them unlocks a final surprise via Laugh Tale.

	Package
🗿	road-poneglyph	Road Poneglyph
⚔️	conquerors-haki	Conqueror's Haki
⏳	toki-toki	Toki Toki no Mi · ← this repo
🏴‍☠️	laugh-tale	Laugh Tale

Develop

git clone https://github.com/xfloukiex-lab/toki-toki
cd toki-toki
python -m venv .venv && . .venv/Scripts/activate   # macOS/Linux: source .venv/bin/activate
pip install -e ".[dev]"
python tests/test_toki_toki.py

Attribution & license

Released under the Apache-2.0 license. The icon is original artwork (see icon.svg), generated locally; the repository ships no third-party assets.

This is a fan-inspired project. It is not affiliated with, sponsored by, or endorsed by the creators or rights holders of One Piece (Eiichiro Oda / Shueisha / Toei Animation). "One Piece" and related names are used only as thematic flavour and remain the property of their respective owners.