Merge branch 'main_merge_261017' into 'main'

feat:th mcp open

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

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, my, uk, mx, br, or za
+# Region ID: us, hk, jp, sg, th, my, uk, mx, br, or za
 # Default: us
 # WEBULL_REGION_ID=us
 

mcpb/build_manifest.py

@@ -194,7 +194,7 @@ def build_manifest(
             "region_id": {
                 "type": "string",
                 "title": "Region",
-                "description": "Webull region: us, hk, jp, sg, my, uk, mx, br, or za.",
+                "description": "Webull region: us, hk, jp, sg, th, my, uk, mx, br, or za.",
                 "default": "us",
                 "required": True,
             },

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "webull-openapi-mcp"
-version = "1.2.4"
+version = "1.2.5"
 description = "MCP Server for Webull OpenAPI - enables AI assistants to securely access Webull trading and market data"
 readme = "README.md"
 license = "Apache-2.0"

server.json

@@ -3,7 +3,7 @@
   "name": "io.github.webull-inc/webull-openapi-mcp",
   "title": "Webull OpenAPI",
   "description": "MCP server for Webull OpenAPI: trading and market data access for AI assistants",
-  "version": "1.2.4",
+  "version": "1.2.5",
   "repository": {
     "url": "https://github.com/webull-inc/webull-openapi-mcp",
     "source": "github"
@@ -13,7 +13,7 @@
       "registryType": "pypi",
       "registryBaseUrl": "https://pypi.org",
       "identifier": "webull-openapi-mcp",
-      "version": "1.2.4",
+      "version": "1.2.5",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

tests/test_fundamental_screener_registration.py

@@ -199,14 +199,14 @@ def test_new_tools_registered_for_supported_regions(region):
     assert not missing, f"{region} missing: {missing}"
 
 
-@pytest.mark.parametrize("region", ["sg", "my", "uk", "mx", "br"])
+@pytest.mark.parametrize("region", ["sg", "th", "my", "uk", "mx", "br"])
 def test_new_tools_absent_for_unsupported_regions(region):
     names = _build_server_tools(region)
     present = [t for t in EXPECTED_TOOLS if t in names]
     assert present, f"{region} should not expose: {present}"
 
 
-@pytest.mark.parametrize("region", ["us", "hk", "jp", "sg", "my", "uk", "mx", "br"])
+@pytest.mark.parametrize("region", ["us", "hk", "jp", "sg", "th", "my", "uk", "mx", "br"])
 def test_legacy_tools_available_in_all_regions(region):
     names = _build_server_tools(region)
     missing = [t for t in LEGACY_TOOLS if t not in names]

tests/test_sdk_client.py

@@ -27,10 +27,10 @@ def test_default_region_is_us(self):
         assert UAT_ENDPOINTS["default_region"] == "us"
 
     def test_regions_list(self):
-        assert set(UAT_ENDPOINTS["regions"]) == {"us", "hk", "jp", "sg", "my", "uk", "mx", "br", "za"}
+        assert set(UAT_ENDPOINTS["regions"]) == {"us", "hk", "jp", "sg", "th", "my", "uk", "mx", "br", "za"}
 
     def test_each_region_has_all_api_types(self):
-        for region in ("us", "hk", "jp", "sg", "my", "uk", "mx", "br", "za"):
+        for region in ("us", "hk", "jp", "sg", "th", "my", "uk", "mx", "br", "za"):
             mapping = UAT_ENDPOINTS["region_mapping"][region]
             assert "api" in mapping
             assert "quotes-api" in mapping

webull_openapi_mcp/__init__.py

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

webull_openapi_mcp/cli.py

@@ -152,7 +152,7 @@ def _build_env_content(app_key: str, app_secret: str, environment: str) -> str:
 # API environment: uat or prod (default: uat)
 WEBULL_ENVIRONMENT={environment}
 
-# Optional: Region ID (default: us). Supported: us, hk, jp, sg, my, uk, mx, br, za
+# Optional: Region ID (default: us). Supported: us, hk, jp, sg, th, my, uk, mx, br, za
 # WEBULL_REGION_ID=us
 
 # Optional: Risk control parameters

webull_openapi_mcp/formatters.py

@@ -55,6 +55,13 @@ def format_decimal(value: float | int) -> str:
     "Trading involves risk; please make decisions carefully.\n\n"
 )
 
+_DISCLAIMER_TH = (
+    "⚠️ 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_MY = (
     "⚠️ Disclaimer: "
     "The information provided by this tool is for reference only "
@@ -86,6 +93,8 @@ def set_disclaimer_region(region_id: str) -> None:
         DISCLAIMER = _DISCLAIMER_JP
     elif _current_region == "sg":
         DISCLAIMER = _DISCLAIMER_SG
+    elif _current_region == "th":
+        DISCLAIMER = _DISCLAIMER_TH
     elif _current_region == "my":
         DISCLAIMER = _DISCLAIMER_MY
     elif _current_region == "uk":

webull_openapi_mcp/region_config.py

@@ -1,6 +1,6 @@
 """Region-specific configuration for Webull MCP Server.
 
-Defines region configurations for US, HK, JP, SG, MY, UK, MX, BR, and ZA markets with:
+Defines region configurations for US, HK, JP, SG, TH, MY, UK, MX, BR, and ZA markets with:
 - Feature flags (futures, crypto, event contracts, etc.)
 - Valid enum sets for order types, time-in-force, trading sessions, etc.
 
@@ -195,6 +195,35 @@ def __post_init__(self) -> None:
 )
 
 
+# =============================================================================
+# TH Region Configuration
+# =============================================================================
+TH_REGION_CONFIG = RegionConfig(
+    region_id="th",
+    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,
+    supports_fundamentals=True,
+    asset_type_account_classes={
+        "stock": frozenset({"INDIVIDUAL_CASH"}),
+    },
+)
+
+
 # =============================================================================
 # MY Region Configuration
 # =============================================================================
@@ -406,12 +435,13 @@ def __post_init__(self) -> None:
     "hk": HK_REGION_CONFIG,
     "jp": JP_REGION_CONFIG,
     "sg": SG_REGION_CONFIG,
+    "th": TH_REGION_CONFIG,
     "my": MY_REGION_CONFIG,
     "uk": UK_REGION_CONFIG,
     "mx": MX_REGION_CONFIG,
     "br": BR_REGION_CONFIG,
     "za": ZA_REGION_CONFIG,
-    # Note: TH, EU, and AU are not supported yet due to compliance
+    # Note: EU and AU are not supported yet due to compliance
     # requirements and are intentionally not registered, so selecting these
     # regions raises UnsupportedRegionError. Their RegionConfig objects are
     # kept defined above for quick re-enablement once compliance clears.