Merge branch 'main_merge_20260613' into 'main'

feat: Add MY/UK mcp functions

See merge request webull/webull-openapi-mcp!6

Author: 方佳

.env.example

@@ -20,7 +20,7 @@ WEBULL_APP_SECRET=
 # Set to 'prod' for live trading (use with caution)
 # WEBULL_ENVIRONMENT=uat
 
-# Region ID: us, hk, jp, sg, or th
+# Region ID: us, hk, jp, sg, th, my, or uk
 # Default: us
 # WEBULL_REGION_ID=us
 

README.md

@@ -4,11 +4,11 @@ build-backend = "hatchling.build"
 
 [project]
 name = "webull-openapi-mcp"
-version = "1.1.2"
+version = "1.1.3"
 description = "MCP Server for Webull OpenAPI - enables AI assistants to securely access Webull trading and market data"
 readme = "README.md"
 license = "Apache-2.0"
-requires-python = ">=3.10"
+requires-python = ">=3.10,<3.13"
 keywords = ["webull", "mcp", "openapi", "trading", "ai"]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -24,7 +24,7 @@ dependencies = [
     "fastmcp==3.0.2",
     "click",
     "python-dotenv",
-    "webull-openapi-python-sdk==2.0.8",
+    "webull-openapi-python-sdk==2.0.9",
 ]
 
 [project.urls]

pyproject.toml

@@ -1,3 +1,3 @@
 """Webull OpenAPI MCP Server - AI assistant integration for Webull OpenAPI."""
 
-__version__ = "1.1.2"
+__version__ = "1.1.3"

webull_openapi_mcp/__init__.py

@@ -51,6 +51,20 @@
     "Trading involves risk; please make decisions carefully.\n\n"
 )
 
+_DISCLAIMER_MY = (
+    "⚠️ Disclaimer: "
+    "The information provided by this tool is for reference only "
+    "and does not constitute investment advice. "
+    "Trading involves risk; please make decisions carefully.\n\n"
+)
+
+_DISCLAIMER_UK = (
+    "⚠️ Disclaimer: "
+    "The information provided by this tool is for reference only "
+    "and does not constitute investment advice. "
+    "Trading involves risk; please make decisions carefully.\n\n"
+)
+
 # Default (backward compatibility)
 DISCLAIMER = _DISCLAIMER_US
 
@@ -70,6 +84,10 @@ def set_disclaimer_region(region_id: str) -> None:
         DISCLAIMER = _DISCLAIMER_SG
     elif _current_region == "th":
         DISCLAIMER = _DISCLAIMER_TH
+    elif _current_region == "my":
+        DISCLAIMER = _DISCLAIMER_MY
+    elif _current_region == "uk":
+        DISCLAIMER = _DISCLAIMER_UK
     else:
         DISCLAIMER = _DISCLAIMER_US
 

webull_openapi_mcp/formatters.py

@@ -170,6 +170,56 @@ class RegionConfig:
 )
 
 
+# =============================================================================
+# MY Region Configuration
+# =============================================================================
+MY_REGION_CONFIG = RegionConfig(
+    region_id="my",
+    supports_futures=False,
+    supports_crypto=False,
+    supports_event_contracts=False,
+    supports_combo_orders=False,
+    supports_option_strategies=False,
+    supports_algo_orders=False,
+    valid_order_types=frozenset({
+        "MARKET", "LIMIT", "STOP_LOSS", "STOP_LOSS_LIMIT"
+    }),
+    valid_time_in_force=frozenset({"DAY", "GTC"}),
+    valid_trading_sessions=frozenset({"NIGHT", "ALL", "CORE", "ALL_DAY"}),
+    valid_combo_types=frozenset({"NORMAL"}),
+    valid_option_strategies=frozenset({"SINGLE"}),
+    valid_market_categories=frozenset({"US"}),
+    valid_order_markets=frozenset({"US"}),
+    valid_instrument_categories=frozenset({"US_STOCK", "US_ETF"}),
+    supports_options=False,
+)
+
+
+# =============================================================================
+# UK Region Configuration
+# =============================================================================
+UK_REGION_CONFIG = RegionConfig(
+    region_id="uk",
+    supports_futures=False,
+    supports_crypto=False,
+    supports_event_contracts=False,
+    supports_combo_orders=False,
+    supports_option_strategies=False,
+    supports_algo_orders=False,
+    valid_order_types=frozenset({
+        "MARKET", "LIMIT", "STOP_LOSS", "STOP_LOSS_LIMIT"
+    }),
+    valid_time_in_force=frozenset({"DAY", "GTC"}),
+    valid_trading_sessions=frozenset({"NIGHT", "ALL", "CORE", "ALL_DAY"}),
+    valid_combo_types=frozenset({"NORMAL"}),
+    valid_option_strategies=frozenset({"SINGLE"}),
+    valid_market_categories=frozenset({"US"}),
+    valid_order_markets=frozenset({"US"}),
+    valid_instrument_categories=frozenset({"US_STOCK", "US_ETF"}),
+    supports_options=False,
+)
+
+
 # =============================================================================
 # Region Configuration Registry
 # =============================================================================
@@ -179,6 +229,8 @@ class RegionConfig:
     "jp": JP_REGION_CONFIG,
     "sg": SG_REGION_CONFIG,
     "th": TH_REGION_CONFIG,
+    "my": MY_REGION_CONFIG,
+    "uk": UK_REGION_CONFIG,
 }
 
 SUPPORTED_REGIONS: frozenset[str] = frozenset(REGION_CONFIGS.keys())

webull_openapi_mcp/region_config.py

@@ -20,8 +20,10 @@
 _2FA_GUIDE_LINKS: dict[str, str] = {
     "hk": "https://developer.webull.hk/apis/docs/authentication/token",
     "jp": "https://developer.webull.co.jp/apis/docs/authentication/token",
+    "my": "https://developer.webull.com.my/apis/docs/authentication/token",
     "sg": "https://developer.webull.com.sg/apis/docs/authentication/token",
     "th": "https://developer.webull.co.th/apis/docs/authentication/token",
+    "uk": "https://developer.webull-uk.com/apis/docs/authentication/token",
     "us": "https://developer.webull.com/apis/docs/authentication/token",
 }
 
@@ -134,7 +136,7 @@ def __init__(self, region_id: str, environment: str) -> None:
 # based on each request's api_type - no add_endpoint() calls needed.
 UAT_ENDPOINTS: dict = {
     "default_region": "us",
-    "regions": ["us", "hk", "jp", "sg", "th"],
+    "regions": ["us", "hk", "jp", "sg", "th", "my", "uk"],
     "region_mapping": {
         "us": {
             "api": "us-openapi-alb.uat.webullbroker.com",
@@ -161,6 +163,16 @@ def __init__(self, region_id: str, environment: str) -> None:
             "quotes-api": "data-api.uat.webullbroker.com",
             "events-api": "th-events-api.uat.webullbroker.com",
         },
+        "my": {
+            "api": "my-api.uat.webullbroker.com",
+            "quotes-api": "data-api.uat.webullbroker.com",
+            "events-api": "my-events-api.uat.webullbroker.com",
+        },
+        "uk": {
+            "api": "uk-api.uat.webullbroker.com",
+            "quotes-api": "data-api.uat.webullbroker.com",
+            "events-api": "uk-events-api.uat.webullbroker.com",
+        },
     },
 }