adaptorch-mcp 0.3.0__tar.gz

adaptorch_mcp-0.3.0/PKG-INFO

@@ -0,0 +1,185 @@
+Metadata-Version: 2.4
+Name: adaptorch-mcp
+Version: 0.3.0
+Summary: Installable MCP bridge for AdaptOrch
+Author: AdaptOrch maintainers
+License: Proprietary — Copyright EGG. All rights reserved.
+Project-URL: Homepage, https://github.com/dmae97/adaptorch_mcp
+Project-URL: Repository, https://github.com/dmae97/adaptorch_mcp
+Project-URL: Issues, https://github.com/dmae97/adaptorch_mcp/issues
+Project-URL: Documentation, https://github.com/dmae97/adaptorch_mcp#readme
+Keywords: mcp,model-context-protocol,adaptorch,agent-orchestration
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: adaptorch[api]>=0.1.0
+Provides-Extra: dev
+Requires-Dist: build>=1.2; extra == "dev"
+Requires-Dist: mypy>=1.10; extra == "dev"
+Requires-Dist: pytest>=8.2; extra == "dev"
+Requires-Dist: ruff>=0.6; extra == "dev"
+
+# adaptorch-mcp
+
+Installable Python wrapper for the AdaptOrch MCP server.
+
+The package intentionally delegates runtime behavior to `adaptorch.mcp_server`, so MCP tools, transports, safety checks, prompts, and optional algorithm controls stay aligned with AdaptOrch core.
+
+## Install
+
+```bash
+pip install adaptorch-mcp
+```
+
+If AdaptOrch is not published to your package index yet:
+
+```bash
+pip install "adaptorch[api] @ git+https://github.com/dmae97/adaptorch.git"
+pip install adaptorch-mcp
+```
+
+One-shot with `uvx`:
+
+```bash
+uvx adaptorch-mcp --help
+uvx --with "adaptorch[api] @ git+https://github.com/dmae97/adaptorch.git" adaptorch-mcp --help
+```
+
+For contributors inside this monorepo:
+
+```bash
+uv sync --all-packages --extra dev
+uv run adaptorch-mcp --help
+```
+
+## Run stdio MCP
+
+Use stdio for Claude Code, Claude Desktop, and other local MCP hosts.
+
+```bash
+export ADAPTORCH_CONTROL_PLANE_TOKEN="<your-token>"
+adaptorch-mcp --transport stdio --base-url https://adaptorch.com
+```
+
+## Run HTTP MCP
+
+Use HTTP for local gateways, reverse proxies, or remote MCP clients. Keep the client-facing MCP token separate from the upstream AdaptOrch token.
+
+```bash
+export ADAPTORCH_CONTROL_PLANE_TOKEN="<upstream-adaptorch-token>"
+export ADAPTORCH_MCP_HTTP_AUTH_TOKEN="<client-facing-mcp-token>"
+
+adaptorch-mcp \
+  --transport http \
+  --base-url https://adaptorch.com \
+  --http-host 127.0.0.1 \
+  --http-port 8765 \
+  --http-auth-token "$ADAPTORCH_MCP_HTTP_AUTH_TOKEN"
+```
+
+Health check:
+
+```bash
+python - <<'PY'
+import httpx
+print(httpx.get('http://127.0.0.1:8765/mcp/health').json())
+PY
+```
+
+## CLI reference
+
+| Command | Purpose | Important options |
+| --- | --- | --- |
+| `adaptorch-mcp` | Start the stdio or HTTP MCP server. | `--transport stdio|http`, `--base-url`, `--api-token`, `--timeout-seconds`, `--stdio-framing`, `--http-host`, `--http-port`, `--http-auth-token` |
+| `adaptorch-mcp-doctor` | Print redacted local diagnostics. | `--json`, `--strict` |
+| `adaptorch-mcp-smoke` | Verify stdio `initialize` + `tools/list`. | `--command`, `--base-url`, `--api-token`, `--timeout-seconds`, repeatable `--expected-tool` |
+
+For `adaptorch-mcp`, the public wrapper resolves the control-plane URL in this order: explicit `--base-url`, then trimmed/validated `ADAPTORCH_CONTROL_PLANE_BASE_URL`, then the hosted fallback `https://adaptorch.com`. `adaptorch-mcp-smoke` keeps a local-dev fallback of `http://127.0.0.1:8000` when no base URL is configured. Pass `--base-url` explicitly in checked-in MCP client configs for reproducible behavior.
+
+## Environment variables
+
+| Variable | Purpose | Notes |
+| --- | --- | --- |
+| `ADAPTORCH_CONTROL_PLANE_TOKEN` | Upstream AdaptOrch token. | Required unless `--api-token` is passed. |
+| `ADAPTORCH_CONTROL_PLANE_BASE_URL` | Base URL used when `--base-url` is omitted. | Trimmed and validated as HTTP(S); do not embed credentials. |
+| `ADAPTORCH_MCP_HTTP_AUTH_TOKEN` | Client-facing bearer token for HTTP/SSE MCP. | Keep separate from the upstream token. |
+| `ADAPTORCH_MCP_ALLOWED_ORIGINS` | Comma-separated HTTP origin allowlist. | Use with browser or remote HTTP clients. |
+| `ADAPTORCH_MCP_MAX_PAYLOAD_SIZE_BYTES` | Maximum accepted HTTP request body size. | Keep bounded for public deployments. |
+| `ADAPTORCH_MCP_REQUEST_TIMEOUT_SECONDS` | HTTP request timeout budget. | Applies to HTTP server request handling. |
+| `ADAPTORCH_MCP_MAX_SSE_SUBSCRIBERS` | Maximum concurrent SSE subscribers. | Defaults are provided by `adaptorch.mcp_server`. |
+| `ADAPTORCH_MCP_TIMEOUT_SECONDS` | Control-plane client timeout for app-factory usage. | Useful when embedding the ASGI app. |
+| `ADAPTORCH_MCP_HTTP_HOST` / `ADAPTORCH_MCP_HTTP_PORT` | Shell/template values for `--http-host` and `--http-port`. | CLI flags are authoritative. |
+| `ADAPTORCH_REPRODUCIBLE` | Benchmark/eval reproducibility beta. | Benchmark/eval scope only; not general runtime determinism. |
+| `ADAPTORCH_ROUTER_ACCURACY_GATE` | Online-router learned-model gate. | `point` default or `wilson`; advanced/operator use. |
+| `ADAPTORCH_PAPER_SEMANTIC_WEIGHT` | Paper-mode lexical/semantic blend. | Default `0.35`; nonzero values use Python scoring over the native fast path. |
+
+## Engine-delegated optional controls
+
+The wrapper forwards these controls to the installed `adaptorch` engine; it does
+not implement routing, synthesis, or benchmark algorithms itself. See the root
+configuration guide for non-env controls such as `manifest_canonical_sha256`,
+`pass_rate_credit`, `quality_signal`, `prefer_multi_model_ensemble_singleton`,
+and MCP `prefer_ensemble_singleton`.
+
+## Tool surface
+
+| Tool | Purpose |
+| --- | --- |
+| `adaptorch_run` | Submit an AdaptOrch task payload and optionally wait. |
+| `adaptorch_get_run` | Read run summary by `run_id`. |
+| `adaptorch_get_artifacts` | Read artifact metadata for a run. |
+| `adaptorch_list_runs` | List recent runs. |
+| `adaptorch_get_traces` | Read execution traces. |
+| `adaptorch_cancel_run` | Request run cancellation (write/destructive; keep manually approved). |
+| `adaptorch_route_topology` | Locally route a DAG through AdaptOrch's topology router. |
+| `adaptorch_server_metrics` | Read redacted MCP server metrics. |
+| `adaptorch_capabilities` | Read synthesis modes, connectors, and server features. |
+| `adaptorch_plan_catalog` | Read hosted plan catalog: Starter `$0`, Pro `$39`, Team `$149`. |
+
+## Diagnostics and smoke tests
+
+```bash
+adaptorch-mcp-doctor
+adaptorch-mcp-doctor --json
+adaptorch-mcp-doctor --strict
+```
+
+The doctor command reports package availability, expected MCP tools, redacted environment metadata, and `controlPlane` base-url resolution details without printing token values.
+
+```bash
+export ADAPTORCH_CONTROL_PLANE_TOKEN="<your-token>"
+adaptorch-mcp-smoke --base-url https://adaptorch.com
+```
+
+Expected JSON includes `"ok": true`, `adaptorch_plan_catalog`, and the expected core tool subset. If no base URL is supplied, smoke targets `http://127.0.0.1:8000` for local development. Add repeatable `--expected-tool <name>` flags when validating a specific hosted/core release.
+
+## Example configs
+
+- `../../examples/claude_desktop_config.json`
+- `../../examples/omk.mcp.json`
+- `../../examples/mcp-http.env.example`
+
+Checked-in examples use placeholders or environment interpolation. Fill real URLs and tokens only in local, uncommitted config files. For shared or production clients, avoid auto-approving run, artifact, and trace readers unless those payloads are already sanitized.
+
+## HTTP app factory
+
+`create_default_mcp_http_app()` embeds the canonical AdaptOrch MCP HTTP ASGI app. It requires an upstream control-plane token in the environment.
+
+```bash
+export ADAPTORCH_CONTROL_PLANE_TOKEN="<upstream-adaptorch-token>"
+export ADAPTORCH_CONTROL_PLANE_BASE_URL="https://adaptorch.com"
+export ADAPTORCH_MCP_HTTP_AUTH_TOKEN="<client-facing-mcp-token>"
+```
+
+```python
+from adaptorch_mcp import create_default_mcp_http_app
+
+app = create_default_mcp_http_app()
+```

adaptorch_mcp-0.3.0/README.md

@@ -0,0 +1,157 @@
+# adaptorch-mcp
+
+Installable Python wrapper for the AdaptOrch MCP server.
+
+The package intentionally delegates runtime behavior to `adaptorch.mcp_server`, so MCP tools, transports, safety checks, prompts, and optional algorithm controls stay aligned with AdaptOrch core.
+
+## Install
+
+```bash
+pip install adaptorch-mcp
+```
+
+If AdaptOrch is not published to your package index yet:
+
+```bash
+pip install "adaptorch[api] @ git+https://github.com/dmae97/adaptorch.git"
+pip install adaptorch-mcp
+```
+
+One-shot with `uvx`:
+
+```bash
+uvx adaptorch-mcp --help
+uvx --with "adaptorch[api] @ git+https://github.com/dmae97/adaptorch.git" adaptorch-mcp --help
+```
+
+For contributors inside this monorepo:
+
+```bash
+uv sync --all-packages --extra dev
+uv run adaptorch-mcp --help
+```
+
+## Run stdio MCP
+
+Use stdio for Claude Code, Claude Desktop, and other local MCP hosts.
+
+```bash
+export ADAPTORCH_CONTROL_PLANE_TOKEN="<your-token>"
+adaptorch-mcp --transport stdio --base-url https://adaptorch.com
+```
+
+## Run HTTP MCP
+
+Use HTTP for local gateways, reverse proxies, or remote MCP clients. Keep the client-facing MCP token separate from the upstream AdaptOrch token.
+
+```bash
+export ADAPTORCH_CONTROL_PLANE_TOKEN="<upstream-adaptorch-token>"
+export ADAPTORCH_MCP_HTTP_AUTH_TOKEN="<client-facing-mcp-token>"
+
+adaptorch-mcp \
+  --transport http \
+  --base-url https://adaptorch.com \
+  --http-host 127.0.0.1 \
+  --http-port 8765 \
+  --http-auth-token "$ADAPTORCH_MCP_HTTP_AUTH_TOKEN"
+```
+
+Health check:
+
+```bash
+python - <<'PY'
+import httpx
+print(httpx.get('http://127.0.0.1:8765/mcp/health').json())
+PY
+```
+
+## CLI reference
+
+| Command | Purpose | Important options |
+| --- | --- | --- |
+| `adaptorch-mcp` | Start the stdio or HTTP MCP server. | `--transport stdio|http`, `--base-url`, `--api-token`, `--timeout-seconds`, `--stdio-framing`, `--http-host`, `--http-port`, `--http-auth-token` |
+| `adaptorch-mcp-doctor` | Print redacted local diagnostics. | `--json`, `--strict` |
+| `adaptorch-mcp-smoke` | Verify stdio `initialize` + `tools/list`. | `--command`, `--base-url`, `--api-token`, `--timeout-seconds`, repeatable `--expected-tool` |
+
+For `adaptorch-mcp`, the public wrapper resolves the control-plane URL in this order: explicit `--base-url`, then trimmed/validated `ADAPTORCH_CONTROL_PLANE_BASE_URL`, then the hosted fallback `https://adaptorch.com`. `adaptorch-mcp-smoke` keeps a local-dev fallback of `http://127.0.0.1:8000` when no base URL is configured. Pass `--base-url` explicitly in checked-in MCP client configs for reproducible behavior.
+
+## Environment variables
+
+| Variable | Purpose | Notes |
+| --- | --- | --- |
+| `ADAPTORCH_CONTROL_PLANE_TOKEN` | Upstream AdaptOrch token. | Required unless `--api-token` is passed. |
+| `ADAPTORCH_CONTROL_PLANE_BASE_URL` | Base URL used when `--base-url` is omitted. | Trimmed and validated as HTTP(S); do not embed credentials. |
+| `ADAPTORCH_MCP_HTTP_AUTH_TOKEN` | Client-facing bearer token for HTTP/SSE MCP. | Keep separate from the upstream token. |
+| `ADAPTORCH_MCP_ALLOWED_ORIGINS` | Comma-separated HTTP origin allowlist. | Use with browser or remote HTTP clients. |
+| `ADAPTORCH_MCP_MAX_PAYLOAD_SIZE_BYTES` | Maximum accepted HTTP request body size. | Keep bounded for public deployments. |
+| `ADAPTORCH_MCP_REQUEST_TIMEOUT_SECONDS` | HTTP request timeout budget. | Applies to HTTP server request handling. |
+| `ADAPTORCH_MCP_MAX_SSE_SUBSCRIBERS` | Maximum concurrent SSE subscribers. | Defaults are provided by `adaptorch.mcp_server`. |
+| `ADAPTORCH_MCP_TIMEOUT_SECONDS` | Control-plane client timeout for app-factory usage. | Useful when embedding the ASGI app. |
+| `ADAPTORCH_MCP_HTTP_HOST` / `ADAPTORCH_MCP_HTTP_PORT` | Shell/template values for `--http-host` and `--http-port`. | CLI flags are authoritative. |
+| `ADAPTORCH_REPRODUCIBLE` | Benchmark/eval reproducibility beta. | Benchmark/eval scope only; not general runtime determinism. |
+| `ADAPTORCH_ROUTER_ACCURACY_GATE` | Online-router learned-model gate. | `point` default or `wilson`; advanced/operator use. |
+| `ADAPTORCH_PAPER_SEMANTIC_WEIGHT` | Paper-mode lexical/semantic blend. | Default `0.35`; nonzero values use Python scoring over the native fast path. |
+
+## Engine-delegated optional controls
+
+The wrapper forwards these controls to the installed `adaptorch` engine; it does
+not implement routing, synthesis, or benchmark algorithms itself. See the root
+configuration guide for non-env controls such as `manifest_canonical_sha256`,
+`pass_rate_credit`, `quality_signal`, `prefer_multi_model_ensemble_singleton`,
+and MCP `prefer_ensemble_singleton`.
+
+## Tool surface
+
+| Tool | Purpose |
+| --- | --- |
+| `adaptorch_run` | Submit an AdaptOrch task payload and optionally wait. |
+| `adaptorch_get_run` | Read run summary by `run_id`. |
+| `adaptorch_get_artifacts` | Read artifact metadata for a run. |
+| `adaptorch_list_runs` | List recent runs. |
+| `adaptorch_get_traces` | Read execution traces. |
+| `adaptorch_cancel_run` | Request run cancellation (write/destructive; keep manually approved). |
+| `adaptorch_route_topology` | Locally route a DAG through AdaptOrch's topology router. |
+| `adaptorch_server_metrics` | Read redacted MCP server metrics. |
+| `adaptorch_capabilities` | Read synthesis modes, connectors, and server features. |
+| `adaptorch_plan_catalog` | Read hosted plan catalog: Starter `$0`, Pro `$39`, Team `$149`. |
+
+## Diagnostics and smoke tests
+
+```bash
+adaptorch-mcp-doctor
+adaptorch-mcp-doctor --json
+adaptorch-mcp-doctor --strict
+```
+
+The doctor command reports package availability, expected MCP tools, redacted environment metadata, and `controlPlane` base-url resolution details without printing token values.
+
+```bash
+export ADAPTORCH_CONTROL_PLANE_TOKEN="<your-token>"
+adaptorch-mcp-smoke --base-url https://adaptorch.com
+```
+
+Expected JSON includes `"ok": true`, `adaptorch_plan_catalog`, and the expected core tool subset. If no base URL is supplied, smoke targets `http://127.0.0.1:8000` for local development. Add repeatable `--expected-tool <name>` flags when validating a specific hosted/core release.
+
+## Example configs
+
+- `../../examples/claude_desktop_config.json`
+- `../../examples/omk.mcp.json`
+- `../../examples/mcp-http.env.example`
+
+Checked-in examples use placeholders or environment interpolation. Fill real URLs and tokens only in local, uncommitted config files. For shared or production clients, avoid auto-approving run, artifact, and trace readers unless those payloads are already sanitized.
+
+## HTTP app factory
+
+`create_default_mcp_http_app()` embeds the canonical AdaptOrch MCP HTTP ASGI app. It requires an upstream control-plane token in the environment.
+
+```bash
+export ADAPTORCH_CONTROL_PLANE_TOKEN="<upstream-adaptorch-token>"
+export ADAPTORCH_CONTROL_PLANE_BASE_URL="https://adaptorch.com"
+export ADAPTORCH_MCP_HTTP_AUTH_TOKEN="<client-facing-mcp-token>"
+```
+
+```python
+from adaptorch_mcp import create_default_mcp_http_app
+
+app = create_default_mcp_http_app()
+```

adaptorch_mcp-0.3.0/pyproject.toml

@@ -0,0 +1,51 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "adaptorch-mcp"
+version = "0.3.0"
+description = "Installable MCP bridge for AdaptOrch"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "Proprietary — Copyright EGG. All rights reserved." }
+authors = [{ name = "AdaptOrch maintainers" }]
+keywords = ["mcp", "model-context-protocol", "adaptorch", "agent-orchestration"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Typing :: Typed",
+]
+dependencies = [
+  "adaptorch[api]>=0.1.0",
+]
+
+[project.optional-dependencies]
+dev = [
+  "build>=1.2",
+  "mypy>=1.10",
+  "pytest>=8.2",
+  "ruff>=0.6",
+]
+
+[project.urls]
+Homepage = "https://github.com/dmae97/adaptorch_mcp"
+Repository = "https://github.com/dmae97/adaptorch_mcp"
+Issues = "https://github.com/dmae97/adaptorch_mcp/issues"
+Documentation = "https://github.com/dmae97/adaptorch_mcp#readme"
+
+[project.scripts]
+adaptorch-mcp = "adaptorch_mcp.cli:main"
+adaptorch-mcp-doctor = "adaptorch_mcp.doctor:main"
+adaptorch-mcp-smoke = "adaptorch_mcp.stdio_smoke:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+adaptorch_mcp = ["py.typed"]

adaptorch_mcp-0.3.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

adaptorch_mcp-0.3.0/src/adaptorch_mcp/__init__.py

@@ -0,0 +1,9 @@
+from __future__ import annotations
+
+from adaptorch_mcp.cli import main
+from adaptorch_mcp.diagnostics import collect_diagnostics
+from adaptorch_mcp.server import create_default_mcp_http_app
+
+__all__ = ["__version__", "collect_diagnostics", "create_default_mcp_http_app", "main"]
+
+__version__ = "0.3.0"

adaptorch_mcp-0.3.0/src/adaptorch_mcp/__main__.py

@@ -0,0 +1,5 @@
+from __future__ import annotations
+
+from adaptorch_mcp.cli import main
+
+raise SystemExit(main())

adaptorch_mcp-0.3.0/src/adaptorch_mcp/cli.py

@@ -0,0 +1,104 @@
+from __future__ import annotations
+
+import os
+import sys
+from collections.abc import Sequence
+from urllib.parse import urlparse
+
+_CONTROL_PLANE_BASE_URL_ENV = "ADAPTORCH_CONTROL_PLANE_BASE_URL"
+_HOSTED_BASE_URL = "https://adaptorch.com"
+_ALLOWED_CONTROL_PLANE_SCHEMES = frozenset({"http", "https"})
+
+_MISSING_ADAPTORCH_MESSAGE = (
+    "adaptorch-mcp requires AdaptOrch. Install with: "
+    "pip install 'adaptorch[api] @ git+https://github.com/dmae97/adaptorch.git'"
+)
+
+
+def _validate_control_plane_base_url(value: str, *, source: str) -> str:
+    """Return a stripped http(s) URL or raise for invalid control-plane input."""
+    stripped = value.strip()
+    parsed = urlparse(stripped)
+    if parsed.scheme.lower() not in _ALLOWED_CONTROL_PLANE_SCHEMES or not parsed.netloc:
+        raise ValueError(f"{source} must be an http(s) URL with a host")
+    if "@" in parsed.netloc:
+        raise ValueError(f"{source} must not include embedded credentials")
+    return stripped
+
+
+def _normalize_env_base_url(value: str | None) -> str | None:
+    """Normalize the optional base-url environment variable.
+
+    Empty or whitespace-only values are treated as unset. Non-empty values must
+    be syntactically valid HTTP(S) URLs so misconfiguration fails before the
+    wrapper submits work to an unexpected control plane.
+    """
+    if value is None:
+        return None
+    stripped = value.strip()
+    if not stripped:
+        return None
+    return _validate_control_plane_base_url(stripped, source=_CONTROL_PLANE_BASE_URL_ENV)
+
+
+def _strip_empty_base_url_equals(argv: Sequence[str]) -> list[str]:
+    """Drop empty equals-form base-url tokens so env/hosted defaults can apply."""
+    return [arg for arg in argv if arg != "--base-url="]
+
+
+def _explicit_base_url_value(argv: Sequence[str]) -> str | None:
+    """Return the first non-empty explicit base-url value from argv, if present."""
+    for index, arg in enumerate(argv):
+        if arg == "--base-url" and index + 1 < len(argv):
+            return argv[index + 1]
+        if arg.startswith("--base-url=") and arg != "--base-url=":
+            return arg.split("=", 1)[1]
+    return None
+
+
+def _has_base_url_flag(argv: Sequence[str]) -> bool:
+    """Return whether argv already carries a non-empty explicit base-url flag."""
+    return _explicit_base_url_value(argv) is not None
+
+
+def _with_hosted_base_url_default(argv: Sequence[str] | None) -> list[str] | None:
+    """Resolve the public wrapper's AdaptOrch control-plane base URL.
+
+    Precedence is deterministic:
+    1. Explicit ``--base-url`` or ``--base-url=...`` in argv.
+    2. ``ADAPTORCH_CONTROL_PLANE_BASE_URL`` when no explicit flag is present.
+    3. Hosted fallback for user-facing installs.
+
+    The canonical ``adaptorch.mcp_server`` keeps a localhost default for
+    core/local development. The public ``adaptorch-mcp`` package is user-facing,
+    so omitting both CLI and env configuration should still make runs visible in
+    the hosted dashboard.
+    """
+    raw_forwarded = list(argv) if argv is not None else sys.argv[1:]
+    forwarded = _strip_empty_base_url_equals(raw_forwarded)
+    explicit_base_url = _explicit_base_url_value(forwarded)
+    if explicit_base_url is not None:
+        _validate_control_plane_base_url(explicit_base_url, source="--base-url")
+        if argv is None and forwarded == raw_forwarded:
+            return None
+        return forwarded
+
+    env_base_url = _normalize_env_base_url(os.getenv(_CONTROL_PLANE_BASE_URL_ENV))
+    if env_base_url is not None:
+        return ["--base-url", env_base_url, *forwarded]
+
+    return ["--base-url", _HOSTED_BASE_URL, *forwarded]
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """Delegate the public console script to the canonical AdaptOrch MCP server."""
+    try:
+        from adaptorch.mcp_server import main as adaptorch_mcp_main
+    except ModuleNotFoundError as exc:
+        if exc.name == "adaptorch":
+            print(_MISSING_ADAPTORCH_MESSAGE, file=sys.stderr)
+            return 2
+        raise
+
+    forwarded_argv = _with_hosted_base_url_default(argv)
+    return int(adaptorch_mcp_main(forwarded_argv))