webull-openapi-mcp 1.2.4__tar.gz → 1.2.6__tar.gz

{webull_openapi_mcp-1.2.4 → webull_openapi_mcp-1.2.6}/.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
 

{webull_openapi_mcp-1.2.4 → webull_openapi_mcp-1.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: webull-openapi-mcp
-Version: 1.2.4
+Version: 1.2.6
 Summary: MCP Server for Webull OpenAPI - enables AI assistants to securely access Webull trading and market data
 Project-URL: Homepage, https://github.com/webull-inc/webull-openapi-mcp
 Project-URL: Repository, https://github.com/webull-inc/webull-openapi-mcp
@@ -20,7 +20,7 @@ Requires-Python: <3.13,>=3.10
 Requires-Dist: click
 Requires-Dist: fastmcp==3.0.2
 Requires-Dist: python-dotenv
-Requires-Dist: webull-openapi-python-sdk==3.0.0
+Requires-Dist: webull-openapi-python-sdk==3.0.4
 Provides-Extra: dev
 Requires-Dist: hypothesis; extra == 'dev'
 Requires-Dist: pytest; extra == 'dev'
@@ -54,6 +54,7 @@ See [DISCLAIMER.md](DISCLAIMER.md) for the full disclaimer.
 - **NOII Data** — Net Order Imbalance Indicator bars and snapshots for US stock opening/closing auctions
 - **Screener** — Top gainers/losers, most active, market sectors, high dividend, and 52-week high/low rankings
 - **Watchlist** — Create, manage, and query user watchlists and instruments
+- **Community** (US only) — Create posts and comments, list hot stocks, browse posts by symbol, view post details, and list your own posts
 - **Fundamental Data** — Company profiles, analyst ratings, and target prices
 - **Stock & Fund Fundamentals** — Capital flow, SEC filings, earnings/dividend calendar, forecast EPS, industry comparison, and full fund data (rating, performance, allocation, holdings, brief, dividends, splits, net value, files)
 - **Financial Statements** — Financial alert, indicators, income statement, balance sheet, and cash flow
@@ -93,6 +94,12 @@ Here are some prompts you can use with your AI assistant:
 - Add AAPL and MSFT to my watchlist
 - What stocks are in my watchlist?
 
+**Community**
+- What are the community hot stocks right now?
+- Show me recent community posts about NVDA
+- Post "Great earnings report!" tagged with AAPL
+- List my community posts
+
 **Fundamental & Analyst**
 - Tell me about NVDA's company profile
 - What do analysts rate AAPL?
@@ -333,8 +340,11 @@ See [.env.example](.env.example) for full configuration template.
 | **Crypto** | `get_crypto_snapshot`, `get_crypto_bars`                                                                                                                                                               | US |
 | **Option** | `get_option_tick`, `get_option_snapshot`, `get_option_bars`                                                                                                                                            | US, HK, JP |
 | **Event** | `get_event_tick`, `get_event_snapshot`, `get_event_depth`, `get_event_bars`                                                                                                                            | US |
+| **Market Insights** | `get_market_sentiment`, `get_stock_unusual_activities`, `get_institution_identifier`, `get_institution_holdings`, `get_institution_holding_changes`, `get_insider_transactions`, `get_insider_holdings`, `get_macroeconomic_calendar` | US |
+| **News** | `search_news`, `get_news_detail`, `get_stock_news` | US |
 | **Screener** | `get_gainers_losers`, `get_most_active`, `get_market_sectors`, `get_market_sectors_detail`, `get_high_dividend`, `get_52_week_high_low`                                                                                                                                                              | All |
 | **Watchlist** | `get_watchlists`, `create_watchlist`, `update_watchlist`, `delete_watchlist`, `get_watchlist_instruments`, `add_watchlist_instruments`, `remove_watchlist_instruments`, `update_watchlist_instruments` | All |
+| **Community** | `create_community_post`, `create_community_comment`, `get_community_hot_stocks`, `get_community_posts`, `get_community_post_detail`, `get_my_community_posts` | US |
 
 ### Fundamental & Instrument
 
@@ -432,7 +442,7 @@ All commands accept `--env-file PATH` to specify a custom `.env` file location (
 - **Review before trading** — Always review order details proposed by the AI before confirming. Use `preview_stock_order` / `preview_option_order` before placing orders.
 - **Use toolset filtering** — Set `WEBULL_TOOLSETS=account,market-data` to disable trading tools entirely if you only need read-only access. Valid toolsets: `account`, `market-data`, `trading`, `instrument`.
 - **Default sandbox** — The server defaults to UAT (sandbox) environment. You must explicitly set `WEBULL_ENVIRONMENT=prod` for live trading.
-- **Dependency security** — `fastmcp` is pinned to version `3.0.2` and `webull-openapi-python-sdk` is pinned to `3.0.0`. Users are responsible for monitoring and updating third-party dependencies for security patches. Review release notes before upgrading.
+- **Dependency security** — `fastmcp` is pinned to version `3.0.2` and `webull-openapi-python-sdk` is pinned to `3.0.4`. Users are responsible for monitoring and updating third-party dependencies for security patches. Review release notes before upgrading.
 
 ---
 
@@ -528,6 +538,7 @@ webull-openapi-mcp/
 │       │   ├── event.py    # Event contract market data
 │       │   ├── screener.py # Gainers/losers, most active, market sectors, high dividend, 52-week high/low
 │       │   ├── watchlist.py# Watchlist CRUD and instrument management
+│       │   ├── community.py # Community posts, comments, hot stocks
 │       │   ├── fundamental.py # Company profile, analyst data; stock & fund fundamentals (US/HK/JP)
 │       │   └── financial.py   # Financial statements: alert, indicators, income, balance sheet, cash flow (US/HK/JP)
 │       └── trading/

{webull_openapi_mcp-1.2.4 → webull_openapi_mcp-1.2.6}/README.md

@@ -24,6 +24,7 @@ See [DISCLAIMER.md](DISCLAIMER.md) for the full disclaimer.
 - **NOII Data** — Net Order Imbalance Indicator bars and snapshots for US stock opening/closing auctions
 - **Screener** — Top gainers/losers, most active, market sectors, high dividend, and 52-week high/low rankings
 - **Watchlist** — Create, manage, and query user watchlists and instruments
+- **Community** (US only) — Create posts and comments, list hot stocks, browse posts by symbol, view post details, and list your own posts
 - **Fundamental Data** — Company profiles, analyst ratings, and target prices
 - **Stock & Fund Fundamentals** — Capital flow, SEC filings, earnings/dividend calendar, forecast EPS, industry comparison, and full fund data (rating, performance, allocation, holdings, brief, dividends, splits, net value, files)
 - **Financial Statements** — Financial alert, indicators, income statement, balance sheet, and cash flow
@@ -63,6 +64,12 @@ Here are some prompts you can use with your AI assistant:
 - Add AAPL and MSFT to my watchlist
 - What stocks are in my watchlist?
 
+**Community**
+- What are the community hot stocks right now?
+- Show me recent community posts about NVDA
+- Post "Great earnings report!" tagged with AAPL
+- List my community posts
+
 **Fundamental & Analyst**
 - Tell me about NVDA's company profile
 - What do analysts rate AAPL?
@@ -303,8 +310,11 @@ See [.env.example](.env.example) for full configuration template.
 | **Crypto** | `get_crypto_snapshot`, `get_crypto_bars`                                                                                                                                                               | US |
 | **Option** | `get_option_tick`, `get_option_snapshot`, `get_option_bars`                                                                                                                                            | US, HK, JP |
 | **Event** | `get_event_tick`, `get_event_snapshot`, `get_event_depth`, `get_event_bars`                                                                                                                            | US |
+| **Market Insights** | `get_market_sentiment`, `get_stock_unusual_activities`, `get_institution_identifier`, `get_institution_holdings`, `get_institution_holding_changes`, `get_insider_transactions`, `get_insider_holdings`, `get_macroeconomic_calendar` | US |
+| **News** | `search_news`, `get_news_detail`, `get_stock_news` | US |
 | **Screener** | `get_gainers_losers`, `get_most_active`, `get_market_sectors`, `get_market_sectors_detail`, `get_high_dividend`, `get_52_week_high_low`                                                                                                                                                              | All |
 | **Watchlist** | `get_watchlists`, `create_watchlist`, `update_watchlist`, `delete_watchlist`, `get_watchlist_instruments`, `add_watchlist_instruments`, `remove_watchlist_instruments`, `update_watchlist_instruments` | All |
+| **Community** | `create_community_post`, `create_community_comment`, `get_community_hot_stocks`, `get_community_posts`, `get_community_post_detail`, `get_my_community_posts` | US |
 
 ### Fundamental & Instrument
 
@@ -402,7 +412,7 @@ All commands accept `--env-file PATH` to specify a custom `.env` file location (
 - **Review before trading** — Always review order details proposed by the AI before confirming. Use `preview_stock_order` / `preview_option_order` before placing orders.
 - **Use toolset filtering** — Set `WEBULL_TOOLSETS=account,market-data` to disable trading tools entirely if you only need read-only access. Valid toolsets: `account`, `market-data`, `trading`, `instrument`.
 - **Default sandbox** — The server defaults to UAT (sandbox) environment. You must explicitly set `WEBULL_ENVIRONMENT=prod` for live trading.
-- **Dependency security** — `fastmcp` is pinned to version `3.0.2` and `webull-openapi-python-sdk` is pinned to `3.0.0`. Users are responsible for monitoring and updating third-party dependencies for security patches. Review release notes before upgrading.
+- **Dependency security** — `fastmcp` is pinned to version `3.0.2` and `webull-openapi-python-sdk` is pinned to `3.0.4`. Users are responsible for monitoring and updating third-party dependencies for security patches. Review release notes before upgrading.
 
 ---
 
@@ -498,6 +508,7 @@ webull-openapi-mcp/
 │       │   ├── event.py    # Event contract market data
 │       │   ├── screener.py # Gainers/losers, most active, market sectors, high dividend, 52-week high/low
 │       │   ├── watchlist.py# Watchlist CRUD and instrument management
+│       │   ├── community.py # Community posts, comments, hot stocks
 │       │   ├── fundamental.py # Company profile, analyst data; stock & fund fundamentals (US/HK/JP)
 │       │   └── financial.py   # Financial statements: alert, indicators, income, balance sheet, cash flow (US/HK/JP)
 │       └── trading/

{webull_openapi_mcp-1.2.4 → webull_openapi_mcp-1.2.6}/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,
             },

{webull_openapi_mcp-1.2.4 → webull_openapi_mcp-1.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "webull-openapi-mcp"
-version = "1.2.4"
+version = "1.2.6"
 description = "MCP Server for Webull OpenAPI - enables AI assistants to securely access Webull trading and market data"
 readme = "README.md"
 license = "Apache-2.0"
@@ -24,7 +24,7 @@ dependencies = [
     "fastmcp==3.0.2",
     "click",
     "python-dotenv",
-    "webull-openapi-python-sdk==3.0.0",
+    "webull-openapi-python-sdk==3.0.4",
 ]
 
 [project.urls]

{webull_openapi_mcp-1.2.4 → webull_openapi_mcp-1.2.6}/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.6",
   "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.6",
       "runtimeHint": "uvx",
       "transport": {
         "type": "stdio"

webull_openapi_mcp-1.2.6/tests/test_community_tools.py

@@ -0,0 +1,126 @@
+"""Unit tests for community formatters (posts, comments, hot stocks)."""
+
+from __future__ import annotations
+
+import pytest
+
+from webull_openapi_mcp.formatters import (
+    format_community_create_result,
+    format_community_hot_stocks,
+    format_community_post_detail,
+    format_community_post_list,
+)
+
+
+_NO_DATA = "No data available."
+
+
+# ---------------------------------------------------------------------------
+# Empty / None data handling
+# ---------------------------------------------------------------------------
+
+@pytest.mark.parametrize("fn", [
+    format_community_hot_stocks,
+    format_community_post_list,
+    format_community_post_detail,
+])
+def test_returns_no_data_for_none(fn):
+    assert fn(None) == _NO_DATA
+
+
+@pytest.mark.parametrize("fn", [
+    format_community_hot_stocks,
+    format_community_post_list,
+])
+def test_returns_no_data_for_empty_list(fn):
+    assert fn([]) == _NO_DATA
+
+
+# ---------------------------------------------------------------------------
+# Create result (post / comment)
+# ---------------------------------------------------------------------------
+
+class TestFormatCreateResult:
+    def test_formats_post_id(self):
+        out = format_community_create_result({"post_id": "995005758239301632"})
+        assert "Post ID: 995005758239301632" in out
+
+    def test_formats_comment_id(self):
+        out = format_community_create_result({"comment_id": "123456"})
+        assert "Comment ID: 123456" in out
+
+    def test_handles_unexpected_shape(self):
+        # Non-dict / empty still produces a safe message rather than crashing.
+        assert format_community_create_result(None) == "Operation completed."
+
+
+# ---------------------------------------------------------------------------
+# Hot stocks
+# ---------------------------------------------------------------------------
+
+class TestFormatHotStocks:
+    def test_formats_ranking(self):
+        data = {"data": [
+            {"rank": 1, "symbol": "NVDA", "category": "US_STOCK"},
+            {"rank": 2, "symbol": "AAPL", "category": "US_STOCK"},
+        ]}
+        out = format_community_hot_stocks(data)
+        assert "Community Hot Stocks" in out
+        assert "#1  NVDA  (US_STOCK)" in out
+        assert "#2  AAPL  (US_STOCK)" in out
+
+    def test_accepts_bare_list(self):
+        out = format_community_hot_stocks([{"rank": 1, "symbol": "TSLA", "category": "US_STOCK"}])
+        assert "TSLA" in out
+
+
+# ---------------------------------------------------------------------------
+# Post list (by symbol / my posts)
+# ---------------------------------------------------------------------------
+
+class TestFormatPostList:
+    def test_formats_posts_and_pagination(self):
+        data = {
+            "data": [
+                {"post_id": "1", "text": "hello", "publish_time": "2026-10-20",
+                 "thumbs": 3, "comments": 1},
+            ],
+            "pagination_key": "cursor-abc",
+        }
+        out = format_community_post_list(data, title="Posts by Symbol")
+        assert "Community Posts by Symbol" in out
+        assert "Post ID: 1" in out
+        assert "pagination_key=cursor-abc" in out
+
+    def test_no_pagination_hint_when_absent(self):
+        data = {"data": [{"post_id": "1", "text": "hi", "publish_time": "t",
+                          "thumbs": 0, "comments": 0}]}
+        out = format_community_post_list(data, title="My Posts")
+        assert "pagination_key" not in out
+
+
+# ---------------------------------------------------------------------------
+# Post detail
+# ---------------------------------------------------------------------------
+
+class TestFormatPostDetail:
+    def test_formats_detail_with_tickers(self):
+        data = {
+            "post_id": "995",
+            "text": "great earnings",
+            "publish_time": "2026-10-20",
+            "thumbs": 10,
+            "comments": 4,
+            "tickers": [{"symbol": "NVDA", "category": "US_STOCK"}],
+        }
+        out = format_community_post_detail(data)
+        assert "Community Post Detail" in out
+        assert "Post ID: 995" in out
+        assert "NVDA (US_STOCK)" in out
+
+    def test_formats_detail_without_tickers(self):
+        data = {"post_id": "1", "text": "x", "publish_time": "t",
+                "thumbs": 0, "comments": 0}
+        out = format_community_post_detail(data)
+        assert "Post ID: 1" in out
+        assert "Tickers:" not in out

{webull_openapi_mcp-1.2.4 → webull_openapi_mcp-1.2.6}/tests/test_fundamental_screener_registration.py

@@ -1,4 +1,4 @@
-"""Tool registration & SDK-wiring tests for the 24 new fundamental/financial/screener tools."""
+"""Tool registration & SDK-wiring tests for the 35 new fundamental/financial/news/screener tools."""
 
 from __future__ import annotations
 
@@ -13,6 +13,7 @@ from webull_openapi_mcp.tools.market_data.fundamental import (
     register_extended_fundamental_tools,
 )
 from webull_openapi_mcp.tools.market_data.financial import register_financial_tools
+from webull_openapi_mcp.tools.market_data.news import register_news_tools
 from webull_openapi_mcp.tools.market_data.screener import (
     register_screener_tools,
     register_extended_screener_tools,
@@ -31,7 +32,10 @@ def _build_mcp() -> tuple[FastMCP, MagicMock]:
     audit = MagicMock()
     config = _config()
     register_fundamental_tools(mcp, sdk, audit, config)
+    # register_extended_* also registers the US-only insight tools because
+    # config.region_id is "us".
     register_extended_fundamental_tools(mcp, sdk, audit, config)
+    register_news_tools(mcp, sdk, audit, config)
     register_financial_tools(mcp, sdk, audit, config)
     register_screener_tools(mcp, sdk, audit, config)
     register_extended_screener_tools(mcp, sdk, audit, config)
@@ -199,15 +203,158 @@ 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]
     assert not missing, f"{region} missing legacy: {missing}"
+
+
+def test_market_sentiment_invokes_sdk_with_us_category():
+    mcp, sdk = _build_mcp()
+    sdk.data.screener.get_fear_and_greed_index.return_value = {
+        "time_zone": "America/New_York",
+        "current": {"date": "2026-10-08", "fear_greed_index": 43, "grade": "Neutral"},
+    }
+    text = _call(mcp, "get_market_sentiment", {})
+    sdk.data.screener.get_fear_and_greed_index.assert_called_once_with(category="US_STOCK")
+    assert "Market Sentiment Index" in text
+    assert "43" in text
+
+
+def test_unusual_activities_invokes_screener_with_filters():
+    mcp, sdk = _build_mcp()
+    sdk.data.screener.get_stock_unusual_activities.return_value = {
+        "data": [{"symbol": "NVDA", "alert_type": "VOLUME_SURGE"}]
+    }
+    text = _call(mcp, "get_stock_unusual_activities",
+                 {"symbol": "NVDA", "count": 5, "extended_hours_required": True})
+    _, kwargs = sdk.data.screener.get_stock_unusual_activities.call_args
+    assert kwargs["symbol"] == "NVDA"
+    assert kwargs["category"] == "US_STOCK"
+    assert kwargs["count"] == 5
+    assert kwargs["extended_hours_required"] is True
+    assert "Stock Unusual Activities" in text
+
+
+def test_search_institutions_invokes_sdk():
+    mcp, sdk = _build_mcp()
+    sdk.data.fundamentals.get_institution_search.return_value = {
+        "data": [{"cik": "0001067983", "name": "Berkshire Hathaway"}]
+    }
+    text = _call(mcp, "get_institution_identifier", {"keyword": "Berkshire", "pagination_key": "k"})
+    sdk.data.fundamentals.get_institution_search.assert_called_once_with(
+        "Berkshire", "k"
+    )
+    assert "Institution Search" in text
+    assert "Berkshire Hathaway" in text
+
+
+def test_institution_holdings_invokes_sdk():
+    mcp, sdk = _build_mcp()
+    sdk.data.fundamentals.get_institution_holdings.return_value = {
+        "data": [{"stock": "AAPL", "quantity": "49665910"}],
+    }
+    text = _call(mcp, "get_institution_holdings", {"cik": "1067983"})
+    sdk.data.fundamentals.get_institution_holdings.assert_called_once_with("1067983", None)
+    assert "Institution 13F Holdings" in text
+    assert "AAPL" in text
+
+
+def test_institution_holding_changes_invokes_sdk():
+    mcp, sdk = _build_mcp()
+    sdk.data.fundamentals.get_institution_holding_changes.return_value = {
+        "data": [{"target_symbol": "AAPL"}],
+    }
+    text = _call(mcp, "get_institution_holding_changes", {"cik": "1067983", "position": "open"})
+    sdk.data.fundamentals.get_institution_holding_changes.assert_called_once_with(
+        "1067983", "OPEN", pagination_key=None
+    )
+    assert "Institution Holding Changes" in text
+
+
+def test_insider_transactions_invokes_sdk():
+    mcp, sdk = _build_mcp()
+    sdk.data.fundamentals.get_insider_transactions.return_value = {
+        "data": [{"side": "BUY", "insider_name": "Gawel Scott"}],
+    }
+    text = _call(mcp, "get_insider_transactions", {"symbol": "NVDA", "side": "sell"})
+    _, kwargs = sdk.data.fundamentals.get_insider_transactions.call_args
+    assert kwargs["side"] == "SELL"
+    assert kwargs["category"] == "US_STOCK"
+    assert "Insider Transactions" in text
+
+
+def test_insider_holdings_overview_invokes_sdk():
+    mcp, sdk = _build_mcp()
+    sdk.data.fundamentals.get_insider_holdings.return_value = {
+        "symbol": "NVDA", "insiders_count": 20, "ownership_pct": "3.9665",
+        "changes": [{"period": "1M", "shares": "1000"}],
+    }
+    text = _call(mcp, "get_insider_holdings", {"symbol": "NVDA", "compare_months": 3})
+    _, kwargs = sdk.data.fundamentals.get_insider_holdings.call_args
+    assert kwargs["category"] == "US_STOCK"
+    assert kwargs["compare_months"] == 3
+    assert "Insider Holdings Overview" in text
+    # The 'changes' list must not be silently dropped (see format fix).
+    assert "changes" in text
+
+
+def test_economic_calendar_invokes_sdk_with_us_region():
+    mcp, sdk = _build_mcp()
+    sdk.data.fundamentals.get_economic_calendars.return_value = {
+        "data": [{"event_name": "Unemployment Claimant", "publish_date": "2026-10-16"}],
+    }
+    text = _call(mcp, "get_macroeconomic_calendar", {"start_date": "2026-10-09"})
+    _, kwargs = sdk.data.fundamentals.get_economic_calendars.call_args
+    assert kwargs["region"] == "US"
+    assert kwargs["start_date"] == "2026-10-09"
+    assert "US Economic Calendar" in text
+
+
+def test_search_news_invokes_sdk():
+    mcp, sdk = _build_mcp()
+    sdk.data.news.get_news_search.return_value = {
+        "keyword": "Starlink",
+        "pagination_key": "1791348877000",
+        "data": [{"news_id": "15716519902127104", "title": "Musk calls spectrum deal"}],
+    }
+    text = _call(mcp, "search_news", {"keyword": "Starlink"})
+    sdk.data.news.get_news_search.assert_called_once_with("Starlink", None, None, None)
+    assert "News Keyword Search" in text
+    assert "Musk calls spectrum deal" in text
+
+
+def test_news_detail_invokes_sdk():
+    mcp, sdk = _build_mcp()
+    sdk.data.news.get_news_detail.return_value = {
+        "news_id": "15716519902127104",
+        "title": "Musk calls spectrum deal",
+        "content": "<p>full article body</p>",
+    }
+    text = _call(mcp, "get_news_detail", {"news_id": "15716519902127104"})
+    sdk.data.news.get_news_detail.assert_called_once_with("15716519902127104")
+    assert "News Detail" in text
+    assert "full article body" in text
+
+
+def test_stock_news_invokes_sdk_with_us_category():
+    mcp, sdk = _build_mcp()
+    sdk.data.news.get_stock_news.return_value = {
+        "symbol": "TSLA",
+        "pagination_key": "1791348877000",
+        "data": [{"news_id": "15716519902127104", "title": "some title"}],
+    }
+    text = _call(mcp, "get_stock_news", {"symbol": "TSLA", "sentiment": "positive"})
+    args, kwargs = sdk.data.news.get_stock_news.call_args
+    assert args == ("TSLA",)
+    assert kwargs["category"] == "US_STOCK"
+    assert kwargs["sentiment"] == "POSITIVE"
+    assert "Stock News List" in text

{webull_openapi_mcp-1.2.4 → webull_openapi_mcp-1.2.6}/tests/test_fundamental_tools.py

@@ -9,6 +9,7 @@ from webull_openapi_mcp.formatters import (
     format_capital_flow,
     format_cash_flow,
     format_dividend_calendar,
+    format_economic_calendar,
     format_earnings_calendar,
     format_financial_alert,
     format_financial_indicators,
@@ -24,6 +25,11 @@ from webull_openapi_mcp.formatters import (
     format_fund_splits,
     format_income_statement,
     format_industry_comparison,
+    format_institution_holding_changes,
+    format_institution_holdings,
+    format_institution_search,
+    format_insider_holdings_overview,
+    format_insider_transactions,
     format_sec_filings,
 )
 
@@ -56,6 +62,12 @@ _NO_DATA = "No data available."
     format_income_statement,
     format_balance_sheet,
     format_cash_flow,
+    format_institution_search,
+    format_institution_holdings,
+    format_institution_holding_changes,
+    format_insider_transactions,
+    format_insider_holdings_overview,
+    format_economic_calendar,
 ])
 def test_returns_no_data_for_none(fn):
     assert fn(None) == _NO_DATA
@@ -532,3 +544,76 @@ class TestFormatCashFlow:
         assert "800" in result
         assert "Capital Expenditure" in result
         assert "-250" in result
+
+
+class TestFormatInstitutionSearch:
+    def test_formats_list_with_pagination(self):
+        data = {
+            "keyword": "berkshire",
+            "pagination_key": "Ne8Ld4XUwpFFRMWyI2Z1",
+            "data": [
+                {"cik": "0001067983", "name": "Berkshire Hathaway Inc",
+                 "notable_people": "Warren Buffett"},
+            ],
+        }
+        result = format_institution_search(data)
+        assert "=== Institution Search ===" in result
+        assert "[1]" in result
+        assert "Berkshire Hathaway Inc" in result
+        assert "Warren Buffett" in result
+        assert "Next pagination_key: Ne8Ld4XUwpFFRMWyI2Z1" in result
+
+
+class TestFormatInstitutionHoldings:
+    def test_formats_list_with_pagination(self):
+        data = {"data": [{"stock": "AAPL", "quantity": "49665910"}]}
+        result = format_institution_holdings(data)
+        assert "=== Institution 13F Holdings ===" in result
+        assert "AAPL" in result
+
+
+class TestFormatInstitutionHoldingChanges:
+    def test_formats_list_with_pagination(self):
+        data = {
+            "next_pagination_key": "b25664000b8a04fb4fee",
+            "data": [{"stock": "AAPL", "position": "OPEN"}],
+        }
+        result = format_institution_holding_changes(data)
+        assert "=== Institution Holding Changes ===" in result
+        assert "Next pagination_key: b25664000b8a04fb4fee" in result
+
+
+class TestFormatInsiderTransactions:
+    def test_formats_list_with_pagination(self):
+        data = {
+            "data": [
+                {"side": "BUY", "shares": "13866", "price": "0",
+                 "insider_name": "Gawel Scott", "transaction_date": "2026-06-08"},
+            ],
+        }
+        result = format_insider_transactions(data)
+        assert "=== Insider Transactions ===" in result
+        assert "Gawel Scott" in result
+        assert "2026-06-08" in result
+
+
+class TestFormatInsiderHoldingsOverview:
+    def test_formats_overview(self):
+        data = {"symbol": "NVDA", "insiders_count": 20, "ownership_pct": "3.9665"}
+        result = format_insider_holdings_overview(data)
+        assert "=== Insider Holdings Overview ===" in result
+        assert "3.9665" in result
+
+
+class TestFormatEconomicCalendar:
+    def test_formats_list_with_pagination(self):
+        data = {
+            "pkey": "iPxeAijSJUKDUMAAAiAAAA",
+            "data": [
+                {"event_name": "Net L-T Flows,Incl.Swaps", "publish_date": "2026-10-16",
+                 "is_fed_related": False},
+            ],
+        }
+        result = format_economic_calendar(data)
+        assert "=== US Economic Calendar ===" in result
+        assert "2026-10-16" in result