{
  "markdown": "<!-- mcp-name: io.github.xfloukiex-lab/road-poneglyph -->\n# 🗿 Road Poneglyph\n\n<img src=\"icon.png\" width=\"120\" align=\"right\" alt=\"Road Poneglyph icon\">\n\nAn MCP server that reviews a plan for what's **missing** — the assumptions, risks, and gaps you never wrote down.\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\nLanguage models are good at responding to what's in front of them and poor at\nnoticing what *isn't* there. Ask one to critique a plan and it tends to react to\nthe words on the page rather than the unstated assumptions behind them.\n\nRoad Poneglyph runs a structured **pre-mortem** over a plan and reports only the\nnegative space — what was assumed without proof, what was technically glossed\nover, and what was skipped on the way to shipping.\n\n## Usage\n\nPoint your assistant at a plan and ask it to *read the poneglyph*. The tool\nreturns a focused analysis in three sections:\n\n- **The Void Century** — unstated assumptions the plan depends on\n- **Hidden Reef** — omitted technical and architectural risks\n- **The Treacherous Seas** — operational and execution blind spots\n\n**Tool reference:** `read_poneglyph(current_plan: str, project_type: str = \"Software\")`\n\n## How it works\n\n**No API key, no cost, nothing leaves your machine.** The server doesn't call a\nlanguage model itself — it returns a carefully engineered analysis prompt that\nthe model you're *already* talking to executes. Zero credentials, zero network\ncalls.\n\n## Install\n\nRequires Python 3.10 or newer.\n\n```bash\npip install road-poneglyph-mcp\n```\n\nThis installs the `road-poneglyph` command.\n\nThen register it with your MCP client — either run `claude mcp add road-poneglyph -- road-poneglyph`,\nor add this to the client's config (e.g. `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"road-poneglyph\": { \"command\": \"road-poneglyph\" }\n  }\n}\n```\n\nRestart the client and the tool is available.\n\n## The Grand Line stack\n\nRoad Poneglyph 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  ·  **← this repo** |\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 |\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/road-poneglyph\ncd road-poneglyph\npython -m venv .venv && . .venv/Scripts/activate   # macOS/Linux: source .venv/bin/activate\npip install -e \".[dev]\"\npython tests/test_road_poneglyph.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": 3346,
  "sha": "25b7d8360aa0c960c8e49626c9db3619423501e162bc8718e9405a8a1255df12",
  "repo_slug": "xfloukiex-lab/road-poneglyph",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_xfloukiex_lab_road_poneglyph_a4c19599/readme"
}