@open-and-async/mcp 0.0.1

package/CODE-LICENSE.md

@@ -0,0 +1,29 @@
+# Code license
+
+**This license governs the software in this package — the files under `src/`.**
+It does **not** apply to the bundled data file `data/book.json`, which is
+licensed separately under [`DATA-LICENSE.md`](DATA-LICENSE.md).
+
+---
+
+MIT License
+
+Copyright © 2026 Open & Async LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/DATA-LICENSE.md

@@ -0,0 +1,36 @@
+# Data license
+
+**This license governs the data file `data/book.json` only.** The software in
+this package (the files under `src/`) is licensed separately under the MIT
+License — see [`CODE-LICENSE.md`](CODE-LICENSE.md).
+
+---
+
+Copyright © 2026 Open & Async LLC. All rights reserved.
+
+`data/book.json` is a derived work of the book *Open and Async* by Ben Balter.
+It contains the book's already-public summaries (outline, chapter TL;DRs,
+key takeaways, taglines) and reviewed, paraphrased framework material. It does
+**not** contain the book's prose.
+
+Permission is granted to use `data/book.json` **solely as part of operating the
+`@open-and-async/mcp` software** (for example, when the MCP server reads it to
+answer a tool call). This is a license to use, not a transfer of any right in
+the underlying work.
+
+You may **not**, without prior written permission from Open & Async LLC:
+
+- redistribute `data/book.json`, in whole or in part, as a standalone dataset
+  or as part of any package other than `@open-and-async/mcp`;
+- create derivative datasets, compilations, or databases from it;
+- use it, in whole or in part, as training, fine-tuning, or evaluation data for
+  any machine-learning model.
+
+Brief quotation of individual taglines or summaries for review, commentary, or
+attribution is fine and encouraged.
+
+The full work — the stories, the voice, and the argument — is the book.
+Get it at <https://open-and-async.com>.
+
+For permissions beyond this license, contact Open & Async LLC via
+<https://open-and-async.com>.

package/LICENSE

@@ -0,0 +1,35 @@
+Licensing
+=========
+
+This project is split-licensed. There is no single license that covers the
+whole repository — the code and the bundled data are governed by different
+terms, so please refer to the right one for what you intend to use.
+
+Code
+----
+
+Everything under `src/` (the MCP server software) is licensed under the MIT
+License. You may use, modify, and redistribute it freely under those terms.
+
+    See CODE-LICENSE.md for the full text.
+
+Data
+----
+
+The bundled data file `data/book.json` is NOT open source. It is proprietary
+content — © 2026 Open & Async LLC, derived from the book *Open and Async* by
+Ben Balter — and is licensed only for use as part of operating the
+`@open-and-async/mcp` software. Redistribution as a standalone dataset,
+derivative datasets, and use as machine-learning training data are not
+permitted.
+
+    See DATA-LICENSE.md for the full terms.
+
+---
+
+In short: the software is MIT; the book's summaries are not. Mixing the two
+(for example, redistributing `data/book.json` under the MIT terms above) is not
+permitted. When in doubt, the per-file licenses above control.
+
+For permissions beyond these licenses, contact Open & Async LLC via
+<https://open-and-async.com>.

package/README.md

@@ -0,0 +1,108 @@
+# Open and Async — MCP Server
+
+Bring async-first working practices into your editor and AI assistant. This
+[Model Context Protocol](https://modelcontextprotocol.io) server gives your AI the
+tools to draft a decision doc, turn a meeting into an async artifact, pressure-test a
+status update, or settle a sync-vs-async debate — without leaving the tools you
+already work in.
+
+It's the method from **[Open and Async](https://open-and-async.com)** — the
+collaborative software-development playbook for remote and distributed teams — as
+working tools, not reading.
+
+## What you can do with it
+
+- **Stop writing decision docs from a blank page.** Hand your AI the decision and the
+  options; get back a structured ADR scaffold — context, tradeoffs, the call, and how
+  reversible it is.
+- **Turn "let's hop on a call" into an artifact.** Give it a meeting's purpose and
+  agenda; get the async equivalent with an owner and a deadline.
+- **Ship status updates that don't blindside anyone.** Score a draft against the
+  "work loudly / no surprises" rubric and get concrete fixes before you post it.
+- **Settle sync vs. async in seconds.** Describe the task; get a recommendation and
+  the rule behind it.
+- **Run a standup without a meeting.** Drop in a structured async-standup template
+  your team can adopt today.
+- **Win the "async is too slow" argument.** Map common objections to a ready reframe,
+  pull role-aware guidance, or search the book's principles — each answer cited and
+  linked.
+
+## Install
+
+**Claude Code:**
+
+```sh
+claude mcp add open-async -- npx -y @open-and-async/mcp
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "open-async": {
+      "command": "npx",
+      "args": ["-y", "@open-and-async/mcp"]
+    }
+  }
+}
+```
+
+Any MCP client that speaks stdio works the same way: run `npx @open-and-async/mcp`.
+
+## The toolbox
+
+### Method tools — pure utility, use them on any project
+
+| Tool | What it does |
+| --- | --- |
+| `draft_decision_doc` | Decision + options → a structured ADR/decision-doc scaffold (context, options, tradeoffs, decision, reversibility). |
+| `convert_meeting_to_async` | Meeting purpose/agenda → the async equivalent (artifact, owner, deadline). |
+| `score_status_update` | Scores a draft update against the "work loudly / no surprises" rubric and suggests fixes. |
+| `run_async_standup` | A structured async-standup template a team can adopt. |
+| `triage_sync_vs_async` | Recommends sync vs async for a task, with the decision rule. |
+
+### Reference tools — the book's thinking, on demand
+
+| Tool | What it does |
+| --- | --- |
+| `book_outline` | Sections + chapters + one-line TL;DRs. The map. |
+| `get_chapter_summary` | A chapter's TL;DR + taglines + read-the-chapter link. |
+| `search_principles` | Keyword search over the summary corpus; short cited snippets. |
+| `handle_objection` | Maps skepticism ("async is slow") to the book's reframe. |
+| `get_guidance` | Role-aware (`manager`/`ic`) guidance for a topic. |
+| `get_taglines` | Taglines + their `/q/<slug>` quote-card URLs. |
+
+### Resources
+
+- `book://outline` — sections, chapters, TL;DRs (JSON)
+- `book://taglines` — taglines + quote-card URLs (JSON)
+
+### Prompts
+
+Parameterized templates you invoke directly from your client:
+`async-standup`, `write-adr`, `meeting-to-issue`, `weekly-update`.
+
+## Good to know
+
+**It's a real tool, not a paywall.** The method tools work on their own — no book
+required. The reference tools answer from the book's already-public summaries and a
+paraphrased framework layer, always capped, always cited, always linked back so you
+can go deeper. No verbatim book prose is bundled (the only data file is
+`data/book.json`), so what you install is genuinely useful, not a teaser.
+
+**Staying current.** `data/book.json` ships with a `version` that tracks the book's
+edition, so the server can tell you which edition it's based on and re-sync when a new
+one lands.
+
+## Licensing
+
+This package is split-licensed — see [LICENSE](LICENSE) for the overview:
+
+- **Code** (everything under `src/`) — [MIT](CODE-LICENSE.md).
+- **Data** (`data/book.json`) — proprietary; © Open & Async LLC. You may use it only
+  as part of running this software. No redistribution as a standalone dataset, no
+  derivative datasets, no model training. See [DATA-LICENSE.md](DATA-LICENSE.md).
+
+The full work — the stories, the voice, the complete argument — lives in the book:
+**[open-and-async.com](https://open-and-async.com)**.