awnode 0.3.3__tar.gz → 0.3.4__tar.gz

{awnode-0.3.3 → awnode-0.3.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: awnode
-Version: 0.3.3
+Version: 0.3.4
 Summary: awnode — lightweight local gateway for AitherOS
 Project-URL: Homepage, https://aitherium.com
 Author-email: Aitherium <hello@aitherium.com>
@@ -11,7 +11,7 @@ Requires-Python: >=3.10
 Requires-Dist: awdk>=1.3.0
 Requires-Dist: fastapi>=0.109.0
 Requires-Dist: httpx>=0.26.0
-Requires-Dist: mcp<2.0.0,>=1.0.0
+Requires-Dist: mcp<3.0.0,>=1.0.0
 Requires-Dist: pyyaml>=6.0
 Requires-Dist: uvicorn[standard]>=0.27.0
 Provides-Extra: all
@@ -282,7 +282,7 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awsettings](https://github.com/Aitherium/awsettings) | Your agent's permissions and config, following you to the next machine | [docs](https://aitherium.github.io/awsettings/) |
 | [awavatar](https://github.com/Aitherium/awavatar) | One character spec in, a rigged, animated, multi-style avatar pack out | [docs](https://aitherium.github.io/awavatar/) |
 
-**Built on** [llama.cpp](https://github.com/ggml-org/llama.cpp) · [vLLM](https://github.com/vllm-project/vllm) · [ComfyUI](https://github.com/comfyanonymous/ComfyUI) · [CentOS Stream](https://www.centos.org/centos-stream/) · [Podman](https://github.com/containers/podman) · [Docker](https://github.com/moby/moby) · [LanceDB](https://github.com/lancedb/lancedb) · [WireGuard](https://www.wireguard.com/) · [FFmpeg](https://ffmpeg.org/) · [Blender + Rigify](https://www.blender.org/) · [headroom](https://github.com/headroomlabs-ai/headroom) · [SANA](https://github.com/NVlabs/Sana) · [Hunyuan3D](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) · [repowise](https://github.com/repowise-dev/repowise) · [Playwright](https://github.com/microsoft/playwright) · [Chromium](https://www.chromium.org/) · [Next.js](https://github.com/vercel/next.js) · [React](https://github.com/facebook/react).
+**Built on** [REA (Reverse Engineer Anything)](https://github.com/morluto/rea) · [llama.cpp](https://github.com/ggml-org/llama.cpp) · [vLLM](https://github.com/vllm-project/vllm) · [ComfyUI](https://github.com/comfyanonymous/ComfyUI) · [CentOS Stream](https://www.centos.org/centos-stream/) · [Podman](https://github.com/containers/podman) · [Docker](https://github.com/moby/moby) · [LanceDB](https://github.com/lancedb/lancedb) · [WireGuard](https://www.wireguard.com/) · [FFmpeg](https://ffmpeg.org/) · [Blender + Rigify](https://www.blender.org/) · [headroom](https://github.com/headroomlabs-ai/headroom) · [SANA](https://github.com/NVlabs/Sana) · [Hunyuan3D](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) · [repowise](https://github.com/repowise-dev/repowise) · [Playwright](https://github.com/microsoft/playwright) · [Chromium](https://www.chromium.org/) · [Next.js](https://github.com/vercel/next.js) · [React](https://github.com/facebook/react).
 
 <div id="aither-constellation" data-self="awnode"></div>
 <script src="aither-constellation.js"></script>

{awnode-0.3.3 → awnode-0.3.4}/README.md

@@ -254,7 +254,7 @@ Every repository here is public. Each publishes an `aither-manifest.json` beside
 | [awsettings](https://github.com/Aitherium/awsettings) | Your agent's permissions and config, following you to the next machine | [docs](https://aitherium.github.io/awsettings/) |
 | [awavatar](https://github.com/Aitherium/awavatar) | One character spec in, a rigged, animated, multi-style avatar pack out | [docs](https://aitherium.github.io/awavatar/) |
 
-**Built on** [llama.cpp](https://github.com/ggml-org/llama.cpp) · [vLLM](https://github.com/vllm-project/vllm) · [ComfyUI](https://github.com/comfyanonymous/ComfyUI) · [CentOS Stream](https://www.centos.org/centos-stream/) · [Podman](https://github.com/containers/podman) · [Docker](https://github.com/moby/moby) · [LanceDB](https://github.com/lancedb/lancedb) · [WireGuard](https://www.wireguard.com/) · [FFmpeg](https://ffmpeg.org/) · [Blender + Rigify](https://www.blender.org/) · [headroom](https://github.com/headroomlabs-ai/headroom) · [SANA](https://github.com/NVlabs/Sana) · [Hunyuan3D](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) · [repowise](https://github.com/repowise-dev/repowise) · [Playwright](https://github.com/microsoft/playwright) · [Chromium](https://www.chromium.org/) · [Next.js](https://github.com/vercel/next.js) · [React](https://github.com/facebook/react).
+**Built on** [REA (Reverse Engineer Anything)](https://github.com/morluto/rea) · [llama.cpp](https://github.com/ggml-org/llama.cpp) · [vLLM](https://github.com/vllm-project/vllm) · [ComfyUI](https://github.com/comfyanonymous/ComfyUI) · [CentOS Stream](https://www.centos.org/centos-stream/) · [Podman](https://github.com/containers/podman) · [Docker](https://github.com/moby/moby) · [LanceDB](https://github.com/lancedb/lancedb) · [WireGuard](https://www.wireguard.com/) · [FFmpeg](https://ffmpeg.org/) · [Blender + Rigify](https://www.blender.org/) · [headroom](https://github.com/headroomlabs-ai/headroom) · [SANA](https://github.com/NVlabs/Sana) · [Hunyuan3D](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1) · [repowise](https://github.com/repowise-dev/repowise) · [Playwright](https://github.com/microsoft/playwright) · [Chromium](https://www.chromium.org/) · [Next.js](https://github.com/vercel/next.js) · [React](https://github.com/facebook/react).
 
 <div id="aither-constellation" data-self="awnode"></div>
 <script src="aither-constellation.js"></script>

{awnode-0.3.3 → awnode-0.3.4}/awnode/__init__.py

@@ -17,4 +17,4 @@ Install:
     aithernode status              # Check what's connected
 """
 
-__version__ = "0.3.3"
+__version__ = "0.3.4"

{awnode-0.3.3 → awnode-0.3.4}/awnode/mcp_server.py

@@ -43,6 +43,7 @@ import sys
 from enum import Enum
 from typing import Any, Callable, Dict, List, get_type_hints
 
+from mcp import types as mcp_types
 from mcp.server import Server
 from mcp.server.lowlevel import NotificationOptions
 from mcp.server.stdio import stdio_server
@@ -113,7 +114,7 @@ async def detect_mode() -> RuntimeMode:
 # Scopes — which tool modules are available in which mode
 # ---------------------------------------------------------------------------
 
-from awnode.tools._scopes import SHELL_LOCAL, SHELL_CLOUD, PLATFORM_ONLY  # noqa: E402
+from awnode.tools._scopes import PLATFORM_ONLY, SHELL_CLOUD, SHELL_LOCAL  # noqa: E402
 
 
 def _scope_for_module(module_name: str) -> str:
@@ -281,7 +282,6 @@ def _discover_tools() -> Dict[str, Dict[str, Any]]:
 # MCP Server
 # ---------------------------------------------------------------------------
 
-server = Server("awnode")
 _current_mode: RuntimeMode = RuntimeMode.STANDALONE
 
 
@@ -321,14 +321,8 @@ async def _reprobe_loop() -> None:
             logger.debug("mode re-probe failed: %s", exc)
 
 
-@server.list_tools()
-async def list_tools() -> list[Tool]:
-    """Return tools available for the current runtime mode."""
-    global _session
-    try:
-        _session = server.request_context.session
-    except LookupError:
-        pass
+def visible_tools() -> list[Tool]:
+    """Tools available for the current runtime mode."""
     tools: list[Tool] = []
     for name, info in _TOOL_REGISTRY.items():
         if not _mode_allows_scope(_current_mode, info["scope"]):
@@ -341,15 +335,15 @@ async def list_tools() -> list[Tool]:
     return tools
 
 
-@server.call_tool()
-async def call_tool(name: str, arguments: dict) -> list[TextContent]:
-    """Invoke a registered tool by name."""
+async def dispatch_tool(name: str, arguments: dict) -> "tuple[str, bool]":
+    """Invoke a registered tool by name, applying the runtime-mode scope rule.
+
+    Returns ``(text, is_error)``. Transport-neutral: both mcp API generations
+    below wrap this one function, so the two can never disagree on a verdict.
+    """
     info = _TOOL_REGISTRY.get(name)
     if info is None:
-        return [TextContent(
-            type="text",
-            text=json.dumps({"error": f"Unknown tool: {name}"}, indent=2),
-        )]
+        return json.dumps({"error": f"Unknown tool: {name}"}, indent=2), True
 
     # Scope check
     if not _mode_allows_scope(_current_mode, info["scope"]):
@@ -366,13 +360,60 @@ async def call_tool(name: str, arguments: dict) -> list[TextContent]:
             )
         else:
             msg = f"Tool '{name}' is not available in {_current_mode.value} mode."
-        return [TextContent(
-            type="text",
-            text=json.dumps({"error": msg, "scope": scope}, indent=2),
-        )]
+        return json.dumps({"error": msg, "scope": scope}, indent=2), True
+
+    return await invoke_registered_tool(name, info, arguments)
+
+
+# -- mcp 2.x: handlers are constructor arguments on the low-level Server -------------
+
+async def _on_list_tools(ctx: Any, _params: Any) -> Any:
+    global _session
+    _session = getattr(ctx, "session", None) or _session
+    return mcp_types.ListToolsResult(tools=visible_tools())
+
+
+async def _on_call_tool(_ctx: Any, params: Any) -> Any:
+    text, is_error = await dispatch_tool(params.name, dict(params.arguments or {}))
+    return mcp_types.CallToolResult(
+        content=[TextContent(type="text", text=text)], is_error=is_error,
+    )
+
+
+def _build_server() -> Server:
+    """Construct the low-level Server against whichever mcp generation is installed.
 
-    text, _is_error = await invoke_registered_tool(name, info, arguments)
-    return [TextContent(type="text", text=text)]
+    mcp 2.x removed the 1.x ``@server.list_tools()`` / ``@server.call_tool()``
+    decorators (``awnode mcp`` died at import with AttributeError once a sibling aw
+    brick pulled mcp 2.2 into the shared env, 2026-10-14) and takes the handlers as
+    ``on_list_tools=`` / ``on_call_tool=`` instead. awdk[node] still pins mcp<2, so
+    awnode supports BOTH rather than forcing a resolver conflict on a shared env.
+    """
+    try:
+        return Server("awnode", on_list_tools=_on_list_tools, on_call_tool=_on_call_tool)
+    except TypeError as exc:
+        # mcp 1.x: no handler kwargs -- register through the decorators below.
+        logger.debug("mcp 1.x Server API (%s); using the decorator registration", exc)
+    srv = Server("awnode")
+
+    @srv.list_tools()
+    async def list_tools() -> list[Tool]:
+        global _session
+        try:
+            _session = srv.request_context.session
+        except LookupError:
+            logger.debug("tools/list outside a request context; keeping the last session")
+        return visible_tools()
+
+    @srv.call_tool()
+    async def call_tool(name: str, arguments: dict) -> list[TextContent]:
+        text, _is_error = await dispatch_tool(name, arguments)
+        return [TextContent(type="text", text=text)]
+
+    return srv
+
+
+server = _build_server()
 
 
 async def invoke_registered_tool(
@@ -390,8 +431,9 @@ async def invoke_registered_tool(
         denial = get_license_manager().check_tool(info["module"])
         if denial:
             return json.dumps({"error": denial, "scope": "subscription"}, indent=2), True
-    except ImportError:
-        pass  # License check failure should never block tools
+    except ImportError as exc:
+        # License check failure should never block tools.
+        logger.debug("license module unavailable; tool %s not gated: %s", name, exc)
 
     func = info["func"]
 
@@ -473,7 +515,7 @@ def _host_is_loopback(host_header: str) -> bool:
 def build_sse_app(mcp_key: str = "", loopback_only: bool = True):
     """The Starlette app behind ``awnode mcp --transport sse``.
 
-    Routes (the standard MCP HTTP+SSE transport, mcp 1.x ``SseServerTransport``):
+    Routes (the standard MCP HTTP+SSE transport, ``SseServerTransport``):
         GET  /health      liveness (never behind auth)
         GET  /sse         opens the event stream; its first event names the
                           per-session POST endpoint (``/messages/?session_id=...``)
@@ -490,9 +532,9 @@ def build_sse_app(mcp_key: str = "", loopback_only: bool = True):
     rebinding page reaches 127.0.0.1 as same-origin under its own Host name, so
     every request carrying an Origin is refused (MCP clients are not browsers --
     the same rule as aw-hub), and with ``loopback_only`` any Host that is not
-    127.0.0.1 / localhost / [::1] is refused too. The pin is ``mcp>=1.0,<2`` and
-    TransportSecuritySettings exists only in later 1.x, so it is layered on when
-    importable but never relied on alone.
+    127.0.0.1 / localhost / [::1] is refused too. The pin is ``mcp>=1.0,<3`` and
+    TransportSecuritySettings exists only in later 1.x and 2.x, so it is layered on
+    when importable but never relied on alone.
     """
     from mcp.server.sse import SseServerTransport
     from starlette.applications import Starlette

{awnode-0.3.3 → awnode-0.3.4}/docs/aither-manifest.json

@@ -15,12 +15,12 @@
   "includes": [],
   "metrics": {
     "files": {
-      "value": 77,
-      "as_of": "2026-10-09T09:45:48+00:00"
+      "value": 80,
+      "as_of": "2026-10-13T18:27:40+00:00"
     },
     "tests": {
-      "value": 14,
-      "as_of": "2026-10-09T09:45:48+00:00"
+      "value": 17,
+      "as_of": "2026-10-13T18:27:40+00:00"
     }
   }
 }

{awnode-0.3.3 → awnode-0.3.4}/docs/index.html

@@ -1179,7 +1179,7 @@ the read-only set; for full tool access from an IDE use <code>awnode mcp</code>.
 </tr>
 </tbody>
 </table>
-<p><strong>Built on</strong> <a href="https://github.com/ggml-org/llama.cpp">llama.cpp</a> · <a href="https://github.com/vllm-project/vllm">vLLM</a> · <a href="https://github.com/comfyanonymous/ComfyUI">ComfyUI</a> · <a href="https://www.centos.org/centos-stream/">CentOS Stream</a> · <a href="https://github.com/containers/podman">Podman</a> · <a href="https://github.com/moby/moby">Docker</a> · <a href="https://github.com/lancedb/lancedb">LanceDB</a> · <a href="https://www.wireguard.com/">WireGuard</a> · <a href="https://ffmpeg.org/">FFmpeg</a> · <a href="https://www.blender.org/">Blender + Rigify</a> · <a href="https://github.com/headroomlabs-ai/headroom">headroom</a> · <a href="https://github.com/NVlabs/Sana">SANA</a> · <a href="https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1">Hunyuan3D</a> · <a href="https://github.com/repowise-dev/repowise">repowise</a> · <a href="https://github.com/microsoft/playwright">Playwright</a> · <a href="https://www.chromium.org/">Chromium</a> · <a href="https://github.com/vercel/next.js">Next.js</a> · <a href="https://github.com/facebook/react">React</a>.</p>
+<p><strong>Built on</strong> <a href="https://github.com/morluto/rea">REA (Reverse Engineer Anything)</a> · <a href="https://github.com/ggml-org/llama.cpp">llama.cpp</a> · <a href="https://github.com/vllm-project/vllm">vLLM</a> · <a href="https://github.com/comfyanonymous/ComfyUI">ComfyUI</a> · <a href="https://www.centos.org/centos-stream/">CentOS Stream</a> · <a href="https://github.com/containers/podman">Podman</a> · <a href="https://github.com/moby/moby">Docker</a> · <a href="https://github.com/lancedb/lancedb">LanceDB</a> · <a href="https://www.wireguard.com/">WireGuard</a> · <a href="https://ffmpeg.org/">FFmpeg</a> · <a href="https://www.blender.org/">Blender + Rigify</a> · <a href="https://github.com/headroomlabs-ai/headroom">headroom</a> · <a href="https://github.com/NVlabs/Sana">SANA</a> · <a href="https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1">Hunyuan3D</a> · <a href="https://github.com/repowise-dev/repowise">repowise</a> · <a href="https://github.com/microsoft/playwright">Playwright</a> · <a href="https://www.chromium.org/">Chromium</a> · <a href="https://github.com/vercel/next.js">Next.js</a> · <a href="https://github.com/facebook/react">React</a>.</p>
 <div id="aither-constellation" data-self="awnode"></div>
 <script src="aither-constellation.js"></script>
 
@@ -1257,7 +1257,7 @@ the read-only set; for full tool access from an IDE use <code>awnode mcp</code>.
   <div class="fk-element" aria-label="Aitherium, element 0, symbol Ai, the element of creation"><span class="fk-el-no">0</span><span class="fk-el-sy">Ai</span><span class="fk-el-nm">aitherium</span></div>
   <p class="fk-brandlines"><span>Aitherium · the element of creation</span><span>Aither — the medium creation moves through</span></p>
   <div class="fk-family"><a href="https://aitherium.com/about"><span class="n">Aitherium</span><span class="r">the company</span></a><a href="https://aitherium.com/"><span class="n">AitherOS</span><span class="r">the OS</span></a><a href="https://aitherium.github.io/awnix/"><span class="n m">awnix</span><span class="r">the base</span></a><a href="https://aitherium.github.io/awdk/"><span class="n m">awdk</span><span class="r">the SDK</span></a><a href="https://aitherium.github.io/awsh/"><span class="n m">awsh</span><span class="r">the shell</span></a><a href="https://aitherium.github.io/"><span class="n m">aw* bricks</span><span class="r">the frameworks</span></a><a href="https://aitherium.com/studio"><span class="n">The Studio</span><span class="r">build apps, agents, workflows</span></a></div>
-  <p class="fk-colophon fk-built-on">Built on <a href="https://www.blender.org/" rel="noopener">Blender + Rigify</a> &middot; <a href="https://www.centos.org/centos-stream/" rel="noopener">CentOS Stream</a> &middot; <a href="https://www.chromium.org/" rel="noopener">Chromium</a> &middot; <a href="https://github.com/comfyanonymous/ComfyUI" rel="noopener">ComfyUI</a> &middot; <a href="https://github.com/moby/moby" rel="noopener">Docker</a> &middot; <a href="https://ffmpeg.org/" rel="noopener">FFmpeg</a> &middot; <a href="https://github.com/headroomlabs-ai/headroom" rel="noopener">headroom</a> &middot; <a href="https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1" rel="noopener">Hunyuan3D</a> &middot; <a href="https://github.com/lancedb/lancedb" rel="noopener">LanceDB</a> &middot; <a href="https://github.com/ggml-org/llama.cpp" rel="noopener">llama.cpp</a> &middot; <a href="https://github.com/vercel/next.js" rel="noopener">Next.js</a> &middot; <a href="https://github.com/microsoft/playwright" rel="noopener">Playwright</a> &middot; <a href="https://github.com/containers/podman" rel="noopener">Podman</a> &middot; <a href="https://github.com/facebook/react" rel="noopener">React</a> &middot; <a href="https://github.com/repowise-dev/repowise" rel="noopener">repowise</a> &middot; <a href="https://github.com/NVlabs/Sana" rel="noopener">SANA</a> &middot; <a href="https://github.com/vllm-project/vllm" rel="noopener">vLLM</a> &middot; <a href="https://www.wireguard.com/" rel="noopener">WireGuard</a></p>
+  <p class="fk-colophon fk-built-on">Built on <a href="https://www.blender.org/" rel="noopener">Blender + Rigify</a> &middot; <a href="https://www.centos.org/centos-stream/" rel="noopener">CentOS Stream</a> &middot; <a href="https://www.chromium.org/" rel="noopener">Chromium</a> &middot; <a href="https://github.com/comfyanonymous/ComfyUI" rel="noopener">ComfyUI</a> &middot; <a href="https://github.com/moby/moby" rel="noopener">Docker</a> &middot; <a href="https://ffmpeg.org/" rel="noopener">FFmpeg</a> &middot; <a href="https://github.com/headroomlabs-ai/headroom" rel="noopener">headroom</a> &middot; <a href="https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1" rel="noopener">Hunyuan3D</a> &middot; <a href="https://github.com/lancedb/lancedb" rel="noopener">LanceDB</a> &middot; <a href="https://github.com/ggml-org/llama.cpp" rel="noopener">llama.cpp</a> &middot; <a href="https://github.com/vercel/next.js" rel="noopener">Next.js</a> &middot; <a href="https://github.com/microsoft/playwright" rel="noopener">Playwright</a> &middot; <a href="https://github.com/containers/podman" rel="noopener">Podman</a> &middot; <a href="https://github.com/morluto/rea" rel="noopener">REA (Reverse Engineer Anything)</a> &middot; <a href="https://github.com/facebook/react" rel="noopener">React</a> &middot; <a href="https://github.com/repowise-dev/repowise" rel="noopener">repowise</a> &middot; <a href="https://github.com/NVlabs/Sana" rel="noopener">SANA</a> &middot; <a href="https://github.com/vllm-project/vllm" rel="noopener">vLLM</a> &middot; <a href="https://www.wireguard.com/" rel="noopener">WireGuard</a></p>
   <p class="fk-colophon">Part of the <strong>aw family</strong> — Aither World tools, each one <em>adoptable alone</em>. Generated from the brick README and the ecosystem registry.</p>
 </footer>
 <nav class="fk-dock" aria-label="The family"><a href="https://aitherium.com/" aria-label="AitherOS"><svg class="fk-mark" viewBox="0 0 512 512" fill="none" aria-hidden="true"><g transform="translate(256 256) scale(0.86) translate(-256 -256)"><polygon points="256,96 400,360 112,360" stroke="currentColor" stroke-width="26" stroke-linejoin="round"/><circle cx="256" cy="262" r="52" fill="currentColor"/><circle cx="256" cy="262" r="26" fill="#050507"/><circle cx="256" cy="262" r="10" fill="currentColor"/></g></svg></a><span class="fk-sep" aria-hidden="true"></span><a href="https://aitherium.github.io/" aria-current="page">bricks</a><a href="https://aitherium.github.io/awdk/">awdk</a><a href="https://aitherium.github.io/awsh/">awsh</a><a href="https://aitherium.github.io/awnix/">awnix</a><a href="https://aitherium.github.io/awknowledge/">guide</a><a href="https://blog.aitherium.com/">journal</a></nav>

{awnode-0.3.3 → awnode-0.3.4}/pyproject.toml

@@ -8,7 +8,7 @@ build-backend = "hatchling.build"
 # [project.scripts]). The old `aithernode` distribution name is kept resolving by
 # the redirect stub in `packaging/aithernode-stub/`.
 name = "awnode"
-version = "0.3.3"
+version = "0.3.4"
 description = "awnode — lightweight local gateway for AitherOS"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -23,17 +23,14 @@ dependencies = [
     "pyyaml>=6.0",
     "fastapi>=0.109.0",
     "uvicorn[standard]>=0.27.0",
-    # <2.0.0 pinned deliberately: mcp_server.py uses the 1.x low-level
-    # Server API (@server.list_tools() / @server.call_tool()), which 2.0
-    # removed entirely in favor of MCPServer's per-tool @server.tool()
-    # decorator (see AitherOS/packages/awgraph/awgraph/mcp_server.py's own
-    # docstring for the same cutover). Unpinned, `mcp>=1.0.0` silently
-    # resolved to 2.0.0 and `test` died at collection with "'Server' object
-    # has no attribute 'list_tools'" the first time CI ever got far enough
-    # to import this module — a real drift the workflow's own setup-python
-    # failure had been hiding, not something this pin causes. Migrating to
-    # the 2.x API is real follow-up work, not a version-string fix.
-    "mcp>=1.0.0,<2.0.0",
+    # mcp 1.x AND 2.x are both supported (mcp_server._build_server picks the
+    # API at import): 2.x moved the low-level handlers from the
+    # @server.list_tools()/@server.call_tool() decorators to on_list_tools= /
+    # on_call_tool= constructor kwargs. The old <2 pin broke `awnode mcp` the
+    # moment a sibling aw brick (awrelay/awgraph/awdelphi need >=2) pulled
+    # 2.2 into the same env (2026-10-14); widening to <3 instead of >=2 keeps
+    # awdk[node] (still mcp<2) co-installable in one env.
+    "mcp>=1.0.0,<3.0.0",
 ]
 
 # No Repository/Documentation entry: Aitherium/awnode is a PRIVATE

awnode-0.3.4/tests/test_mcp_api_compat.py

@@ -0,0 +1,60 @@
+"""`awnode mcp` must import and serve on whichever mcp generation is installed.
+
+2026-10-14: a sibling aw brick pulled mcp 2.2 into the shared env and `awnode mcp`
+died at import (`'Server' object has no attribute 'list_tools'`). The live SSE test
+proves list+call end to end; these pin the transport-neutral core both API paths wrap.
+"""
+from __future__ import annotations
+
+import asyncio
+import json
+
+import awnode.mcp_server as ms
+
+
+def test_module_builds_a_server_on_the_installed_mcp():
+    assert ms.server is not None
+    # 2.x registers on_list_tools via the constructor; 1.x via decorators. Either
+    # way a tools/list handler must exist, or the server answers nothing.
+    handlers = getattr(ms.server, "request_handlers", None)
+    if handlers is not None:  # mcp 1.x
+        assert any("ListTools" in getattr(k, "__name__", "") for k in handlers)
+    else:  # mcp 2.x
+        assert ms.server.get_request_handler("tools/list") is not None
+        assert ms.server.get_request_handler("tools/call") is not None
+
+
+def test_unknown_tool_is_an_error(monkeypatch):
+    monkeypatch.setattr(ms, "_TOOL_REGISTRY", {})
+    text, is_error = asyncio.run(ms.dispatch_tool("nope", {}))
+    assert is_error is True
+    assert "Unknown tool" in json.loads(text)["error"]
+
+
+def test_scope_refusal_is_an_error_and_hidden_from_the_list(monkeypatch):
+    def _f():
+        return "ran"
+
+    monkeypatch.setattr(ms, "_TOOL_REGISTRY", {"plat": {
+        "func": _f, "scope": "platform_only", "module": "x",
+        "description": "d", "schema": {"type": "object", "properties": {}},
+    }})
+    monkeypatch.setattr(ms, "_current_mode", ms.RuntimeMode.STANDALONE)
+    assert [t.name for t in ms.visible_tools()] == []
+    text, is_error = asyncio.run(ms.dispatch_tool("plat", {}))
+    assert is_error is True and json.loads(text)["scope"] == "platform_only"
+
+
+def test_allowed_tool_runs(monkeypatch):
+    def _f(x: str = "") -> str:
+        return f"got {x}"
+
+    # "filesystem" is a free-plan module, so the subscription gate passes.
+    monkeypatch.setattr(ms, "_TOOL_REGISTRY", {"echo": {
+        "func": _f, "scope": "shell_local", "module": "filesystem",
+        "description": "d", "schema": {"type": "object", "properties": {}},
+    }})
+    monkeypatch.setattr(ms, "_current_mode", ms.RuntimeMode.STANDALONE)
+    assert [t.name for t in ms.visible_tools()] == ["echo"]
+    text, is_error = asyncio.run(ms.dispatch_tool("echo", {"x": "hi", "junk": 1}))
+    assert (text, is_error) == ("got hi", False)