@ton/mcp 0.1.15-alpha.3 → 0.1.15-alpha.7

package/README.md

@@ -321,7 +321,7 @@ Import an existing agentic wallet into the local TON config registry, recovering
 - `name` (optional): Wallet display name
 
 #### `agentic_start_root_wallet_setup` (registry mode only)
-Start first-root-agent setup: generate operator keys, persist a pending draft, and return a dashboard URL for the user to create the wallet from their main wallet.
+Start first-root-agent setup: generate operator keys, persist a pending draft, and return a dashboard URL for the user to create the wallet from their main wallet. Agents with local shell/browser access should open the dashboard URL for the user. Callback-based completion is for long-lived stdio/HTTP server sessions; raw CLI should use manual completion.
 
 **Parameters:**
 - `network` (optional): Network for the new root wallet

package/dist/cli.d.ts

@@ -5,5 +5,33 @@
  * LICENSE file in the root directory of this source tree.
  *
  */
-export {};
+/**
+ * TON MCP CLI - Command-line MCP server for TON wallet management
+ *
+ * This CLI runs a Model Context Protocol server that provides
+ * TON wallet management tools for use with Claude Desktop or other MCP clients.
+ *
+ * Usage:
+ *   npx @ton/mcp@alpha                          # stdio mode (default)
+ *   npx @ton/mcp@alpha --http                   # HTTP server on 0.0.0.0:3000
+ *   npx @ton/mcp@alpha --http 8080              # HTTP server on custom port
+ *   npx @ton/mcp@alpha --http --host 127.0.0.1  # HTTP server on custom host
+ *   npx @ton/mcp@alpha get_balance              # raw CLI: call tool and exit
+ *   npx @ton/mcp@alpha get_transactions --limit 5
+ *   npx @ton/mcp@alpha get_jetton_balance --jettonAddress EQAbc...
+ *
+ * Environment variables:
+ *   NETWORK         - Network to use (mainnet or testnet, default: mainnet)
+ *   MNEMONIC        - 24-word mnemonic phrase for wallet
+ *   PRIVATE_KEY     - Hex-encoded private key (alternative to MNEMONIC)
+ *   WALLET_VERSION  - Wallet version (v5r1, v4r2, or agentic; default: v5r1)
+ *   AGENTIC_WALLET_ADDRESS - Agentic wallet address (required for WALLET_VERSION=agentic unless derived from init params)
+ *   AGENTIC_WALLET_NFT_INDEX - walletNftIndex / subwallet id for agentic wallet (uint256, optional)
+ *   AGENTIC_COLLECTION_ADDRESS - collection address for agentic wallet state init derivation (optional)
+ *   TONCENTER_API_KEY - API key for Toncenter (optional, for higher rate limits)
+ *   AGENTIC_CALLBACK_BASE_URL - optional public callback base URL for agentic onboarding
+ *   AGENTIC_CALLBACK_HOST - host for local callback server in stdio mode (default: 127.0.0.1)
+ *   AGENTIC_CALLBACK_PORT - port for local callback server in stdio mode (default: random free port)
+ */
+import './suppress-punycode-deprecation.js';
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,oCAAoC,CAAC"}