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

package/README.md

@@ -20,6 +20,8 @@ A Model Context Protocol (MCP) server for TON blockchain wallet operations. Buil
 - **Agentic Wallets mode**: Server starts from local config registry at `~/.config/ton/config.json` or `TON_CONFIG_PATH`
 - **Single-wallet mode**: if `MNEMONIC` or `PRIVATE_KEY` is set, the server starts with one in-memory wallet
 
+Choose one control path per task: either run `@ton/mcp` as an MCP server (stdio or HTTP) or call tools through raw CLI. Agents must not mix MCP server mode and raw CLI against the same workflow/session, because that creates competing control paths over the same wallet/config state.
+
 ### Agentic Wallets mode
 
 Self-custody wallets for autonomous agents. Your AI agent gets TON wallet capabilities — transfers, swaps, NFTs. User keeps the master key, agent keeps the operator key.
@@ -106,6 +108,10 @@ npx @ton/mcp@alpha --http 3000
 
 HTTP mode keeps a separate MCP session/transport per client session id, so multiple clients can initialize and reconnect independently.
 
+## Usage Examples
+
+Examples of user requests, approximate corresponding raw CLI commands via `npx @ton/mcp@alpha`, and expected agent responses are collected in [USAGE_EXAMPLES.md](./USAGE_EXAMPLES.md).
+
 ## Environment Variables
 
 | Variable | Default | Description |

package/USAGE_EXAMPLES.md

@@ -0,0 +1,342 @@
+# Usage Examples
+
+These examples show how `@ton/mcp` can be used in raw CLI mode. They are illustrative rather than literal agent logs: each example includes a representative user request, the `npx @ton/mcp@alpha` commands an agent would typically run, and the kind of response it would usually return.
+
+## Agentic Wallets
+
+### Create an agentic wallet
+
+**User request**
+
+`Create an agentic wallet`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha agentic_start_root_wallet_setup --name "My Agent" --network mainnet
+open <DASHBOARD_URL>
+npx @ton/mcp@alpha agentic_complete_root_wallet_setup --setupId <SETUP_ID> --walletAddress <WALLET_ADDRESS>
+npx @ton/mcp@alpha get_current_wallet
+```
+
+**Approximate agent response**
+
+> A new agentic wallet setup was started, and the dashboard link was opened. After the dashboard step was completed, wallet `EQ...` was added and set as the active wallet.
+
+### Import an existing agentic wallet
+
+**User request**
+
+`Import my existing agentic wallet EQ...`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha agentic_validate_wallet --address EQ...
+npx @ton/mcp@alpha agentic_import_wallet --address EQ... --name "Imported wallet"
+npx @ton/mcp@alpha agentic_rotate_operator_key --walletSelector "Imported wallet"
+open <DASHBOARD_URL>
+npx @ton/mcp@alpha list_wallets
+```
+
+**Approximate agent response**
+
+> Wallet `EQ...` was validated and imported into the local registry under the name `Imported wallet`. The dashboard link for the `Public Key` update was opened. Until that on-chain confirmation is completed, the wallet is available in read-only mode.
+
+### Rotate the operator key
+
+**User request**
+
+`Rotate the operator key for the active agentic wallet`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha agentic_rotate_operator_key
+open <DASHBOARD_URL>
+npx @ton/mcp@alpha agentic_get_pending_operator_key_rotation --rotationId <ROTATION_ID>
+npx @ton/mcp@alpha agentic_complete_rotate_operator_key --rotationId <ROTATION_ID>
+```
+
+**Approximate agent response**
+
+> The dashboard link for the `Public Key` update was opened. After the main wallet confirms the change, write access is restored.
+
+### List agentic wallets by owner
+
+**User request**
+
+`Which agentic wallets belong to owner address EQ...?`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha agentic_list_wallets_by_owner --ownerAddress EQ...
+```
+
+**Approximate agent response**
+
+> Several agentic wallets were found for owner address `EQ...`. For each wallet, the agent typically shows the wallet address and basic metadata.
+
+## Wallet Registry and Balances
+
+### List wallets in the registry
+
+**User request**
+
+`Which wallets do I have?`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha list_wallets
+npx @ton/mcp@alpha get_current_wallet
+```
+
+**Approximate agent response**
+
+> Several wallets were found. The active wallet is `EQ...`. The others can be selected by `id`, name, or address via `set_active_wallet`.
+
+### Switch the active wallet
+
+**User request**
+
+`Make wallet "treasury" active`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha set_active_wallet --walletSelector treasury
+npx @ton/mcp@alpha get_current_wallet
+```
+
+**Approximate agent response**
+
+> The active wallet was switched to `treasury`. Current address: `UQ...`. Network: `mainnet`.
+
+### Show the active wallet balance
+
+**User request**
+
+`Show my balance in TON and jettons`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha get_balance
+npx @ton/mcp@alpha get_jettons
+```
+
+**Approximate agent response**
+
+> Active wallet balance: `12.84 TON`. Jetton balances include `USDT 53.2`, `NOT 1400`, and `STON 18.05`.
+
+### Show the balance of any address
+
+**User request**
+
+`Show the balance of address EQ...`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha get_balance_by_address --address EQ...
+npx @ton/mcp@alpha get_jettons_by_address --address EQ...
+```
+
+**Approximate agent response**
+
+> Address `EQ...` has a balance of `3.21 TON`. No jettons were found for that address.
+
+### Find a known jetton address
+
+**User request**
+
+`Show the address of USDT`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha get_known_jettons
+```
+
+**Approximate agent response**
+
+> `USDT` was found in the list of known jettons with master contract address `EQ...`. That address can be used with `send_jetton` or `get_swap_quote`.
+
+## Transfers and Swaps
+
+### Send TON to a TON DNS name
+
+**User request**
+
+`Send 1 TON to foundation.ton`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha resolve_dns --domain foundation.ton
+npx @ton/mcp@alpha send_ton --toAddress EQ... --amount 1
+npx @ton/mcp@alpha get_transaction_status --normalizedHash <NORMALIZED_HASH>
+```
+
+**Approximate agent response**
+
+> `foundation.ton` was resolved to TON address `EQ...`. The `1 TON` transfer was sent with `normalizedHash: <NORMALIZED_HASH>`. Transaction status: `completed`.
+
+### Send a jetton
+
+**User request**
+
+`Send 25 USDT to UQAbc...`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha get_jettons
+npx @ton/mcp@alpha send_jetton --jettonAddress EQ... --toAddress UQAbc... --amount 25
+npx @ton/mcp@alpha get_transaction_status --normalizedHash <NORMALIZED_HASH>
+```
+
+**Approximate agent response**
+
+> `USDT` was found in the wallet, and the `25 USDT` transfer to `UQAbc...` was sent. `normalizedHash: <NORMALIZED_HASH>`. Current status: `completed`.
+
+### Swap TON for a jetton
+
+**User request**
+
+`Swap 2 TON to USDT`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha get_known_jettons
+# quote
+npx @ton/mcp@alpha get_swap_quote --fromToken TON --toToken EQ... --amount 2 --slippageBps 100
+# pass messages from quote if user approved
+npx @ton/mcp@alpha send_raw_transaction --messages '<quote.transaction.messages>'
+# If the quote includes transaction.validUntil, add --validUntil to the send_raw_transaction invocation above
+npx @ton/mcp@alpha get_transaction_status --normalizedHash <NORMALIZED_HASH>
+```
+
+**Approximate agent response**
+
+> A quote was received for swapping `2 TON` to `USDT`. After confirmation, the swap was executed with an expected output of about `X USDT` after slippage. `normalizedHash: <NORMALIZED_HASH>`.
+
+### Show recent transactions
+
+**User request**
+
+`Show my last 5 transactions`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha get_transactions --limit 5
+```
+
+**Approximate agent response**
+
+> The last 5 operations were shown, including incoming and outgoing TON transfers, jetton transfers, and swaps. For each transaction, the agent typically shows the time, action type, amount, and final status.
+
+## TON DNS
+
+### Resolve a TON DNS name
+
+**User request**
+
+`What does foundation.ton resolve to?`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha resolve_dns --domain foundation.ton
+```
+
+**Approximate agent response**
+
+> Domain `foundation.ton` resolves to address `EQ...`.
+
+### Reverse-resolve an address
+
+**User request**
+
+`Does address EQ... have a TON DNS name?`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha back_resolve_dns --address EQ...
+```
+
+**Approximate agent response**
+
+> If reverse resolution succeeds, address `EQ...` maps to a DNS name such as `foundation.ton`. Otherwise, the agent reports that no DNS name was found.
+
+## NFTs
+
+### List NFTs in the active wallet
+
+**User request**
+
+`Show my NFTs`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha get_nfts --limit 20
+```
+
+**Approximate agent response**
+
+> A list of NFTs from the active wallet was shown, including addresses, collection names, preview metadata, and key attributes.
+
+### Show NFT details
+
+**User request**
+
+`Show details for NFT EQ...`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha get_nft --nftAddress EQ...
+```
+
+**Approximate agent response**
+
+> For NFT `EQ...`, the agent shows metadata, collection information, owner, content URI, and attributes.
+
+### Send an NFT
+
+**User request**
+
+`Send NFT EQ... to UQReceiver...`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha send_nft --nftAddress EQ... --toAddress UQReceiver...
+npx @ton/mcp@alpha get_transaction_status --normalizedHash <NORMALIZED_HASH>
+```
+
+**Approximate agent response**
+
+> NFT `EQ...` was sent to `UQReceiver...`. `normalizedHash: <NORMALIZED_HASH>`. Transaction status: `completed`.
+
+### Show NFTs owned by any address
+
+**User request**
+
+`Show NFTs owned by address EQ...`
+
+**Approximate command list**
+
+```bash
+npx @ton/mcp@alpha get_nfts_by_address --address EQ... --limit 10
+```
+
+**Approximate agent response**
+
+> NFTs owned by address `EQ...` were shown, even though that address is not one of the saved wallets.

package/dist/cli.js

@@ -89480,16 +89480,29 @@ var TonWalletKit = class {
 		this.eventRouter.removeErrorCallback();
 	}
 	/**
+	* Allow to convert url to ConnectionRequestEvent to use inline way
+	*/
+	async connectionEventFromUrl(url) {
+		await this.ensureInitialized();
+		try {
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
+			return await new ConnectHandler(() => {}, this.config, this.analyticsManager).handle(bridgeEvent);
+		} catch (error) {
+			log$5.error("Failed to create connection event from URL", {
+				error,
+				url
+			});
+			throw error;
+		}
+	}
+	/**
 	* Handle pasted TON Connect URL/link
 	* Parses the URL and creates a connect request event
 	*/
 	async handleTonConnectUrl(url) {
 		await this.ensureInitialized();
 		try {
-			const parsedUrl = this.parseTonConnectUrl(url);
-			if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
-			const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
-			if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
 			await this.eventRouter.routeEvent(bridgeEvent);
 		} catch (error) {
 			log$5.error("Failed to handle TON Connect URL", {
@@ -89517,6 +89530,16 @@ var TonWalletKit = class {
 		await this.eventRouter.routeEvent(bridgeEvent);
 	}
 	/**
+	* Parse and validate TON Connect URL into a RawBridgeEventConnect
+	*/
+	parseBridgeConnectEventFromUrl(url) {
+		const parsedUrl = this.parseTonConnectUrl(url);
+		if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
+		const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
+		if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+		return bridgeEvent;
+	}
+	/**
 	* Parse TON Connect URL to extract connection parameters
 	*/
 	parseTonConnectUrl(url) {
@@ -106480,26 +106503,15 @@ const tokenToAddress = (token) => {
 	if (token.address === "ton") return "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c";
 	return import_dist$3.Address.parse(token.address).toRawString();
 };
-const addressToToken = (address, decimals = 9) => {
-	if (address === "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c") return {
-		address: "ton",
-		decimals: 9
-	};
+const toOmnistonAddress = (address, network) => {
+	let formattedAddress;
 	try {
-		return {
-			address: import_dist$3.Address.parseRaw(address).toString(),
-			decimals
-		};
+		formattedAddress = import_dist$3.Address.parse(address).toString({ bounceable: true });
 	} catch {
-		return {
-			address,
-			decimals
-		};
+		formattedAddress = address;
 	}
-};
-const toOmnistonAddress = (address, network) => {
 	return {
-		address,
+		address: formattedAddress,
 		blockchain: mapNetworkToBlockchainId(network)
 	};
 };
@@ -106595,7 +106607,7 @@ var OmnistonSwapProvider = class extends SwapProvider {
 			const flexibleReferrerFee = params.providerOptions?.flexibleReferrerFee ?? this.flexibleReferrerFee;
 			const quoteRequest = {
 				amount: params.isReverseSwap ? { askUnits: parseUnits(params.amount, params.to.decimals).toString() } : { bidUnits: parseUnits(params.amount, params.from.decimals).toString() },
-				settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP],
+				settlementMethods: params.providerOptions?.settlementMethods ?? [SettlementMethod.SETTLEMENT_METHOD_SWAP],
 				bidAssetAddress: toOmnistonAddress(bidAssetAddress, params.network),
 				askAssetAddress: toOmnistonAddress(askAssetAddress, params.network),
 				referrerAddress: referrerAddress ? toOmnistonAddress(import_dist$3.Address.parse(referrerAddress).toString({ bounceable: true }), params.network) : void 0,
@@ -106711,14 +106723,6 @@ var OmnistonSwapProvider = class extends SwapProvider {
 	mapOmnistonQuoteToSwapQuote(quote, params) {
 		const metadata = { omnistonQuote: quote };
 		const fee = [];
-		if (quote.protocolFeeAsset) fee.push({
-			amount: quote.protocolFeeUnits,
-			token: addressToToken(quote.protocolFeeAsset.address)
-		});
-		if (quote.referrerFeeAsset) fee.push({
-			amount: quote.referrerFeeUnits,
-			token: addressToToken(quote.referrerFeeAsset.address)
-		});
 		return {
 			rawFromAmount: quote.bidUnits,
 			rawToAmount: quote.askUnits,
@@ -132493,7 +132497,8 @@ var McpWalletService = class McpWalletService {
 			},
 			amount,
 			network,
-			slippageBps
+			slippageBps,
+			providerOptions: { settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP, SettlementMethod.SETTLEMENT_METHOD_ESCROW] }
 		};
 		const quote = await kit.swap.getQuote(params);
 		const swapParams = {

package/dist/index.cjs

@@ -89849,16 +89849,29 @@ var TonWalletKit = class {
 		this.eventRouter.removeErrorCallback();
 	}
 	/**
+	* Allow to convert url to ConnectionRequestEvent to use inline way
+	*/
+	async connectionEventFromUrl(url) {
+		await this.ensureInitialized();
+		try {
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
+			return await new ConnectHandler(() => {}, this.config, this.analyticsManager).handle(bridgeEvent);
+		} catch (error) {
+			log$4.error("Failed to create connection event from URL", {
+				error,
+				url
+			});
+			throw error;
+		}
+	}
+	/**
 	* Handle pasted TON Connect URL/link
 	* Parses the URL and creates a connect request event
 	*/
 	async handleTonConnectUrl(url) {
 		await this.ensureInitialized();
 		try {
-			const parsedUrl = this.parseTonConnectUrl(url);
-			if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
-			const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
-			if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
 			await this.eventRouter.routeEvent(bridgeEvent);
 		} catch (error) {
 			log$4.error("Failed to handle TON Connect URL", {
@@ -89886,6 +89899,16 @@ var TonWalletKit = class {
 		await this.eventRouter.routeEvent(bridgeEvent);
 	}
 	/**
+	* Parse and validate TON Connect URL into a RawBridgeEventConnect
+	*/
+	parseBridgeConnectEventFromUrl(url) {
+		const parsedUrl = this.parseTonConnectUrl(url);
+		if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
+		const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
+		if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+		return bridgeEvent;
+	}
+	/**
 	* Parse TON Connect URL to extract connection parameters
 	*/
 	parseTonConnectUrl(url) {
@@ -105675,26 +105698,15 @@ const tokenToAddress = (token) => {
 	if (token.address === "ton") return "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c";
 	return import_dist$3.Address.parse(token.address).toRawString();
 };
-const addressToToken = (address, decimals = 9) => {
-	if (address === "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c") return {
-		address: "ton",
-		decimals: 9
-	};
+const toOmnistonAddress = (address, network) => {
+	let formattedAddress;
 	try {
-		return {
-			address: import_dist$3.Address.parseRaw(address).toString(),
-			decimals
-		};
+		formattedAddress = import_dist$3.Address.parse(address).toString({ bounceable: true });
 	} catch {
-		return {
-			address,
-			decimals
-		};
+		formattedAddress = address;
 	}
-};
-const toOmnistonAddress = (address, network) => {
 	return {
-		address,
+		address: formattedAddress,
 		blockchain: mapNetworkToBlockchainId(network)
 	};
 };
@@ -105790,7 +105802,7 @@ var OmnistonSwapProvider = class extends SwapProvider {
 			const flexibleReferrerFee = params.providerOptions?.flexibleReferrerFee ?? this.flexibleReferrerFee;
 			const quoteRequest = {
 				amount: params.isReverseSwap ? { askUnits: parseUnits(params.amount, params.to.decimals).toString() } : { bidUnits: parseUnits(params.amount, params.from.decimals).toString() },
-				settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP],
+				settlementMethods: params.providerOptions?.settlementMethods ?? [SettlementMethod.SETTLEMENT_METHOD_SWAP],
 				bidAssetAddress: toOmnistonAddress(bidAssetAddress, params.network),
 				askAssetAddress: toOmnistonAddress(askAssetAddress, params.network),
 				referrerAddress: referrerAddress ? toOmnistonAddress(import_dist$3.Address.parse(referrerAddress).toString({ bounceable: true }), params.network) : void 0,
@@ -105906,14 +105918,6 @@ var OmnistonSwapProvider = class extends SwapProvider {
 	mapOmnistonQuoteToSwapQuote(quote, params) {
 		const metadata = { omnistonQuote: quote };
 		const fee = [];
-		if (quote.protocolFeeAsset) fee.push({
-			amount: quote.protocolFeeUnits,
-			token: addressToToken(quote.protocolFeeAsset.address)
-		});
-		if (quote.referrerFeeAsset) fee.push({
-			amount: quote.referrerFeeUnits,
-			token: addressToToken(quote.referrerFeeAsset.address)
-		});
 		return {
 			rawFromAmount: quote.bidUnits,
 			rawToAmount: quote.askUnits,
@@ -131688,7 +131692,8 @@ var McpWalletService = class McpWalletService {
 			},
 			amount,
 			network,
-			slippageBps
+			slippageBps,
+			providerOptions: { settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP, SettlementMethod.SETTLEMENT_METHOD_ESCROW] }
 		};
 		const quote = await kit.swap.getQuote(params);
 		const swapParams = {

package/dist/index.js

@@ -89849,16 +89849,29 @@ var TonWalletKit = class {
 		this.eventRouter.removeErrorCallback();
 	}
 	/**
+	* Allow to convert url to ConnectionRequestEvent to use inline way
+	*/
+	async connectionEventFromUrl(url) {
+		await this.ensureInitialized();
+		try {
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
+			return await new ConnectHandler(() => {}, this.config, this.analyticsManager).handle(bridgeEvent);
+		} catch (error) {
+			log$4.error("Failed to create connection event from URL", {
+				error,
+				url
+			});
+			throw error;
+		}
+	}
+	/**
 	* Handle pasted TON Connect URL/link
 	* Parses the URL and creates a connect request event
 	*/
 	async handleTonConnectUrl(url) {
 		await this.ensureInitialized();
 		try {
-			const parsedUrl = this.parseTonConnectUrl(url);
-			if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
-			const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
-			if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
 			await this.eventRouter.routeEvent(bridgeEvent);
 		} catch (error) {
 			log$4.error("Failed to handle TON Connect URL", {
@@ -89886,6 +89899,16 @@ var TonWalletKit = class {
 		await this.eventRouter.routeEvent(bridgeEvent);
 	}
 	/**
+	* Parse and validate TON Connect URL into a RawBridgeEventConnect
+	*/
+	parseBridgeConnectEventFromUrl(url) {
+		const parsedUrl = this.parseTonConnectUrl(url);
+		if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
+		const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
+		if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+		return bridgeEvent;
+	}
+	/**
 	* Parse TON Connect URL to extract connection parameters
 	*/
 	parseTonConnectUrl(url) {
@@ -105675,26 +105698,15 @@ const tokenToAddress = (token) => {
 	if (token.address === "ton") return "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c";
 	return import_dist$3.Address.parse(token.address).toRawString();
 };
-const addressToToken = (address, decimals = 9) => {
-	if (address === "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c") return {
-		address: "ton",
-		decimals: 9
-	};
+const toOmnistonAddress = (address, network) => {
+	let formattedAddress;
 	try {
-		return {
-			address: import_dist$3.Address.parseRaw(address).toString(),
-			decimals
-		};
+		formattedAddress = import_dist$3.Address.parse(address).toString({ bounceable: true });
 	} catch {
-		return {
-			address,
-			decimals
-		};
+		formattedAddress = address;
 	}
-};
-const toOmnistonAddress = (address, network) => {
 	return {
-		address,
+		address: formattedAddress,
 		blockchain: mapNetworkToBlockchainId(network)
 	};
 };
@@ -105790,7 +105802,7 @@ var OmnistonSwapProvider = class extends SwapProvider {
 			const flexibleReferrerFee = params.providerOptions?.flexibleReferrerFee ?? this.flexibleReferrerFee;
 			const quoteRequest = {
 				amount: params.isReverseSwap ? { askUnits: parseUnits(params.amount, params.to.decimals).toString() } : { bidUnits: parseUnits(params.amount, params.from.decimals).toString() },
-				settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP],
+				settlementMethods: params.providerOptions?.settlementMethods ?? [SettlementMethod.SETTLEMENT_METHOD_SWAP],
 				bidAssetAddress: toOmnistonAddress(bidAssetAddress, params.network),
 				askAssetAddress: toOmnistonAddress(askAssetAddress, params.network),
 				referrerAddress: referrerAddress ? toOmnistonAddress(import_dist$3.Address.parse(referrerAddress).toString({ bounceable: true }), params.network) : void 0,
@@ -105906,14 +105918,6 @@ var OmnistonSwapProvider = class extends SwapProvider {
 	mapOmnistonQuoteToSwapQuote(quote, params) {
 		const metadata = { omnistonQuote: quote };
 		const fee = [];
-		if (quote.protocolFeeAsset) fee.push({
-			amount: quote.protocolFeeUnits,
-			token: addressToToken(quote.protocolFeeAsset.address)
-		});
-		if (quote.referrerFeeAsset) fee.push({
-			amount: quote.referrerFeeUnits,
-			token: addressToToken(quote.referrerFeeAsset.address)
-		});
 		return {
 			rawFromAmount: quote.bidUnits,
 			rawToAmount: quote.askUnits,
@@ -131688,7 +131692,8 @@ var McpWalletService = class McpWalletService {
 			},
 			amount,
 			network,
-			slippageBps
+			slippageBps,
+			providerOptions: { settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP, SettlementMethod.SETTLEMENT_METHOD_ESCROW] }
 		};
 		const quote = await kit.swap.getQuote(params);
 		const swapParams = {

package/dist/serverless.cjs

@@ -77904,16 +77904,29 @@ var TonWalletKit = class {
 		this.eventRouter.removeErrorCallback();
 	}
 	/**
+	* Allow to convert url to ConnectionRequestEvent to use inline way
+	*/
+	async connectionEventFromUrl(url) {
+		await this.ensureInitialized();
+		try {
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
+			return await new ConnectHandler(() => {}, this.config, this.analyticsManager).handle(bridgeEvent);
+		} catch (error) {
+			log$4.error("Failed to create connection event from URL", {
+				error,
+				url
+			});
+			throw error;
+		}
+	}
+	/**
 	* Handle pasted TON Connect URL/link
 	* Parses the URL and creates a connect request event
 	*/
 	async handleTonConnectUrl(url) {
 		await this.ensureInitialized();
 		try {
-			const parsedUrl = this.parseTonConnectUrl(url);
-			if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
-			const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
-			if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
 			await this.eventRouter.routeEvent(bridgeEvent);
 		} catch (error) {
 			log$4.error("Failed to handle TON Connect URL", {
@@ -77941,6 +77954,16 @@ var TonWalletKit = class {
 		await this.eventRouter.routeEvent(bridgeEvent);
 	}
 	/**
+	* Parse and validate TON Connect URL into a RawBridgeEventConnect
+	*/
+	parseBridgeConnectEventFromUrl(url) {
+		const parsedUrl = this.parseTonConnectUrl(url);
+		if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
+		const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
+		if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+		return bridgeEvent;
+	}
+	/**
 	* Parse TON Connect URL to extract connection parameters
 	*/
 	parseTonConnectUrl(url) {
@@ -106744,26 +106767,15 @@ const tokenToAddress = (token) => {
 	if (token.address === "ton") return "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c";
 	return import_dist$4.Address.parse(token.address).toRawString();
 };
-const addressToToken = (address, decimals = 9) => {
-	if (address === "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c") return {
-		address: "ton",
-		decimals: 9
-	};
+const toOmnistonAddress = (address, network) => {
+	let formattedAddress;
 	try {
-		return {
-			address: import_dist$4.Address.parseRaw(address).toString(),
-			decimals
-		};
+		formattedAddress = import_dist$4.Address.parse(address).toString({ bounceable: true });
 	} catch {
-		return {
-			address,
-			decimals
-		};
+		formattedAddress = address;
 	}
-};
-const toOmnistonAddress = (address, network) => {
 	return {
-		address,
+		address: formattedAddress,
 		blockchain: mapNetworkToBlockchainId(network)
 	};
 };
@@ -106859,7 +106871,7 @@ var OmnistonSwapProvider = class extends SwapProvider {
 			const flexibleReferrerFee = params.providerOptions?.flexibleReferrerFee ?? this.flexibleReferrerFee;
 			const quoteRequest = {
 				amount: params.isReverseSwap ? { askUnits: parseUnits(params.amount, params.to.decimals).toString() } : { bidUnits: parseUnits(params.amount, params.from.decimals).toString() },
-				settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP],
+				settlementMethods: params.providerOptions?.settlementMethods ?? [SettlementMethod.SETTLEMENT_METHOD_SWAP],
 				bidAssetAddress: toOmnistonAddress(bidAssetAddress, params.network),
 				askAssetAddress: toOmnistonAddress(askAssetAddress, params.network),
 				referrerAddress: referrerAddress ? toOmnistonAddress(import_dist$4.Address.parse(referrerAddress).toString({ bounceable: true }), params.network) : void 0,
@@ -106975,14 +106987,6 @@ var OmnistonSwapProvider = class extends SwapProvider {
 	mapOmnistonQuoteToSwapQuote(quote, params) {
 		const metadata = { omnistonQuote: quote };
 		const fee = [];
-		if (quote.protocolFeeAsset) fee.push({
-			amount: quote.protocolFeeUnits,
-			token: addressToToken(quote.protocolFeeAsset.address)
-		});
-		if (quote.referrerFeeAsset) fee.push({
-			amount: quote.referrerFeeUnits,
-			token: addressToToken(quote.referrerFeeAsset.address)
-		});
 		return {
 			rawFromAmount: quote.bidUnits,
 			rawToAmount: quote.askUnits,
@@ -132757,7 +132761,8 @@ var McpWalletService = class McpWalletService {
 			},
 			amount,
 			network,
-			slippageBps
+			slippageBps,
+			providerOptions: { settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP, SettlementMethod.SETTLEMENT_METHOD_ESCROW] }
 		};
 		const quote = await kit.swap.getQuote(params);
 		const swapParams = {

package/dist/serverless.js

@@ -77904,16 +77904,29 @@ var TonWalletKit = class {
 		this.eventRouter.removeErrorCallback();
 	}
 	/**
+	* Allow to convert url to ConnectionRequestEvent to use inline way
+	*/
+	async connectionEventFromUrl(url) {
+		await this.ensureInitialized();
+		try {
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
+			return await new ConnectHandler(() => {}, this.config, this.analyticsManager).handle(bridgeEvent);
+		} catch (error) {
+			log$4.error("Failed to create connection event from URL", {
+				error,
+				url
+			});
+			throw error;
+		}
+	}
+	/**
 	* Handle pasted TON Connect URL/link
 	* Parses the URL and creates a connect request event
 	*/
 	async handleTonConnectUrl(url) {
 		await this.ensureInitialized();
 		try {
-			const parsedUrl = this.parseTonConnectUrl(url);
-			if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
-			const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
-			if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+			const bridgeEvent = this.parseBridgeConnectEventFromUrl(url);
 			await this.eventRouter.routeEvent(bridgeEvent);
 		} catch (error) {
 			log$4.error("Failed to handle TON Connect URL", {
@@ -77941,6 +77954,16 @@ var TonWalletKit = class {
 		await this.eventRouter.routeEvent(bridgeEvent);
 	}
 	/**
+	* Parse and validate TON Connect URL into a RawBridgeEventConnect
+	*/
+	parseBridgeConnectEventFromUrl(url) {
+		const parsedUrl = this.parseTonConnectUrl(url);
+		if (!parsedUrl) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL format", void 0, { url });
+		const bridgeEvent = this.createConnectEventFromUrl(parsedUrl);
+		if (!bridgeEvent) throw new WalletKitError(ERROR_CODES.VALIDATION_ERROR, "Invalid TON Connect URL - unable to create bridge event", void 0, { parsedUrl });
+		return bridgeEvent;
+	}
+	/**
 	* Parse TON Connect URL to extract connection parameters
 	*/
 	parseTonConnectUrl(url) {
@@ -106744,26 +106767,15 @@ const tokenToAddress = (token) => {
 	if (token.address === "ton") return "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c";
 	return import_dist$4.Address.parse(token.address).toRawString();
 };
-const addressToToken = (address, decimals = 9) => {
-	if (address === "EQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAM9c") return {
-		address: "ton",
-		decimals: 9
-	};
+const toOmnistonAddress = (address, network) => {
+	let formattedAddress;
 	try {
-		return {
-			address: import_dist$4.Address.parseRaw(address).toString(),
-			decimals
-		};
+		formattedAddress = import_dist$4.Address.parse(address).toString({ bounceable: true });
 	} catch {
-		return {
-			address,
-			decimals
-		};
+		formattedAddress = address;
 	}
-};
-const toOmnistonAddress = (address, network) => {
 	return {
-		address,
+		address: formattedAddress,
 		blockchain: mapNetworkToBlockchainId(network)
 	};
 };
@@ -106859,7 +106871,7 @@ var OmnistonSwapProvider = class extends SwapProvider {
 			const flexibleReferrerFee = params.providerOptions?.flexibleReferrerFee ?? this.flexibleReferrerFee;
 			const quoteRequest = {
 				amount: params.isReverseSwap ? { askUnits: parseUnits(params.amount, params.to.decimals).toString() } : { bidUnits: parseUnits(params.amount, params.from.decimals).toString() },
-				settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP],
+				settlementMethods: params.providerOptions?.settlementMethods ?? [SettlementMethod.SETTLEMENT_METHOD_SWAP],
 				bidAssetAddress: toOmnistonAddress(bidAssetAddress, params.network),
 				askAssetAddress: toOmnistonAddress(askAssetAddress, params.network),
 				referrerAddress: referrerAddress ? toOmnistonAddress(import_dist$4.Address.parse(referrerAddress).toString({ bounceable: true }), params.network) : void 0,
@@ -106975,14 +106987,6 @@ var OmnistonSwapProvider = class extends SwapProvider {
 	mapOmnistonQuoteToSwapQuote(quote, params) {
 		const metadata = { omnistonQuote: quote };
 		const fee = [];
-		if (quote.protocolFeeAsset) fee.push({
-			amount: quote.protocolFeeUnits,
-			token: addressToToken(quote.protocolFeeAsset.address)
-		});
-		if (quote.referrerFeeAsset) fee.push({
-			amount: quote.referrerFeeUnits,
-			token: addressToToken(quote.referrerFeeAsset.address)
-		});
 		return {
 			rawFromAmount: quote.bidUnits,
 			rawToAmount: quote.askUnits,
@@ -132757,7 +132761,8 @@ var McpWalletService = class McpWalletService {
 			},
 			amount,
 			network,
-			slippageBps
+			slippageBps,
+			providerOptions: { settlementMethods: [SettlementMethod.SETTLEMENT_METHOD_SWAP, SettlementMethod.SETTLEMENT_METHOD_ESCROW] }
 		};
 		const quote = await kit.swap.getQuote(params);
 		const swapParams = {

package/dist/services/McpWalletService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"McpWalletService.d.ts","sourceRoot":"","sources":["../../src/services/McpWalletService.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"McpWalletService.d.ts","sourceRoot":"","sources":["../../src/services/McpWalletService.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,OAAO,KAAK,EAIR,aAAa,EAEb,yBAAyB,EAC5B,MAAM,gBAAgB,CAAC;AAMxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAUtD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,CAAC,EAAE,KAAK,CAAC;QACf,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EACE,aAAa,GACb,gBAAgB,GAChB,YAAY,GACZ,iBAAiB,GACjB,gBAAgB,GAChB,mBAAmB,GACnB,SAAS,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAE9B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,4BAA6B,SAAQ,cAAc;IAChE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,WAAW,EAAE;QACT,QAAQ,EAAE,KAAK,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC;YACf,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC,CAAC;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACL;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC1B,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,aAAa,CAAC;IACtB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,qCAAqC;IACrC,QAAQ,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,aAAa,CAAC;QACxB,OAAO,CAAC,EAAE,aAAa,CAAC;KAC3B,CAAC;CACL;AAYD,UAAU,4BAA4B;IAClC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;CACvD;AASD;;GAEG;AACH,qBAAa,gBAAgB;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,GAAG,CAA6B;IAExC,OAAO;IAKP,OAAO,CAAC,MAAM,CAAC,YAAY;IAoB3B,OAAO,CAAC,MAAM,CAAC,aAAa;IAM5B,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAKjC,OAAO,CAAC,MAAM,CAAC,yBAAyB;IAKxC,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAUnC,OAAO,CAAC,MAAM,CAAC,4BAA4B;IAW3C,OAAO,CAAC,MAAM,CAAC,2BAA2B;IAa1C,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAarC,OAAO,CAAC,MAAM,CAAC,0BAA0B;IAgBzC,OAAO,CAAC,0BAA0B;YAOpB,yBAAyB;WA8C1B,MAAM,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAK9E;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,UAAU,IAAI,WAAW;IASzB;;OAEG;YACW,MAAM;IAwBpB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAInC;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAWzE;;OAEG;IACG,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI9D;;OAEG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAe/G;;OAEG;IACG,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA8ChF;;OAEG;IACG,sBAAsB,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAW1F;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAY/C;;OAEG;IACG,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA0FrE;;OAEG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAuB/F;;OAEG;IACG,UAAU,CACZ,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC;IAwB1B;;OAEG;IACG,kBAAkB,CAAC,OAAO,EAAE;QAC9B,QAAQ,EAAE,KAAK,CAAC;YACZ,OAAO,EAAE,MAAM,CAAC;YAChB,MAAM,EAAE,MAAM,CAAC;YACf,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,OAAO,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC,CAAC;QACH,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,cAAc,CAAC;IAiB3B;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC,4BAA4B,CAAC;IA4GzG;;;;;OAKG;IACG,oBAAoB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAKtF;;;;;;OAMG;IACG,YAAY,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,eAAe,CAAC;IAuD3B;;OAEG;IACG,OAAO,CAAC,KAAK,GAAE,MAAW,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAyB/E;;OAEG;IACG,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,EAAE,MAAM,GAAE,MAAU,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA4BzG;;OAEG;IACG,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA6B/D;;OAEG;IACG,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAuB/F;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAO1D;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAKxD;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAK7D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAM/B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ton/mcp",
-  "version": "0.1.15-alpha.7",
+  "version": "0.1.15-alpha.9",
   "description": "TON MCP Server - Model Context Protocol server for TON blockchain wallet operations",
   "license": "MIT",
   "type": "module",
@@ -38,6 +38,7 @@
     "dist",
     "skills",
     "llms.txt",
+    "USAGE_EXAMPLES.md",
     "README.md"
   ],
   "keywords": [
@@ -59,7 +60,7 @@
     "undici": "^7.16.0",
     "ws": "^8.18.3",
     "zod": "^3.25.76",
-    "@ton/walletkit": "0.0.11-alpha.2"
+    "@ton/walletkit": "0.0.12-alpha.0"
   },
   "peerDependencies": {
     "@modelcontextprotocol/sdk": "^1.25.1"

package/skills/ton-cli/SKILL.md

@@ -18,6 +18,8 @@ Run any TON wallet MCP tool directly from the command line. The binary invokes t
 | `npx @ton/mcp@alpha --http [port]` | HTTP MCP server |
 | `npx @ton/mcp@alpha <tool_name> [--arg value ...]` | **Raw CLI: call one tool and exit** |
 
+Use exactly one mode for a given workflow: either MCP server mode (`stdio`/`--http`) or raw CLI. Do not combine them in the same task/session.
+
 ## Raw CLI Usage
 
 ```bash