Metadata-Version: 2.4
Name: conquerors-haki-mcp
Version: 0.1.0
Summary: Conqueror's Haki — a Grand Line MCP server.
Author-email: VektorGeist LLC <floukie@vektorgeist.com>
Maintainer-email: VektorGeist LLC <floukie@vektorgeist.com>
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/xfloukiex-lab/conquerors-haki
Project-URL: Repository, https://github.com/xfloukiex-lab/conquerors-haki
Project-URL: Issues, https://github.com/xfloukiex-lab/conquerors-haki/issues
Keywords: mcp,mcp-server,model-context-protocol,claude,claude-code,ai-agents
Classifier: Development Status :: 4 - Beta
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.0
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

<!-- mcp-name: io.github.xfloukiex-lab/conquerors-haki -->
# ⚔️ Conqueror's Haki

<img src="icon.png" width="120" align="right" alt="Conqueror's Haki icon">

An MCP server that cuts a long list down to the **one to three things that actually matter right now**.

A [Model Context Protocol](https://modelcontextprotocol.io) (MCP) server — one
focused tool you plug into an MCP-compatible client (Claude Desktop, Claude Code,
Cursor, and others).

## What it does

Models tend to treat every item on a list as equally worthy of attention. That's
the opposite of prioritization. Real prioritization means deciding what to
*ignore*.

Conqueror's Haki takes a list and a single goal, forces a ruthless head-to-head
ranking, and eliminates everything that doesn't directly serve that goal.

## Usage

Give it your backlog and a North Star (e.g. *"Launch a paid MVP in two weeks"*).
It returns:

- **The Conquered** — what was eliminated, each with a one-line reason it's a distraction
- **The Standing Kings** — the survivors, strictly ranked (at most three)
- **Reason for Dominance** — why each survivor earns the focus

Set `strictness_level="Overwhelming"` to force exactly **one** survivor.

**Tool reference:** `assert_conquerors_haki(items_to_evaluate: list[str], north_star_goal: str, strictness_level: str = "Supreme King")`

## How it works

**No API key, no cost, nothing leaves your machine.** The server returns an
engineered ranking prompt that your existing model executes — it makes no
language-model call of its own.

## Install

Requires Python 3.10 or newer.

```bash
pip install conquerors-haki-mcp
```

This installs the `conquerors-haki` command.

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

```json
{
  "mcpServers": {
    "conquerors-haki": { "command": "conquerors-haki" }
  }
}
```

Restart the client and the tool is available.

## The Grand Line stack

Conqueror's Haki 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`](https://github.com/xfloukiex-lab/road-poneglyph) | Road Poneglyph |
| ⚔️ | [`conquerors-haki`](https://github.com/xfloukiex-lab/conquerors-haki) | Conqueror's Haki  ·  **← this repo** |
| ⏳ | [`toki-toki`](https://github.com/xfloukiex-lab/toki-toki) | Toki Toki no Mi |
| 🏴‍☠️ | [`laugh-tale`](https://github.com/xfloukiex-lab/laugh-tale) | Laugh Tale |

## Develop

```bash
git clone https://github.com/xfloukiex-lab/conquerors-haki
cd conquerors-haki
python -m venv .venv && . .venv/Scripts/activate   # macOS/Linux: source .venv/bin/activate
pip install -e ".[dev]"
python tests/test_conquerors_haki.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.*
