binance-futures-mcp 1.0.6__py3-none-any.whl → 1.0.8__py3-none-any.whl

{binance_futures_mcp-1.0.6.dist-info → binance_futures_mcp-1.0.8.dist-info}/METADATA

@@ -1,12 +1,14 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: binance-futures-mcp
-Version: 1.0.6
-Summary: A Model Context Protocol server for Binance Futures API
+Version: 1.0.8
+Summary: A Model Context Protocol server for Binance Futures API with comprehensive trading tools
 Home-page: https://github.com/alexcandrabersiva/bin-mcp
 Author: Binance MCP Server
-Project-URL: Bug Tracker, https://github.com/alexcandrabersiva/bin-mcp/issues
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/alexcandrabersiva/bin-mcp
 Project-URL: Repository, https://github.com/alexcandrabersiva/bin-mcp.git
-Keywords: mcp binance trading futures api model-context-protocol
+Project-URL: Issues, https://github.com/alexcandrabersiva/bin-mcp/issues
+Keywords: mcp,binance,trading,futures,api,model-context-protocol
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -20,9 +22,18 @@ Classifier: Topic :: Office/Business :: Financial :: Investment
 Requires-Python: >=3.8
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: mcp (>=1.0.0)
-Requires-Dist: aiohttp (>=3.8.0)
-Requires-Dist: pydantic (>=2.0.0)
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: aiohttp>=3.8.0
+Requires-Dist: pydantic>=2.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
 
 # Binance MCP Server
 
@@ -32,12 +43,12 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
 
 1. **Install the package:**
    ```bash
-   pip install binance-futures-mcp
+   pip install binance_futures_mcp
    ```
 
 2. **Run the server:**
    ```bash
-   uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
+   uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
    ```
 
 3. **Or configure in VS Code** by adding to your `settings.json`:
@@ -47,7 +58,7 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
        "servers": {
          "binance": {
            "command": "uvx",
-           "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
+           "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_key", "--binance-secret-key", "your_secret"]
          }
        }
      }
@@ -88,7 +99,7 @@ A Model Context Protocol (MCP) server that provides comprehensive access to Bina
 ## Installation
 
 ```bash
-pip install binance-futures-mcp
+pip install binance_futures_mcp
 ```
 
 ### Development Installation
@@ -115,7 +126,7 @@ Add to your VS Code `settings.json`:
     "servers": {
       "binance": {
         "command": "uvx",
-        "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
+        "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
       }
     }
   }
@@ -131,7 +142,7 @@ Add to your Cursor configuration file (`.cursor/mcp.json`):
   "servers": {
     "binance": {
       "command": "uvx", 
-      "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
+      "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
     }
   }
 }
@@ -146,7 +157,7 @@ Add to your Windsurf configuration (`.windsurf/mcp.json`):
   "mcpServers": {
     "binance": {
       "command": "uvx",
-      "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
+      "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
     }
   }
 }
@@ -164,7 +175,7 @@ Add to your Claude Desktop configuration file:
   "mcpServers": {
     "binance": {
       "command": "uvx",
-      "args": ["--from", "binance-futures-mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
+      "args": ["--from", "binance_futures_mcp", "binance-mcp-server.exe", "--binance-api-key", "your_api_key", "--binance-secret-key", "your_secret_key"]
     }
   }
 }
@@ -177,9 +188,9 @@ Add to your Claude Desktop configuration file:
 2. **Set API credentials**: Replace `your_api_key` and `your_secret_key` with your actual Binance API credentials.
 
 2. **Alternative commands**: You can also use:
-   - `uvx binance-futures-mcp` (direct package execution)
-   - `uvx --from binance-futures-mcp binance-mcp-server.exe` (explicit executable)
-   - `pip install binance-futures-mcp && python -m binance_mcp`
+   - `uvx binance_futures_mcp` (direct package execution)
+   - `uvx --from binance_futures_mcp binance-mcp-server.exe` (explicit executable)
+   - `pip install binance_futures_mcp && python -m binance_mcp`
 
 4. **Python environment**: Using `uvx` automatically handles the Python environment.
 
@@ -213,15 +224,15 @@ export BINANCE_SECRET_KEY="your_secret_key_here"
 python -m binance_mcp
 
 # Or using uvx (no installation needed)
-uvx binance-futures-mcp
+uvx binance_futures_mcp
 
 # With API credentials as arguments
-uvx binance-futures-mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
+uvx binance_futures_mcp --binance-api-key "your_key" --binance-secret-key "your_secret"
 ```
 
 ### Available Tools
 
-The server provides 37 tools organized into categories:
+The server provides 35 tools organized into categories:
 
 #### Account Information (5 tools)
 - `get_account_info` - Get futures account information
@@ -254,7 +265,7 @@ The server provides 37 tools organized into categories:
 - `change_position_mode` - Change position mode
 - `modify_position_margin` - Modify position margin
 
-#### Market Data (8 tools)
+#### Market Data (10 tools)
 - `get_exchange_info` - Get trading rules and symbol info
 - `get_book_ticker` - Get best bid/ask prices
 - `get_price_ticker` - Get latest prices
@@ -264,11 +275,11 @@ The server provides 37 tools organized into categories:
 - `get_klines` - Get candlestick data
 - `get_mark_price` - Get mark price and funding rate
 - `get_aggregate_trades` - Get aggregate trade data
+- `get_funding_rate_history` - Get funding rate history
 
-#### Trading History (3 tools)
+#### Trading History (2 tools)
 - `get_account_trades` - Get account trade history
 - `get_income_history` - Get income history
-- `get_funding_rate_history` - Get funding rate history
 
 ## Example Usage
 

binance_futures_mcp-1.0.8.dist-info/RECORD

@@ -0,0 +1,9 @@
+binance_futures_mcp-1.0.8.dist-info/licenses/LICENSE,sha256=zqfwopvOi7kOx5YVOnehgmRFR-IU3x1n9JEShr3QOYg,1075
+binance_mcp/__init__.py,sha256=ExUxc1kp3GoSwmEtC7eGgFMZlvSQ4IdW1T5xhw-NT98,106
+binance_mcp/__main__.py,sha256=_9DBrtv0PAvjLjCqKk_cMfGtkqSUOcmU6HeQKFjuFMQ,214
+binance_mcp/server.py,sha256=RNLNWe_lF24HKti32MBPFo3rsACBWZ6yF02C3owtDB4,48057
+binance_futures_mcp-1.0.8.dist-info/METADATA,sha256=32MQTpog3BDvt0acBdZpD6dJyURTEGG54nYqVHa9qNA,11845
+binance_futures_mcp-1.0.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+binance_futures_mcp-1.0.8.dist-info/entry_points.txt,sha256=-1iVs9AF7JQBS-xMichP9hQhbCY7YfLFRJVaNKwuN34,69
+binance_futures_mcp-1.0.8.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
+binance_futures_mcp-1.0.8.dist-info/RECORD,,

{binance_futures_mcp-1.0.6.dist-info → binance_futures_mcp-1.0.8.dist-info}/WHEEL

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

binance_mcp/server.py

@@ -1,9 +1,11 @@
 #!/usr/bin/env python3
 
 import asyncio
+import argparse
 import hashlib
 import hmac
 import json
+import os
 import time
 from datetime import datetime
 from typing import Any, Dict, List, Optional, Union
@@ -48,7 +50,7 @@ class BinanceClient:
             timeout=timeout,
             connector=connector,
             headers={
-                'User-Agent': 'binance-mcp-server/1.0.6',
+                'User-Agent': 'binance-mcp-server/1.0.8',
                 'Content-Type': 'application/x-www-form-urlencoded'
             }
         )
@@ -96,15 +98,21 @@ class BinanceClient:
         try:
             if method == "GET":
                 async with self.session.get(url, params=params, headers=headers, ssl=False) as response:
-                    response.raise_for_status()
+                    if response.status != 200:
+                        error_text = await response.text()
+                        raise Exception(f"HTTP {response.status}: {error_text}")
                     return await response.json()
             elif method == "POST":
                 async with self.session.post(url, data=params, headers=headers, ssl=False) as response:
-                    response.raise_for_status()
+                    if response.status != 200:
+                        error_text = await response.text()
+                        raise Exception(f"HTTP {response.status}: {error_text}")
                     return await response.json()
             elif method == "DELETE":
                 async with self.session.delete(url, data=params, headers=headers, ssl=False) as response:
-                    response.raise_for_status()
+                    if response.status != 200:
+                        error_text = await response.text()
+                        raise Exception(f"HTTP {response.status}: {error_text}")
                     return await response.json()
             else:
                 raise ValueError(f"Unsupported HTTP method: {method}")
@@ -244,26 +252,26 @@ class BinanceMCPServer:
                         "properties": {
                             "symbol": {"type": "string", "description": "Trading pair symbol"},
                             "side": {"type": "string", "description": "Order side ('BUY' or 'SELL')"},
-                            "order_type": {"type": "string", "description": "Order type ('MARKET', 'LIMIT', 'STOP', 'STOP_MARKET', 'TRAILING_STOP_MARKET', etc)"},
+                            "type": {"type": "string", "description": "Order type ('MARKET', 'LIMIT', 'STOP', 'STOP_MARKET', 'TRAILING_STOP_MARKET', etc)"},
                             "quantity": {"type": "number", "description": "Order quantity"},
                             "price": {"type": "number", "description": "Order price (for LIMIT orders)"},
-                            "stop_price": {"type": "number", "description": "Stop price (for STOP orders)"},
-                            "time_in_force": {"type": "string", "description": "Time in force (GTC, IOC, FOK)"},
-                            "position_side": {"type": "string", "description": "Position side ('BOTH', 'LONG', 'SHORT')"},
-                            "reduce_only": {"type": "string", "description": "Reduce only flag"},
-                            "new_client_order_id": {"type": "string", "description": "Custom order ID"},
-                            "close_position": {"type": "string", "description": "Close position flag"},
-                            "activation_price": {"type": "number", "description": "Activation price (for TRAILING_STOP_MARKET)"},
-                            "callback_rate": {"type": "number", "description": "Callback rate (for TRAILING_STOP_MARKET)"},
-                            "working_type": {"type": "string", "description": "Working type (MARK_PRICE, CONTRACT_PRICE)"},
-                            "price_protect": {"type": "string", "description": "Price protection flag"},
-                            "new_order_resp_type": {"type": "string", "description": "Response type"},
-                            "recv_window": {"type": "integer", "description": "Receive window"},
+                            "stopPrice": {"type": "number", "description": "Stop price (for STOP orders)"},
+                            "timeInForce": {"type": "string", "description": "Time in force (GTC, IOC, FOK)"},
+                            "positionSide": {"type": "string", "description": "Position side ('BOTH', 'LONG', 'SHORT')"},
+                            "reduceOnly": {"type": "string", "description": "Reduce only flag ('true' or 'false')"},
+                            "newClientOrderId": {"type": "string", "description": "Custom order ID"},
+                            "closePosition": {"type": "string", "description": "Close position flag ('true' or 'false')"},
+                            "activationPrice": {"type": "number", "description": "Activation price (for TRAILING_STOP_MARKET)"},
+                            "callbackRate": {"type": "number", "description": "Callback rate (for TRAILING_STOP_MARKET)"},
+                            "workingType": {"type": "string", "description": "Working type (MARK_PRICE, CONTRACT_PRICE)"},
+                            "priceProtect": {"type": "string", "description": "Price protection flag ('TRUE' or 'FALSE')"},
+                            "newOrderRespType": {"type": "string", "description": "Response type ('ACK', 'RESULT')"},
+                            "recvWindow": {"type": "integer", "description": "Receive window"},
                             "timestamp": {"type": "integer", "description": "Timestamp"},
                             "quantity_precision": {"type": "integer", "description": "Quantity precision for validation"},
                             "price_precision": {"type": "integer", "description": "Price precision for validation"}
                         },
-                        "required": ["symbol", "side", "order_type"]
+                        "required": ["symbol", "side", "type"]
                     }
                 ),
                 Tool(
@@ -386,6 +394,20 @@ class BinanceMCPServer:
                         "required": ["symbol", "order_id"]
                     }
                 ),
+                Tool(
+                    name="close_position",
+                    description="Close current position for a symbol (market order to close all or part of position)",
+                    inputSchema={
+                        "type": "object",
+                        "properties": {
+                            "symbol": {"type": "string", "description": "Trading pair symbol"},
+                            "position_side": {"type": "string", "description": "Position side to close ('BOTH', 'LONG', 'SHORT'). Default 'BOTH' for One-way mode"},
+                            "quantity": {"type": "number", "description": "Quantity to close (optional, if not provided will close entire position)"},
+                            "close_all": {"type": "boolean", "description": "If true, closes entire position using closePosition=true parameter"}
+                        },
+                        "required": ["symbol"]
+                    }
+                ),
 
                 # Trading Configuration Tools
                 Tool(
@@ -656,10 +678,31 @@ class BinanceMCPServer:
                     
                     # Order Management Tools
                     elif name == "place_order":
+                        # Filter out precision parameters and pass through all other parameters directly
                         params = {k: v for k, v in arguments.items() if v is not None and k not in ["quantity_precision", "price_precision"]}
-                        # Convert order_type to type for API
-                        if "order_type" in params:
-                            params["type"] = params.pop("order_type")
+                        
+                        # Validate mandatory parameters based on order type
+                        order_type = params.get("type")
+                        if order_type == "LIMIT":
+                            required_params = ["timeInForce", "quantity", "price"]
+                            missing = [p for p in required_params if p not in params]
+                            if missing:
+                                raise ValueError(f"LIMIT order missing required parameters: {missing}")
+                        elif order_type == "MARKET":
+                            if "quantity" not in params:
+                                raise ValueError("MARKET order missing required parameter: quantity")
+                        elif order_type in ["STOP", "TAKE_PROFIT"]:
+                            required_params = ["quantity", "price", "stopPrice"]
+                            missing = [p for p in required_params if p not in params]
+                            if missing:
+                                raise ValueError(f"{order_type} order missing required parameters: {missing}")
+                        elif order_type in ["STOP_MARKET", "TAKE_PROFIT_MARKET"]:
+                            if "stopPrice" not in params:
+                                raise ValueError(f"{order_type} order missing required parameter: stopPrice")
+                        elif order_type == "TRAILING_STOP_MARKET":
+                            if "callbackRate" not in params:
+                                raise ValueError("TRAILING_STOP_MARKET order missing required parameter: callbackRate")
+                        
                         result = await client._make_request("POST", "/fapi/v1/order", params, "TRADE")
                     elif name == "place_multiple_orders":
                         # This requires special handling for batch orders
@@ -697,6 +740,63 @@ class BinanceMCPServer:
                     elif name == "query_order":
                         params = {"symbol": arguments["symbol"], "orderId": arguments["order_id"]}
                         result = await client._make_request("GET", "/fapi/v1/order", params, "USER_DATA")
+                    elif name == "close_position":
+                        # Handle position closing
+                        symbol = arguments["symbol"]
+                        position_side = arguments.get("position_side", "BOTH")
+                        quantity = arguments.get("quantity")
+                        close_all = arguments.get("close_all", False)
+                        
+                        # First, get current position to determine the side and quantity to close
+                        position_params = {"symbol": symbol}
+                        positions = await client._make_request("GET", "/fapi/v2/positionRisk", position_params, "USER_DATA")
+                        
+                        # Find the position to close
+                        position_to_close = None
+                        for pos in positions:
+                            if pos["symbol"] == symbol and float(pos["positionAmt"]) != 0:
+                                if position_side == "BOTH" or pos["positionSide"] == position_side:
+                                    position_to_close = pos
+                                    break
+                        
+                        if not position_to_close:
+                            raise ValueError(f"No open position found for {symbol} with position side {position_side}")
+                        
+                        position_amt = float(position_to_close["positionAmt"])
+                        current_position_side = position_to_close["positionSide"]
+                        
+                        # Determine order side (opposite of position)
+                        if position_amt > 0:  # Long position
+                            order_side = "SELL"
+                        else:  # Short position
+                            order_side = "BUY"
+                            position_amt = abs(position_amt)  # Make positive for order quantity
+                        
+                        # Determine quantity to close
+                        if close_all:
+                            # Use closePosition parameter to close entire position
+                            order_params = {
+                                "symbol": symbol,
+                                "side": order_side,
+                                "type": "MARKET",
+                                "closePosition": "true"
+                            }
+                            if current_position_side != "BOTH":
+                                order_params["positionSide"] = current_position_side
+                        else:
+                            # Close specific quantity or entire position
+                            close_quantity = quantity if quantity else position_amt
+                            order_params = {
+                                "symbol": symbol,
+                                "side": order_side,
+                                "type": "MARKET",
+                                "quantity": close_quantity,
+                                "reduceOnly": "true"
+                            }
+                            if current_position_side != "BOTH":
+                                order_params["positionSide"] = current_position_side
+                        
+                        result = await client._make_request("POST", "/fapi/v1/order", order_params, "TRADE")
                     
                     # Trading Configuration Tools
                     elif name == "change_leverage":
@@ -816,7 +916,7 @@ async def main():
             write_stream, 
             InitializationOptions(
                 server_name="binance-futures-mcp-server",
-                server_version="1.0.6",
+                server_version="1.0.8",
                 capabilities={
                     "tools": {}
                 }

binance_futures_mcp-1.0.6.dist-info/RECORD

@@ -1,9 +0,0 @@
-binance_mcp/__init__.py,sha256=ExUxc1kp3GoSwmEtC7eGgFMZlvSQ4IdW1T5xhw-NT98,106
-binance_mcp/__main__.py,sha256=_9DBrtv0PAvjLjCqKk_cMfGtkqSUOcmU6HeQKFjuFMQ,214
-binance_mcp/server.py,sha256=phF-od_mUEusWHdWJhaXimxKF8SlS6NltlQNglRsy7U,41669
-binance_futures_mcp-1.0.6.dist-info/LICENSE,sha256=zqfwopvOi7kOx5YVOnehgmRFR-IU3x1n9JEShr3QOYg,1075
-binance_futures_mcp-1.0.6.dist-info/METADATA,sha256=yQiqDxpSDb3ln5Tlbj4Zu-fV6w1dHxK151HZIvdlOyU,11417
-binance_futures_mcp-1.0.6.dist-info/WHEEL,sha256=pkctZYzUS4AYVn6dJ-7367OJZivF2e8RA9b_ZBjif18,92
-binance_futures_mcp-1.0.6.dist-info/entry_points.txt,sha256=-1iVs9AF7JQBS-xMichP9hQhbCY7YfLFRJVaNKwuN34,69
-binance_futures_mcp-1.0.6.dist-info/top_level.txt,sha256=RqGhe1caZUvBF_ezvTiLZD8kVS25eiWVkfJfmoND9m8,12
-binance_futures_mcp-1.0.6.dist-info/RECORD,,