@tongateway/mcp 0.20.0 → 0.21.0

package/dist/index.js

@@ -321,7 +321,7 @@ server.tool('transfer.pending', 'List all transfer requests waiting for wallet o
     }
 });
 server.tool('transfer.batch', 'Send multiple TON transfers in a SINGLE wallet approval. Up to 4 transfers per batch (v4 wallet). All transfers appear as one transaction to sign. Use for batch payments, multi-recipient sends, or multiple DEX orders at once.', {
-    transfers: z.string().describe('JSON array of transfers: [{"to":"addr","amountNano":"1000000000","comment":"optional text"},...]'),
+    transfers: z.string().describe('JSON array of transfers: [{"to":"addr","amountNano":"1000000000","comment":"optional text","payload":"base64 BOC"},...]. Use payload for custom BOC (e.g. DEX close order), comment for text messages. payload takes precedence over comment.'),
 }, { title: 'Batch Transfer', readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ transfers: transfersJson }) => {
     if (!TOKEN) {
         return { content: [{ type: 'text', text: 'No token configured. Use auth.request first.' }], isError: true };
@@ -332,11 +332,14 @@ server.tool('transfer.batch', 'Send multiple TON transfers in a SINGLE wallet ap
             throw new Error('No transfers provided');
         if (transfers.length > 4)
             throw new Error('Max 4 transfers per batch (v4 wallet). Use agent_wallet.batch_transfer for more.');
-        // Encode comments as payloads
+        // Encode comments as payloads (payload field takes precedence)
         const processed = [];
         for (const t of transfers) {
             const entry = { to: t.to, amountNano: t.amountNano };
-            if (t.comment) {
+            if (t.payload) {
+                entry.payload = t.payload;
+            }
+            else if (t.comment) {
                 const { beginCell } = await import('@ton/core');
                 const commentCell = beginCell().storeUint(0, 32).storeStringTail(t.comment).endCell();
                 entry.payload = commentCell.toBoc().toString('base64');
@@ -359,7 +362,7 @@ server.tool('transfer.batch', 'Send multiple TON transfers in a SINGLE wallet ap
                         `Total: ${totalTon} TON`,
                         `Request ID: ${result.id}`,
                         '',
-                        ...transfers.map((t, i) => `  ${i + 1}. ${t.amountNano} nanoTON → ${t.to.slice(0, 16)}...${t.comment ? ` "${t.comment}"` : ''}`),
+                        ...transfers.map((t, i) => `  ${i + 1}. ${t.amountNano} nanoTON → ${t.to.slice(0, 16)}...${t.payload ? ' [payload]' : t.comment ? ` "${t.comment}"` : ''}`),
                         '',
                         'Approve in your wallet app — one signature for all transfers.',
                     ].join('\n'),
@@ -500,35 +503,56 @@ server.tool('lookup.price', 'Get the current TON price in USD, EUR, or other cur
         return { content: [{ type: 'text', text: `Error: ${e.message}` }], isError: true };
     }
 });
-server.tool('dex.create_order', 'Place a limit order on the open4dev DEX order book. Both amount and price are human-readable — the API converts to raw units automatically. The order requires wallet approval. Slippage (4% including fees) is applied automatically.', {
-    fromToken: z.string().describe('Token to sell, e.g. "NOT", "TON", "USDT"'),
-    toToken: z.string().describe('Token to buy, e.g. "TON", "NOT", "AGNT"'),
-    amount: z.string().describe('Human-readable amount to sell, e.g. "10000" for 10,000 NOT or "5" for 5 USDT'),
-    price: z.number().describe('Human-readable price: how many toToken per 1 fromToken. E.g. price=20 means "1 USDT = 20 AGNT". price=0.000289 means "1 NOT = 0.000289 TON".'),
-}, { title: 'Create DEX Order', readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ fromToken, toToken, amount, price }) => {
+server.tool('dex.create_order', 'Place one or more limit orders on the open4dev DEX order book. For a single order, provide fromToken/toToken/amount/price directly. For multiple orders, provide an orders array. All orders are batched into one wallet transaction. Both amount and price are human-readable. Slippage (4% including fees) is applied automatically.', {
+    fromToken: z.string().optional().describe('Token to sell (single order), e.g. "NOT", "TON", "USDT"'),
+    toToken: z.string().optional().describe('Token to buy (single order), e.g. "TON", "NOT", "AGNT"'),
+    amount: z.string().optional().describe('Human-readable amount to sell (single order), e.g. "10000"'),
+    price: z.number().optional().describe('Human-readable price (single order): how many toToken per 1 fromToken'),
+    orders: z.array(z.object({
+        fromToken: z.string().describe('Token to sell'),
+        toToken: z.string().describe('Token to buy'),
+        amount: z.string().describe('Human-readable amount to sell'),
+        price: z.number().describe('Human-readable price: how many toToken per 1 fromToken'),
+    })).optional().describe('Array of orders for batch creation. If provided, flat params are ignored.'),
+}, { title: 'Create DEX Order', readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true }, async ({ fromToken, toToken, amount, price, orders }) => {
     if (!TOKEN) {
         return { content: [{ type: 'text', text: 'No token configured. Use auth.request first.' }], isError: true };
     }
     try {
+        // Build request body: batch or single
+        let requestBody;
+        if (orders && orders.length > 0) {
+            requestBody = JSON.stringify({ orders });
+        }
+        else if (fromToken && toToken && amount && price) {
+            requestBody = JSON.stringify({ fromToken, toToken, amount, price });
+        }
+        else {
+            return { content: [{ type: 'text', text: 'Provide either orders array or fromToken/toToken/amount/price.' }], isError: true };
+        }
         const result = await apiCall('/v1/dex/order', {
             method: 'POST',
-            body: JSON.stringify({ fromToken, toToken, amount, price }),
+            body: requestBody,
         });
+        // Format output
+        const orderList = result.orders || [result.swap];
+        const lines = [];
+        if (orderList.length === 1) {
+            const s = orderList[0];
+            lines.push(`Order placed on open4dev DEX!`, ``, `${s.fromToken} → ${s.toToken}`, `Amount: ${s.amount}`, `Price: ${s.price} ${s.toToken} per ${s.fromToken}`, `Slippage: ${s.slippage ?? 4}% (includes fees)`);
+        }
+        else {
+            lines.push(`${orderList.length} orders placed on open4dev DEX!`, ``);
+            for (let i = 0; i < orderList.length; i++) {
+                const s = orderList[i];
+                lines.push(`Order ${i + 1}: ${s.fromToken} → ${s.toToken} | Amount: ${s.amount} | Price: ${s.price}`);
+            }
+            lines.push(``);
+            lines.push(`Slippage: 4% (includes fees)`);
+        }
+        lines.push(`Request ID: ${result.id}`, ``, `Approve in your wallet app.`);
         return {
-            content: [{
-                    type: 'text',
-                    text: [
-                        `Order placed on open4dev DEX!`,
-                        ``,
-                        `${fromToken} → ${toToken}`,
-                        `Amount: ${amount}`,
-                        `Price: ${price} ${toToken} per ${fromToken}`,
-                        `Slippage: ${result.swap?.slippage ?? 4}% (includes fees)`,
-                        `Request ID: ${result.id}`,
-                        ``,
-                        `Approve the order in your wallet app.`,
-                    ].join('\n'),
-                }],
+            content: [{ type: 'text', text: lines.join('\n') }],
         };
     }
     catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tongateway/mcp",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "TON blockchain gateway for AI agents — 16 MCP tools: wallet info, transfers, jettons, NFTs, DNS, prices, DEX orders, agent wallets",
   "homepage": "https://tongateway.ai",
   "license": "MIT",