alloc-context 0.2.2__tar.gz → 0.2.4__tar.gz

{alloc_context-0.2.2 → alloc_context-0.2.4}/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: alloc-context
-Version: 0.2.2
-Summary: Portfolio-aware crypto context for agents — holdings, market, optional allocation analysis
+Version: 0.2.4
+Summary: Portfolio-aware crypto context for agents — holdings-scoped market, sentiment, optional allocation analysis
 License: Elastic-2.0
 Project-URL: Homepage, https://mcp.alloc-context.com/llms.txt
-Project-URL: Documentation, https://github.com/negillett/alloc-context/blob/main/docs/agent-integration.md
-Project-URL: Repository, https://github.com/negillett/alloc-context
-Project-URL: Issues, https://github.com/negillett/alloc-context/issues
-Project-URL: Changelog, https://github.com/negillett/alloc-context/releases
+Project-URL: Documentation, https://github.com/AllocContext/alloc-context/blob/main/docs/agent-integration.md
+Project-URL: Repository, https://github.com/AllocContext/alloc-context
+Project-URL: Issues, https://github.com/AllocContext/alloc-context/issues
+Project-URL: Changelog, https://github.com/AllocContext/alloc-context/releases
 Project-URL: MCP Server, https://mcp.alloc-context.com/mcp
-Keywords: mcp,x402,bitcoin,ethereum,crypto,cryptocurrency,portfolio,allocation,holdings,rebalance,coinbase,kraken,agents
+Keywords: mcp,x402,holdings,portfolio,crypto,cryptocurrency,bitcoin,ethereum,agents,allocation,rebalance,coinbase,kraken
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -40,18 +40,23 @@ Requires-Dist: mcp>=1.6; extra == "dev"
 Requires-Dist: x402[evm,fastapi]>=2.0; extra == "dev"
 Requires-Dist: cdp-sdk>=1.46; extra == "dev"
 Requires-Dist: uvicorn[standard]>=0.30; extra == "dev"
+Requires-Dist: langchain-core>=0.3.0; extra == "dev"
 Dynamic: license-file
 
 # AllocContext
 
-[![smithery badge](https://smithery.ai/badge/@negillett/alloc-context)](https://smithery.ai/server/@negillett/alloc-context)
-[![Glama MCP server](https://glama.ai/mcp/servers/negillett/alloc-context/badges/score.svg)](https://glama.ai/mcp/servers/negillett/alloc-context)
+[![smithery badge](https://smithery.ai/badge/alloccontext/alloc-context)](https://smithery.ai/servers/alloccontext/alloc-context)
 
-mcp-name: io.github.negillett/alloc-context
+mcp-name: io.github.AllocContext/alloc-context
 
-**Portfolio-aware crypto context for agents** — discover holdings, market,
-sentiment, macro, and regime; optional allocation analysis. Deterministic
-JSON over MCP with x402 pay-per-call on Base.
+**Portfolio-aware crypto context for whatever you hold** — discover your
+holdings, holdings-scoped market data, sentiment, macro, and regime; optional
+allocation analysis when you supply targets. Deterministic JSON over MCP with
+x402 pay-per-call on Base.
+
+**New here?** [Agent on-ramp (~2 min)](docs/agent-onramp.md) — copy-paste path to
+your first ContextBundle. **Organization:**
+[AllocContext on GitHub](https://github.com/AllocContext) — overview and integration links.
 
 > **Privacy:** nothing stored · one-time read-only · pass-through only — your
 > keys and portfolio never persist on our servers. See [USE.md](docs/USE.md).
@@ -113,7 +118,7 @@ Not financial advice.
 | **Discovery** | [llms.txt](https://mcp.alloc-context.com/llms.txt), [x402 manifest](https://mcp.alloc-context.com/.well-known/x402.json) |
 | **Pricing** | **$0.02** cached context/math · **$0.05** live ingest or portfolio |
 | **Payment** | x402 on Base — USDC or EURC |
-| **Market scope** | Holdings-scoped (BTC/ETH OHLC; alt quote snapshots); bridge auto-scopes from portfolio |
+| **Market scope** | Tailored to your holdings (band OHLC for BTC/ETH; alt quote snapshots); bridge auto-scopes from portfolio |
 
 Agents and wallets connect directly to the hosted endpoint — see
 [agent-integration.md](docs/agent-integration.md). The Cursor bridge above
@@ -130,7 +135,7 @@ combines local portfolio reads with this upstream for market context.
 | `get_rebalance_plan` | USD rebalance moves from allocation, target, and NAV |
 | `check_allocation_band` | Drift vs target and whether allocation is outside the band |
 | `check_allocation_bands` | Batch band checks for multiple target scenarios |
-| `get_portfolio_state` | Live NAV and holdings from Kraken or Coinbase |
+| `get_portfolio_state` | Live NAV and holdings (e.g. Coinbase, Kraken read-only keys) |
 
 Market context is **holdings-scoped**: band assets (BTC/ETH) use OHLC bars; alt
 holdings (e.g. HYPE) use quote snapshots when cached. The bridge auto-scopes
@@ -142,11 +147,13 @@ See [mcp.md](docs/mcp.md) for arguments, pricing, and resources.
 ## Self-host and development
 
 Run ingest and MCP entirely on your machine — no x402 upstream required.
-See [self-hosting.md](docs/self-hosting.md) (`self_host: true` in user config)
-or [local-dev.md](docs/local-dev.md) for the dev stack.
+See [self-hosting.md](docs/self-hosting.md) (`self_host: true` in user config),
+[local-dev.md](docs/local-dev.md) for the native dev stack (`./scripts/dev-up.sh`),
+or `./docker/up.sh` / [docker-self-host.md](docs/docker-self-host.md) for Docker
+on loopback `:8000`.
 
 ```bash
-git clone git@github.com:negillett/alloc-context.git
+git clone git@github.com:AllocContext/alloc-context.git
 cd alloc-context
 python3.11 -m venv .venv && source .venv/bin/activate
 pip install -e ".[dev]"
@@ -172,6 +179,10 @@ HTTP MCP + x402: [mcp-http.md](docs/mcp-http.md). CLI entry point:
 
 | Document | Purpose |
 |----------|---------|
+| [docs/agent-onramp.md](docs/agent-onramp.md) | **Start here** — ~2 min to first ContextBundle |
+| [docs/deterministic-context-mcp-pattern.md](docs/deterministic-context-mcp-pattern.md) | Reusable ingest → rollup → MCP → x402 pattern |
+| [docs/langchain-integration.md](docs/langchain-integration.md) | LangChain tools for hosted MCP (x402) |
+| [docs/docker-self-host.md](docs/docker-self-host.md) | Docker Compose self-host evaluation |
 | [docs/cursor-mcp.md](docs/cursor-mcp.md) | Cursor stdio MCP (bridge default) |
 | [docs/user-config.md](docs/user-config.md) | Bridge `user.yaml` reference |
 | [docs/mcp.md](docs/mcp.md) | MCP tools and x402 |

{alloc_context-0.2.2 → alloc_context-0.2.4}/README.md

@@ -1,13 +1,17 @@
 # AllocContext
 
-[![smithery badge](https://smithery.ai/badge/@negillett/alloc-context)](https://smithery.ai/server/@negillett/alloc-context)
-[![Glama MCP server](https://glama.ai/mcp/servers/negillett/alloc-context/badges/score.svg)](https://glama.ai/mcp/servers/negillett/alloc-context)
+[![smithery badge](https://smithery.ai/badge/alloccontext/alloc-context)](https://smithery.ai/servers/alloccontext/alloc-context)
 
-mcp-name: io.github.negillett/alloc-context
+mcp-name: io.github.AllocContext/alloc-context
 
-**Portfolio-aware crypto context for agents** — discover holdings, market,
-sentiment, macro, and regime; optional allocation analysis. Deterministic
-JSON over MCP with x402 pay-per-call on Base.
+**Portfolio-aware crypto context for whatever you hold** — discover your
+holdings, holdings-scoped market data, sentiment, macro, and regime; optional
+allocation analysis when you supply targets. Deterministic JSON over MCP with
+x402 pay-per-call on Base.
+
+**New here?** [Agent on-ramp (~2 min)](docs/agent-onramp.md) — copy-paste path to
+your first ContextBundle. **Organization:**
+[AllocContext on GitHub](https://github.com/AllocContext) — overview and integration links.
 
 > **Privacy:** nothing stored · one-time read-only · pass-through only — your
 > keys and portfolio never persist on our servers. See [USE.md](docs/USE.md).
@@ -69,7 +73,7 @@ Not financial advice.
 | **Discovery** | [llms.txt](https://mcp.alloc-context.com/llms.txt), [x402 manifest](https://mcp.alloc-context.com/.well-known/x402.json) |
 | **Pricing** | **$0.02** cached context/math · **$0.05** live ingest or portfolio |
 | **Payment** | x402 on Base — USDC or EURC |
-| **Market scope** | Holdings-scoped (BTC/ETH OHLC; alt quote snapshots); bridge auto-scopes from portfolio |
+| **Market scope** | Tailored to your holdings (band OHLC for BTC/ETH; alt quote snapshots); bridge auto-scopes from portfolio |
 
 Agents and wallets connect directly to the hosted endpoint — see
 [agent-integration.md](docs/agent-integration.md). The Cursor bridge above
@@ -86,7 +90,7 @@ combines local portfolio reads with this upstream for market context.
 | `get_rebalance_plan` | USD rebalance moves from allocation, target, and NAV |
 | `check_allocation_band` | Drift vs target and whether allocation is outside the band |
 | `check_allocation_bands` | Batch band checks for multiple target scenarios |
-| `get_portfolio_state` | Live NAV and holdings from Kraken or Coinbase |
+| `get_portfolio_state` | Live NAV and holdings (e.g. Coinbase, Kraken read-only keys) |
 
 Market context is **holdings-scoped**: band assets (BTC/ETH) use OHLC bars; alt
 holdings (e.g. HYPE) use quote snapshots when cached. The bridge auto-scopes
@@ -98,11 +102,13 @@ See [mcp.md](docs/mcp.md) for arguments, pricing, and resources.
 ## Self-host and development
 
 Run ingest and MCP entirely on your machine — no x402 upstream required.
-See [self-hosting.md](docs/self-hosting.md) (`self_host: true` in user config)
-or [local-dev.md](docs/local-dev.md) for the dev stack.
+See [self-hosting.md](docs/self-hosting.md) (`self_host: true` in user config),
+[local-dev.md](docs/local-dev.md) for the native dev stack (`./scripts/dev-up.sh`),
+or `./docker/up.sh` / [docker-self-host.md](docs/docker-self-host.md) for Docker
+on loopback `:8000`.
 
 ```bash
-git clone git@github.com:negillett/alloc-context.git
+git clone git@github.com:AllocContext/alloc-context.git
 cd alloc-context
 python3.11 -m venv .venv && source .venv/bin/activate
 pip install -e ".[dev]"
@@ -128,6 +134,10 @@ HTTP MCP + x402: [mcp-http.md](docs/mcp-http.md). CLI entry point:
 
 | Document | Purpose |
 |----------|---------|
+| [docs/agent-onramp.md](docs/agent-onramp.md) | **Start here** — ~2 min to first ContextBundle |
+| [docs/deterministic-context-mcp-pattern.md](docs/deterministic-context-mcp-pattern.md) | Reusable ingest → rollup → MCP → x402 pattern |
+| [docs/langchain-integration.md](docs/langchain-integration.md) | LangChain tools for hosted MCP (x402) |
+| [docs/docker-self-host.md](docs/docker-self-host.md) | Docker Compose self-host evaluation |
 | [docs/cursor-mcp.md](docs/cursor-mcp.md) | Cursor stdio MCP (bridge default) |
 | [docs/user-config.md](docs/user-config.md) | Bridge `user.yaml` reference |
 | [docs/mcp.md](docs/mcp.md) | MCP tools and x402 |

{alloc_context-0.2.2 → alloc_context-0.2.4}/alloc_context.egg-info/PKG-INFO

@@ -1,15 +1,15 @@
 Metadata-Version: 2.4
 Name: alloc-context
-Version: 0.2.2
-Summary: Portfolio-aware crypto context for agents — holdings, market, optional allocation analysis
+Version: 0.2.4
+Summary: Portfolio-aware crypto context for agents — holdings-scoped market, sentiment, optional allocation analysis
 License: Elastic-2.0
 Project-URL: Homepage, https://mcp.alloc-context.com/llms.txt
-Project-URL: Documentation, https://github.com/negillett/alloc-context/blob/main/docs/agent-integration.md
-Project-URL: Repository, https://github.com/negillett/alloc-context
-Project-URL: Issues, https://github.com/negillett/alloc-context/issues
-Project-URL: Changelog, https://github.com/negillett/alloc-context/releases
+Project-URL: Documentation, https://github.com/AllocContext/alloc-context/blob/main/docs/agent-integration.md
+Project-URL: Repository, https://github.com/AllocContext/alloc-context
+Project-URL: Issues, https://github.com/AllocContext/alloc-context/issues
+Project-URL: Changelog, https://github.com/AllocContext/alloc-context/releases
 Project-URL: MCP Server, https://mcp.alloc-context.com/mcp
-Keywords: mcp,x402,bitcoin,ethereum,crypto,cryptocurrency,portfolio,allocation,holdings,rebalance,coinbase,kraken,agents
+Keywords: mcp,x402,holdings,portfolio,crypto,cryptocurrency,bitcoin,ethereum,agents,allocation,rebalance,coinbase,kraken
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -40,18 +40,23 @@ Requires-Dist: mcp>=1.6; extra == "dev"
 Requires-Dist: x402[evm,fastapi]>=2.0; extra == "dev"
 Requires-Dist: cdp-sdk>=1.46; extra == "dev"
 Requires-Dist: uvicorn[standard]>=0.30; extra == "dev"
+Requires-Dist: langchain-core>=0.3.0; extra == "dev"
 Dynamic: license-file
 
 # AllocContext
 
-[![smithery badge](https://smithery.ai/badge/@negillett/alloc-context)](https://smithery.ai/server/@negillett/alloc-context)
-[![Glama MCP server](https://glama.ai/mcp/servers/negillett/alloc-context/badges/score.svg)](https://glama.ai/mcp/servers/negillett/alloc-context)
+[![smithery badge](https://smithery.ai/badge/alloccontext/alloc-context)](https://smithery.ai/servers/alloccontext/alloc-context)
 
-mcp-name: io.github.negillett/alloc-context
+mcp-name: io.github.AllocContext/alloc-context
 
-**Portfolio-aware crypto context for agents** — discover holdings, market,
-sentiment, macro, and regime; optional allocation analysis. Deterministic
-JSON over MCP with x402 pay-per-call on Base.
+**Portfolio-aware crypto context for whatever you hold** — discover your
+holdings, holdings-scoped market data, sentiment, macro, and regime; optional
+allocation analysis when you supply targets. Deterministic JSON over MCP with
+x402 pay-per-call on Base.
+
+**New here?** [Agent on-ramp (~2 min)](docs/agent-onramp.md) — copy-paste path to
+your first ContextBundle. **Organization:**
+[AllocContext on GitHub](https://github.com/AllocContext) — overview and integration links.
 
 > **Privacy:** nothing stored · one-time read-only · pass-through only — your
 > keys and portfolio never persist on our servers. See [USE.md](docs/USE.md).
@@ -113,7 +118,7 @@ Not financial advice.
 | **Discovery** | [llms.txt](https://mcp.alloc-context.com/llms.txt), [x402 manifest](https://mcp.alloc-context.com/.well-known/x402.json) |
 | **Pricing** | **$0.02** cached context/math · **$0.05** live ingest or portfolio |
 | **Payment** | x402 on Base — USDC or EURC |
-| **Market scope** | Holdings-scoped (BTC/ETH OHLC; alt quote snapshots); bridge auto-scopes from portfolio |
+| **Market scope** | Tailored to your holdings (band OHLC for BTC/ETH; alt quote snapshots); bridge auto-scopes from portfolio |
 
 Agents and wallets connect directly to the hosted endpoint — see
 [agent-integration.md](docs/agent-integration.md). The Cursor bridge above
@@ -130,7 +135,7 @@ combines local portfolio reads with this upstream for market context.
 | `get_rebalance_plan` | USD rebalance moves from allocation, target, and NAV |
 | `check_allocation_band` | Drift vs target and whether allocation is outside the band |
 | `check_allocation_bands` | Batch band checks for multiple target scenarios |
-| `get_portfolio_state` | Live NAV and holdings from Kraken or Coinbase |
+| `get_portfolio_state` | Live NAV and holdings (e.g. Coinbase, Kraken read-only keys) |
 
 Market context is **holdings-scoped**: band assets (BTC/ETH) use OHLC bars; alt
 holdings (e.g. HYPE) use quote snapshots when cached. The bridge auto-scopes
@@ -142,11 +147,13 @@ See [mcp.md](docs/mcp.md) for arguments, pricing, and resources.
 ## Self-host and development
 
 Run ingest and MCP entirely on your machine — no x402 upstream required.
-See [self-hosting.md](docs/self-hosting.md) (`self_host: true` in user config)
-or [local-dev.md](docs/local-dev.md) for the dev stack.
+See [self-hosting.md](docs/self-hosting.md) (`self_host: true` in user config),
+[local-dev.md](docs/local-dev.md) for the native dev stack (`./scripts/dev-up.sh`),
+or `./docker/up.sh` / [docker-self-host.md](docs/docker-self-host.md) for Docker
+on loopback `:8000`.
 
 ```bash
-git clone git@github.com:negillett/alloc-context.git
+git clone git@github.com:AllocContext/alloc-context.git
 cd alloc-context
 python3.11 -m venv .venv && source .venv/bin/activate
 pip install -e ".[dev]"
@@ -172,6 +179,10 @@ HTTP MCP + x402: [mcp-http.md](docs/mcp-http.md). CLI entry point:
 
 | Document | Purpose |
 |----------|---------|
+| [docs/agent-onramp.md](docs/agent-onramp.md) | **Start here** — ~2 min to first ContextBundle |
+| [docs/deterministic-context-mcp-pattern.md](docs/deterministic-context-mcp-pattern.md) | Reusable ingest → rollup → MCP → x402 pattern |
+| [docs/langchain-integration.md](docs/langchain-integration.md) | LangChain tools for hosted MCP (x402) |
+| [docs/docker-self-host.md](docs/docker-self-host.md) | Docker Compose self-host evaluation |
 | [docs/cursor-mcp.md](docs/cursor-mcp.md) | Cursor stdio MCP (bridge default) |
 | [docs/user-config.md](docs/user-config.md) | Bridge `user.yaml` reference |
 | [docs/mcp.md](docs/mcp.md) | MCP tools and x402 |

{alloc_context-0.2.2 → alloc_context-0.2.4}/alloc_context.egg-info/SOURCES.txt

@@ -56,6 +56,8 @@ alloccontext/ingest/exchange/live.py
 alloccontext/ingest/exchange/portfolio.py
 alloccontext/ingest/exchange/registry.py
 alloccontext/ingest/exchange/types.py
+alloccontext/integrations/__init__.py
+alloccontext/integrations/langchain.py
 alloccontext/mcp/__init__.py
 alloccontext/mcp/assets.py
 alloccontext/mcp/bazaar.py
@@ -109,6 +111,7 @@ tests/test_backup_sqlite.py
 tests/test_bridge.py
 tests/test_bridge_portfolio.py
 tests/test_bump_version.py
+tests/test_check_pypi_release_json.py
 tests/test_coinbase_portfolio.py
 tests/test_config_cli.py
 tests/test_context_bundle_schema.py
@@ -129,6 +132,7 @@ tests/test_ingest_runner.py
 tests/test_ingest_store_integration.py
 tests/test_kalshi_api.py
 tests/test_kraken_portfolio.py
+tests/test_langchain_integration.py
 tests/test_live_ingest_handlers.py
 tests/test_macro.py
 tests/test_market_breadth.py

{alloc_context-0.2.2 → alloc_context-0.2.4}/alloc_context.egg-info/requires.txt

@@ -12,6 +12,7 @@ mcp>=1.6
 x402[evm,fastapi]>=2.0
 cdp-sdk>=1.46
 uvicorn[standard]>=0.30
+langchain-core>=0.3.0
 
 [hosted]
 mcp>=1.6

{alloc_context-0.2.2 → alloc_context-0.2.4}/alloccontext/__init__.py

@@ -1,3 +1,3 @@
 """AllocContext — portfolio-aware crypto context for agents (MCP)."""
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"

alloc_context-0.2.4/alloccontext/integrations/__init__.py

@@ -0,0 +1 @@
+"""Optional framework integrations (LangChain, etc.)."""

alloc_context-0.2.4/alloccontext/integrations/langchain.py

@@ -0,0 +1,125 @@
+"""LangChain tools for the hosted AllocContext MCP (x402 on Base)."""
+
+from __future__ import annotations
+
+import json
+from dataclasses import replace
+from typing import Any
+
+from alloccontext.mcp.bazaar import OFFICIAL_HOSTED_MCP_URL, mcp_tool_specs
+from alloccontext.mcp.upstream import call_upstream_tool
+from alloccontext.user_config import (
+    DEFAULT_UPSTREAM_URL,
+    UserConfig,
+    load_user_config,
+    resolve_user_config_path,
+)
+
+DEFAULT_HOSTED_TOOLS = (
+    "get_market_context",
+    "get_context_bundle",
+    "get_rebalance_plan",
+    "check_allocation_band",
+)
+
+
+def hosted_user_config(*, upstream_url: str | None = None) -> UserConfig:
+    """Minimal bridge user config for hosted-only LangChain calls."""
+    base = UserConfig.empty()
+    return replace(
+        base,
+        upstream=upstream_url or DEFAULT_UPSTREAM_URL,
+        self_host=False,
+    )
+
+
+def resolve_hosted_user_config(*, upstream_url: str | None = None) -> UserConfig:
+    """Hosted bridge config: ``user.yaml`` when present, else env-only defaults.
+
+    Loads ``~/.config/alloc-context/user.yaml`` (or ``ALLOC_CONTEXT_USER_CONFIG``)
+    so ``x402.payer_private_key_file`` and inline payer keys work like the stdio
+    bridge. Exchange blocks in ``user.yaml`` are ignored for hosted tool calls.
+    """
+    path = resolve_user_config_path()
+    if path is None or not path.is_file():
+        return hosted_user_config(upstream_url=upstream_url)
+
+    loaded = load_user_config(path)
+    upstream = upstream_url or loaded.upstream
+    if loaded.self_host:
+        return replace(
+            hosted_user_config(upstream_url=upstream),
+            x402=loaded.x402,
+            path=loaded.path,
+        )
+    return replace(loaded, upstream=upstream, self_host=False)
+
+
+def _args_model(tool_name: str, input_schema: dict[str, Any]) -> type[Any]:
+    from pydantic import Field, create_model
+
+    properties = input_schema.get("properties") or {}
+    required = frozenset(input_schema.get("required") or [])
+    field_defs: dict[str, Any] = {}
+    for key, prop in properties.items():
+        description = str(prop.get("description") or "")
+        if key in required:
+            field_defs[key] = (Any, Field(description=description))
+        else:
+            field_defs[key] = (Any | None, Field(default=None, description=description))
+    model_name = "".join(part.title() for part in tool_name.split("_")) + "Input"
+    return create_model(model_name, **field_defs)
+
+
+def build_hosted_langchain_tools(
+    user: UserConfig | None = None,
+    *,
+    tool_names: tuple[str, ...] | None = None,
+) -> list[Any]:
+    """Return LangChain tools that call the hosted MCP with x402 payment.
+
+    Requires ``langchain-core`` and ``alloc-context[hosted]``. Configure an x402
+    payer via ``EVM_PRIVATE_KEY``, ``user.yaml`` (``x402.payer_private_key_file``),
+    or pass a ``UserConfig`` explicitly.
+    """
+    try:
+        from langchain_core.tools import StructuredTool
+    except ImportError as exc:
+        raise ImportError(
+            "LangChain integration requires langchain-core: pip install langchain-core"
+        ) from exc
+
+    user = user or resolve_hosted_user_config()
+    selected = frozenset(tool_names or DEFAULT_HOSTED_TOOLS)
+    specs = {spec["tool_name"]: spec for spec in mcp_tool_specs()}
+    missing = selected - specs.keys()
+    if missing:
+        raise ValueError(f"Unknown MCP tool(s): {', '.join(sorted(missing))}")
+
+    tools: list[Any] = []
+    for name in tool_names or DEFAULT_HOSTED_TOOLS:
+        spec = specs[name]
+
+        def _invoke(*, _tool_name: str = name, **kwargs: Any) -> str:
+            arguments = {key: value for key, value in kwargs.items() if value is not None}
+            payload = call_upstream_tool(user, _tool_name, arguments)
+            if payload.get("reason") == "upstream_payment_required":
+                message = payload.get("message") or (
+                    "Configure an x402 payer wallet to call hosted upstream."
+                )
+                raise RuntimeError(message)
+            return json.dumps(payload, separators=(",", ":"))
+
+        tools.append(
+            StructuredTool(
+                name=name,
+                description=spec["description"],
+                func=_invoke,
+                args_schema=_args_model(name, spec["input_schema"]),
+            )
+        )
+    return tools
+
+
+def official_hosted_mcp_url() -> str:
+    return OFFICIAL_HOSTED_MCP_URL