⏳ 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 justificationtime_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.
Metadata
Release files for toki-toki-mcp 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 | Provenance | Actions |
|---|---|---|---|---|
| toki_toki_mcp-0.1.0.tar.gz | 11.7 kB | Without provenance | Details for toki_toki_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| toki_toki_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for toki_toki_mcp-0.1.0-py3-none-any.whl |
Total release size: 23.2 kB
Release files / toki_toki_mcp-0.1.0.tar.gz
| Download URL | toki_toki_mcp-0.1.0.tar.gz |
|---|---|
| Size | 11.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
114f29acc122e82f067ab2b52b9eabb11930f869ec39d33f254033363151bdad
|
|
BLAKE2b-256 checksum How to use checksums |
623792934aa08fe53876d699ff06e988eddc7a879346117fc96a6c6df18939e2
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Release files / toki_toki_mcp-0.1.0-py3-none-any.whl
| Download URL | toki_toki_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 11.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
e3aaa522e0831d0d5c608cb062e0b3cd6935cfa6065aa531c43629b57f8ad913
|
|
BLAKE2b-256 checksum How to use checksums |
8b0498f7bd9ca3aed31fcc117e7362c18abebe65781f39498dc53a57d3b9f54d
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.10
|
Security for toki-toki-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.