Skip to main content

⏳ Toki Toki no Mi

Toki Toki no Mi icon

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.

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)

Source distribution for toki-toki-mcp 0.1.0
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)

Table of built distributions (wheels) for toki-toki-mcp 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page