quantworlds-mcp 1.0.0__py3-none-any.whl

quantworlds_mcp/__init__.py

@@ -0,0 +1 @@
+"""Proxy the hosted QuantWorlds tools over stdio MCP."""

quantworlds_mcp/server.py

@@ -0,0 +1,110 @@
+"""stdio MCP server that forwards tool calls to https://api.quantworlds.com."""
+
+import os
+
+import httpx
+from mcp.server.mcpserver import MCPServer
+
+API = os.environ.get("QUANTWORLDS_API", "https://api.quantworlds.com").rstrip("/")
+mcp = MCPServer("QuantWorlds")
+
+
+def _post(path: str, payload: dict) -> dict:
+    response = httpx.post(f"{API}{path}", json=payload, timeout=60)
+    try:
+        body = response.json()
+    except ValueError:
+        body = {"error": response.text}
+    if response.status_code >= 400:
+        body["http_status"] = response.status_code
+    return body
+
+
+@mcp.tool(name="options_surface_pricer")
+def options_surface_pricer(
+    spot: float,
+    strikes: list[float],
+    time_to_expiry_years: float,
+    risk_free_rate: float,
+    dividend_yield: float,
+    iv_array: list[float],
+    option_type: str = "call",
+    is_american: bool = True,
+) -> dict:
+    """Price an option surface. Supply spot, strikes, and implied volatilities."""
+    return _post("/v1/verify/options-surface", {
+        "spot": spot,
+        "strikes": strikes,
+        "time_to_expiry_years": time_to_expiry_years,
+        "risk_free_rate": risk_free_rate,
+        "dividend_yield": dividend_yield,
+        "iv_array": iv_array,
+        "option_type": option_type,
+        "is_american": is_american,
+    })
+
+
+@mcp.tool(name="instant_signal_backtest")
+def instant_signal_backtest(
+    prices: list[float],
+    raw_signals: list[float],
+    fee_bps: float = 2.0,
+    order_book_depth_usd: float = 500000.0,
+    trade_size_usd: float = 50000.0,
+    trials_tested_by_agent: int = 10,
+) -> dict:
+    """Backtest a signal against caller-supplied prices. The signal earns the next bar."""
+    return _post("/v1/verify/backtest", {
+        "prices": prices,
+        "raw_signals": raw_signals,
+        "fee_bps": fee_bps,
+        "order_book_depth_usd": order_book_depth_usd,
+        "trade_size_usd": trade_size_usd,
+        "trials_tested_by_agent": trials_tested_by_agent,
+    })
+
+
+@mcp.tool(name="portfolio_stress_verifier")
+def portfolio_stress_verifier(
+    current_weights: list[float],
+    proposed_weights: list[float],
+    asset_vols_annual: list[float],
+    asset_betas: list[float],
+    correlation_matrix: list[list[float]],
+    confidence_level: float = 0.99,
+    scenario: str = "2020_COVID_LIQUIDITY_CRASH",
+) -> dict:
+    """Parametric portfolio VaR, CVaR, and crisis shock from caller-supplied inputs."""
+    return _post("/v1/verify/portfolio-stress", {
+        "current_weights": current_weights,
+        "proposed_weights": proposed_weights,
+        "asset_vols_annual": asset_vols_annual,
+        "asset_betas": asset_betas,
+        "correlation_matrix": correlation_matrix,
+        "confidence_level": confidence_level,
+        "scenario": scenario,
+    })
+
+
+@mcp.tool(name="microstructure_coint_test")
+def microstructure_coint_test(
+    series_y: list[float],
+    series_x: list[float],
+    bid_volumes: list[float] | None = None,
+    ask_volumes: list[float] | None = None,
+) -> dict:
+    """Engle-Granger cointegration check for two caller-supplied price series."""
+    return _post("/v1/verify/cointegration", {
+        "series_y": series_y,
+        "series_x": series_x,
+        "bid_volumes": bid_volumes,
+        "ask_volumes": ask_volumes,
+    })
+
+
+def main() -> None:
+    mcp.run(transport="stdio")
+
+
+if __name__ == "__main__":
+    main()

quantworlds_mcp-1.0.0.dist-info/METADATA

@@ -0,0 +1,19 @@
+Metadata-Version: 2.4
+Name: quantworlds-mcp
+Version: 1.0.0
+Summary: MCP client for the QuantWorlds verification API.
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: mcp>=2.0.0
+Requires-Dist: httpx>=0.27.0
+
+# quantworlds-mcp
+
+stdio MCP server that forwards the four QuantWorlds tools to `https://api.quantworlds.com`.
+
+```bash
+pip install quantworlds-mcp
+quantworlds-mcp
+```
+
+The hosted remote endpoint is `https://api.quantworlds.com/mcp`. Publishing this package to PyPI requires a PyPI account on this machine.

quantworlds_mcp-1.0.0.dist-info/RECORD

@@ -0,0 +1,7 @@
+quantworlds_mcp/__init__.py,sha256=C8WAgmSawaPbyhCGxWEjP1xkrZAYYxpnxqFS3SGHyNw,57
+quantworlds_mcp/server.py,sha256=wWx8wlaEVhMEhDEGewII97HaK3k-GMHKnrRkJGKB2eM,3369
+quantworlds_mcp-1.0.0.dist-info/METADATA,sha256=ixVO-74DGeqd6jh1zzvduOILLNpiYMGLHXud29z1XjE,544
+quantworlds_mcp-1.0.0.dist-info/WHEEL,sha256=mOdXR9C3wMVov7cSY8PY-XCzo3SmmWCHvGQr5csJoao,91
+quantworlds_mcp-1.0.0.dist-info/entry_points.txt,sha256=zy2Nph-9eVp5RaHn0eCWOQCfLHahg6v2BkvyKRu_UVE,64
+quantworlds_mcp-1.0.0.dist-info/top_level.txt,sha256=ETpqqbm8gHKZsW_t8m8jlTfN-2HNOQrWuIUDABZKGrc,16
+quantworlds_mcp-1.0.0.dist-info/RECORD,,

quantworlds_mcp-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.2.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

quantworlds_mcp-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+quantworlds-mcp = quantworlds_mcp.server:main

quantworlds_mcp-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+quantworlds_mcp