docs: improve parameter descriptions across all tools

tools/article-scraper/metadata.json

@@ -31,15 +31,15 @@
     "properties": {
       "url": {
         "type": "string",
-        "description": "Article URL to scrape"
+        "description": "Valid URL of the article to extract content from. Must be accessible and contain article content"
       },
       "html": {
         "type": "string",
-        "description": "Optional raw HTML content (if you already have it), will override fetching from 'url'"
+        "description": "Raw HTML content of the article page. If provided, overrides URL fetching. Must be valid HTML"
       },
       "language": {
         "type": "string",
-        "description": "Override default language, e.g. 'en', 'zh'"
+        "description": "Two-letter language code (e.g., 'en', 'zh') for article parsing. Overrides default_language setting"
       }
     },
     "required": ["url"]
@@ -67,4 +67,4 @@
     },
     "required": ["title","authors","publish_date","summary","keywords","top_image","text"]
   }
-} 
+}  

tools/arxiv-download/metadata.json

@@ -30,12 +30,11 @@
     "properties": {
       "paper_id": {
         "type": "string",
-        "description": "ArXiv paper ID to download"
+        "description": "ArXiv paper identifier (e.g., '2101.12345' or 'math/0501001'). Must be a valid arXiv ID"
       },
       "convert_to_md": {
         "type": "boolean",
-        "description": "Whether to convert the downloaded PDF to .md",
-        "default": true
+        "description": "Convert downloaded PDF to markdown format for easier text processing. Default: true"
       }
     },
     "required": ["paper_id"]
@@ -49,4 +48,4 @@
     },
     "required": ["status", "message"]
   }
-} 
+}  

tools/arxiv-search/metadata.json

@@ -25,27 +25,26 @@
     "properties": {
       "query": {
         "type": "string",
-        "description": "Search query string"
+        "description": "Search terms to find papers. Supports AND, OR, ANDNOT operators and field prefixes (e.g., 'ti:', 'au:')"
       },
       "max_results": {
         "type": "number",
-        "description": "Maximum number of results to return",
-        "default": 10
+        "description": "Maximum number of papers to return in the results. Default: 10"
       },
       "date_from": {
         "type": "string",
-        "description": "Earliest publication date in a parseable date string (optional)"
+        "description": "Start date for paper search in YYYY-MM-DD format (e.g., '2024-01-01'). Optional"
       },
       "date_to": {
         "type": "string",
-        "description": "Latest publication date in a parseable date string (optional)"
+        "description": "End date for paper search in YYYY-MM-DD format (e.g., '2024-01-31'). Optional"
       },
       "categories": {
         "type": "array",
-        "description": "List of category filters (e.g. [cs.LG])",
+        "description": "List of arXiv category codes (e.g., ['cs.LG', 'cs.AI']) to filter papers. See arxiv.org/category_taxonomy",
         "items": {
           "type": "string",
-          "description": "Category filter"
+          "description": "Valid arXiv category code (e.g., 'cs.LG', 'math.AG')"
         }
       }
     },
@@ -79,4 +78,4 @@
     },
     "required": ["papers", "total_results"]
   }
-} 
+}  

tools/chess-evaluate/metadata.json

@@ -25,17 +25,15 @@
     "properties": {
       "fen": {
         "type": "string",
-        "description": "FEN describing the position to evaluate"
+        "description": "Chess position in Forsyth-Edwards Notation (e.g., 'rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1')"
       },
       "depth": {
         "type": "number",
-        "description": "Depth for the engine search",
-        "default": 15
+        "description": "Stockfish analysis depth (1-30). Higher values give better evaluation but take longer. Default: 15"
       },
       "time_limit_ms": {
         "type": "number",
-        "description": "Time limit in milliseconds if depth is small",
-        "default": 1000
+        "description": "Maximum analysis time in milliseconds. Used if depth not reached. Default: 1000"
       }
     },
     "required": ["fen"]
@@ -49,4 +47,4 @@
     },
     "required": ["message"]
   }
-}   
+}      

tools/chess-generate-image/metadata.json

@@ -25,15 +25,15 @@
     "properties": {
       "fen": {
         "type": "string",
-        "description": "FEN string representing the chess position"
+        "description": "Chess position in FEN notation (e.g., 'rnbqkbnr/pppppppp/8/8/4P3/8/PPPP1PPP/RNBQKBNR b KQkq e3 0 1')"
       },
       "last_move_uci": {
         "type": "string",
-        "description": "Optional UCI format move to highlight (e.g. 'e2e4')"
+        "description": "Move to highlight in UCI format (e.g., 'e2e4' for pawn to e4). Optional"
       },
       "output_filename": {
         "type": "string",
-        "description": "Optional filename for the output PNG image (default: chess_position.png)",
+        "description": "Custom filename for the output PNG image. Must end in .png. Default: chess_position.png",
         "default": "chess_position.png"
       }
     },
@@ -49,4 +49,4 @@
     },
     "required": ["image_path"]
   }
-}   
+}      

tools/chess-move/metadata.json

@@ -25,11 +25,11 @@
     "properties": {
       "fen": {
         "type": "string",
-        "description": "FEN describing the current position"
+        "description": "Starting position in FEN notation (e.g., 'rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1')"
       },
       "move_uci": {
         "type": "string",
-        "description": "Move in UCI format (e.g. 'e2e4')"
+        "description": "Chess move in UCI format: source square + target square (e.g., 'e2e4', 'g1f3'). For promotion: add piece letter"
       }
     },
     "required": ["fen", "move_uci"]
@@ -46,4 +46,4 @@
     },
     "required": ["new_fen", "is_legal"]
   }
-}   
+}      

tools/coin-flip/metadata.json

@@ -19,15 +19,15 @@
     "properties": {
       "sides": {
         "type": "number",
-        "description": "Number of sides (default: 3)"
+        "description": "Number of sides for the coin/die (2-100). For regular coin use 2. Default: 3"
       },
       "sideNames": {
         "type": "array",
         "items": {
           "type": "string",
-          "description": "Custon name for the side"
+          "description": "Custom label for a single side (e.g., 'heads', 'tails')"
         },
-        "description": "Optional custom names for sides (must match number of sides)"
+        "description": "Custom labels for each side. Array length must equal sides parameter if provided"
       }
     },
     "required": []

tools/coinbase-call-faucet/metadata.json

@@ -16,13 +16,16 @@
       "type": "object",
       "properties": {
         "name": {
-          "type": "string"
+          "type": "string",
+          "description": "Identifier name for the Coinbase account to use for faucet calls"
         },
         "privateKey": {
-          "type": "string"
+          "type": "string",
+          "description": "Private key for the Coinbase account. Must be a valid hex string"
         },
         "walletId": {
           "type": "string",
+          "description": "Optional Coinbase wallet ID to use for faucet calls. If not provided, uses default wallet",
           "nullable": true
         }
       },

tools/coinbase-create-wallet/metadata.json

@@ -17,13 +17,16 @@
       "type": "object",
       "properties": {
         "name": {
-          "type": "string"
+          "type": "string",
+          "description": "Identifier name for the new Coinbase wallet to be created"
         },
         "privateKey": {
-          "type": "string"
+          "type": "string",
+          "description": "Private key for wallet creation. Must be a valid hex string"
         },
         "useServerSigner": {
           "type": "string",
+          "description": "Enable server-side signing for transactions. Default: false",
           "default": "false",
           "nullable": true
         }

tools/coinbase-get-balance/metadata.json

@@ -17,21 +17,21 @@
       "properties": {
         "name": {
           "type": "string",
-          "description": "The name of the Coinbase wallet"
+          "description": "Identifier name for the Coinbase wallet to check balance for"
         },
         "privateKey": {
           "type": "string",
-          "description": "The private key of the Coinbase wallet"
+          "description": "Private key for wallet authentication. Must be a valid hex string"
         },
         "walletId": {
           "type": "string",
           "nullable": true,
-          "description": "Optional wallet ID for specific wallet selection"
+          "description": "Specific wallet ID to check balance for. If not provided, uses default wallet"
         },
         "useServerSigner": {
           "type": "string",
           "nullable": true,
-          "description": "Optional server signer configuration"
+          "description": "Enable server-side signing for transactions. Set to 'true' or 'false'"
         }
       },
       "required": [
@@ -45,7 +45,7 @@
         "walletId": {
           "type": "string",
           "nullable": true,
-          "description": "Optional wallet ID to get balance for a specific wallet"
+          "description": "Override wallet ID from configuration. If provided, takes precedence over config walletId"
         }
       },
       "required": []

tools/coinbase-get-my-address/metadata.json

@@ -17,21 +17,21 @@
       "properties": {
         "name": {
           "type": "string",
-          "description": "The name of the Coinbase wallet"
+          "description": "Identifier name for the Coinbase wallet to retrieve address from"
         },
         "privateKey": {
           "type": "string",
-          "description": "The private key of the Coinbase wallet"
+          "description": "Private key for wallet authentication. Must be a valid hex string"
         },
         "walletId": {
           "type": "string",
           "nullable": true,
-          "description": "Optional wallet ID for specific wallet selection"
+          "description": "Specific wallet ID to get address for. If not provided, uses default wallet"
         },
         "useServerSigner": {
           "type": "string",
           "nullable": true,
-          "description": "Optional server signer configuration"
+          "description": "Enable server-side signing for transactions. Set to 'true' or 'false'"
         }
       },
       "required": [
@@ -44,7 +44,7 @@
       "properties": {
         "walletId": {
           "type": "string",
-          "description": "The ID of the Coinbase wallet to get the address from",
+          "description": "Override wallet ID from configuration. If provided, takes precedence over config walletId",
           "nullable": true
         }
       },

tools/coinbase-get-transactions/metadata.json

@@ -16,13 +16,16 @@
       "type": "object",
       "properties": {
         "name": {
-          "type": "string"
+          "type": "string",
+          "description": "Identifier name for the Coinbase wallet to fetch transactions from"
         },
         "privateKey": {
-          "type": "string"
+          "type": "string",
+          "description": "Private key for wallet authentication. Must be a valid hex string"
         },
         "walletId": {
-          "type": "string"
+          "type": "string",
+          "description": "Specific wallet ID to get transactions for. Required for transaction history access"
         }
       },
       "required": [
@@ -40,13 +43,16 @@
       "type": "object",
       "properties": {
         "tableCsv": {
-          "type": "string"
+          "type": "string",
+          "description": "Transaction history in CSV format with headers. Each row represents one transaction"
         },
         "rowsCount": {
-          "type": "number"
+          "type": "number",
+          "description": "Total number of transactions (rows) in the CSV data, excluding header row"
         },
         "columnsCount": {
-          "type": "number"
+          "type": "number",
+          "description": "Number of columns in the CSV data representing different transaction attributes"
         }
       },
       "required": [

tools/coinbase-send-tx/metadata.json

@@ -17,27 +17,27 @@
       "properties": {
         "name": {
           "type": "string",
-          "description": "The name of the Coinbase wallet"
+          "description": "Identifier name for the Coinbase wallet to send transaction from"
         },
         "privateKey": {
           "type": "string",
-          "description": "The private key of the Coinbase wallet"
+          "description": "Private key for wallet authentication. Must be a valid hex string"
         },
         "walletId": {
           "type": "string",
           "nullable": true,
-          "description": "Optional wallet ID for specific wallet selection"
+          "description": "Specific wallet ID to send from. If not provided, uses default wallet"
         },
         "seed": {
           "type": "string",
           "nullable": true,
-          "description": "Optional seed phrase for wallet recovery"
+          "description": "BIP39 seed phrase for wallet recovery. Optional, 12 or 24 words"
         },
         "useServerSigner": {
           "type": "string",
           "default": "false",
           "nullable": true,
-          "description": "Optional flag to use server-side signing"
+          "description": "Enable server-side signing for transactions. Set to 'true' or 'false'"
         }
       },
       "required": [
@@ -50,15 +50,15 @@
       "properties": {
         "recipient_address": {
           "type": "string",
-          "description": "The destination address for the transaction"
+          "description": "Valid Ethereum address to send tokens to. Must be a 42-character hex string starting with 0x"
         },
         "assetId": {
           "type": "string",
-          "description": "The ID of the asset/token to send"
+          "description": "Token identifier (e.g., 'ETH' for Ethereum, contract address for other tokens)"
         },
         "amount": {
           "type": "string",
-          "description": "The amount of tokens to send"
+          "description": "Amount of tokens to send in decimal format. Must be a valid number string"
         }
       },
       "required": [