@pionex/pionex-trade-mcp 0.2.46 → 0.2.49

package/README.md

@@ -2,7 +2,11 @@
 
 MCP server for Pionex. Reads credentials from **~/.pionex/config.toml** (no env vars needed in client config).
 
-## Install & Setup
+## Claude Desktop — One-Click Install
+
+For Claude Desktop, a `.mcpb` one-click installer is available. Download `pionex-mcp.mcpb` from the [GitHub Releases page](https://github.com/pionex-official/pionex-ai-kit/releases/latest) and double-click to install.
+
+## Install & Setup (npm — Cursor, Windsurf, VS Code, etc.)
 
 1. Create config (if not done yet):  
    `pionex-ai-kit onboard` (from **@pionex/pionex-ai-kit**).
@@ -37,6 +41,7 @@ Credentials are read from `~/.pionex/config.toml` when the server starts; the cl
 
 - **Market** (no auth): `pionex_market_get_depth`, `pionex_market_get_trades`, `pionex_market_get_symbol_info`, `pionex_market_get_tickers`, `pionex_market_get_book_tickers`, `pionex_market_get_klines`
 - **Account** (auth): `pionex_account_get_balance`
+- **Wallet** (auth): `pionex_wallet_get_balance_full`
 - **Orders** (auth): `pionex_orders_new_order`, `pionex_orders_get_order`, `pionex_orders_get_order_by_client_order_id`, `pionex_orders_get_open_orders`, `pionex_orders_get_all_orders`, `pionex_orders_cancel_order`, `pionex_orders_get_fills`, `pionex_orders_get_fills_by_order_id`, `pionex_orders_cancel_all_orders`
 - **Bot / Futures Grid** (auth): `pionex_bot_futures_grid_get_order`, `pionex_bot_futures_grid_create`, `pionex_bot_futures_grid_adjust_params`, `pionex_bot_futures_grid_reduce`, `pionex_bot_futures_grid_cancel`
 - **Bot / Spot Grid** (auth): `pionex_bot_spot_grid_get_order`, `pionex_bot_spot_grid_get_ai_strategy`, `pionex_bot_spot_grid_create`, `pionex_bot_spot_grid_adjust_params`, `pionex_bot_spot_grid_invest_in`, `pionex_bot_spot_grid_cancel`, `pionex_bot_spot_grid_profit`

package/dist/index.js

@@ -720,8 +720,8 @@ var CLIENT_NAMES = {
 };
 var SUPPORTED_CLIENTS = Object.keys(CLIENT_NAMES);
 var PIONEX_API_DEFAULT_BASE_URL = "https://api.pionex.com";
-var MODULES = ["market", "account", "orders", "bot", "earn_dual"];
-var DEFAULT_MODULES = ["market", "account", "orders", "bot", "earn_dual"];
+var MODULES = ["market", "account", "wallet", "orders", "bot", "earn_dual"];
+var DEFAULT_MODULES = ["market", "account", "wallet", "orders", "bot", "earn_dual"];
 var ConfigError = class extends Error {
   suggestion;
   constructor(message, suggestion) {
@@ -1061,6 +1061,27 @@ function registerAccountTools() {
     }
   ];
 }
+function registerWalletTools() {
+  return [
+    {
+      name: "pionex_wallet_get_balance_full",
+      module: "wallet",
+      isWrite: false,
+      description: "Query full account balance overview including spot (Bot Account) and futures (Trader Account), with per-coin price info and total USDT/BTC valuations. Requires authentication.",
+      inputSchema: {
+        type: "object",
+        additionalProperties: false,
+        properties: {
+          appLang: { type: "string", description: "App language, e.g. 'en' or 'zh' (takes priority over sysLang)" },
+          sysLang: { type: "string", description: "System language fallback when appLang is not set" }
+        }
+      },
+      async handler(args, { client }) {
+        return (await client.signedGet("/api/v1/wallet/balancesFull", args)).data;
+      }
+    }
+  ];
+}
 function registerOrdersTools() {
   return [
     {
@@ -2737,7 +2758,7 @@ function registerEarnDualTools() {
   ];
 }
 function allToolSpecs() {
-  return [...registerMarketTools(), ...registerAccountTools(), ...registerOrdersTools(), ...registerBotTools(), ...registerEarnDualTools()];
+  return [...registerMarketTools(), ...registerAccountTools(), ...registerWalletTools(), ...registerOrdersTools(), ...registerBotTools(), ...registerEarnDualTools()];
 }
 function buildTools(config) {
   const enabled = new Set(config.modules);