@ton/mcp 0.1.12 → 0.1.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -98,10 +98,18 @@ Get recent transaction history for the wallet (TON transfers, Jetton transfers,
98
98
  **Parameters:**
99
99
  - `limit` (optional): Maximum number of transactions to return (default: 20, max: 100)
100
100
 
101
+ #### `get_transaction_status`
102
+ Get the status of a transaction by its normalized hash to know if it is pending, completed, or failed. In TON, a transaction is considered "complete" only when the entire trace finishes processing.
103
+
104
+ **Default flow:** After sending a transaction, poll this until status is completed or failed. User can specify whether to check status.
105
+
106
+ **Parameters:**
107
+ - `normalizedHash` (required): Normalized hash of the external-in transaction (Hex string). Note: This must be the *normalized* hash of the message sent to the network.
108
+
101
109
  ### Transfers
102
110
 
103
111
  #### `send_ton`
104
- Send TON to an address. Amount is in human-readable format (e.g., `"1.5"` means 1.5 TON).
112
+ Send TON to an address. Amount is in human-readable format (e.g., `"1.5"` means 1.5 TON). Returns `normalizedHash`. Default flow: poll `get_transaction_status` until completed or failed; user can skip.
105
113
 
106
114
  **Parameters:**
107
115
  - `toAddress` (required): Recipient TON address
@@ -109,7 +117,7 @@ Send TON to an address. Amount is in human-readable format (e.g., `"1.5"` means
109
117
  - `comment` (optional): Transaction comment/memo
110
118
 
111
119
  #### `send_jetton`
112
- Send Jettons to an address. Amount is in human-readable format.
120
+ Send Jettons to an address. Amount is in human-readable format. Returns `normalizedHash`. Default flow: poll `get_transaction_status` until completed or failed; user can skip.
113
121
 
114
122
  **Parameters:**
115
123
  - `toAddress` (required): Recipient TON address
@@ -118,7 +126,7 @@ Send Jettons to an address. Amount is in human-readable format.
118
126
  - `comment` (optional): Transaction comment/memo
119
127
 
120
128
  #### `send_raw_transaction`
121
- Send a raw transaction with full control over messages. Supports multiple messages in a single transaction.
129
+ Send a raw transaction with full control over messages. Supports multiple messages. Returns `normalizedHash`. Default flow: poll `get_transaction_status` until completed or failed; user can skip.
122
130
 
123
131
  **Parameters:**
124
132
  - `messages` (required): Array of messages, each with:
@@ -156,7 +164,7 @@ Get detailed information about a specific NFT by its address.
156
164
  - `nftAddress` (required): NFT item contract address
157
165
 
158
166
  #### `send_nft`
159
- Transfer an NFT from the wallet to another address.
167
+ Transfer an NFT from the wallet to another address. Returns `normalizedHash`. Default flow: poll `get_transaction_status` until completed or failed; user can skip.
160
168
 
161
169
  **Parameters:**
162
170
  - `nftAddress` (required): NFT item contract address to transfer