@t402/mcp 2.5.0 → 2.6.0

package/dist/esm/tools/index.d.mts

@@ -1,5 +1,6 @@
 import { z } from 'zod';
-import { S as SupportedNetwork, C as ChainBalance, b as PaymentResult, G as GaslessPaymentResult, B as BridgeFeeQuote, a as BridgeResult } from '../types-CwwW_c2B.mjs';
+import { S as SupportedNetwork, C as ChainBalance, b as PaymentResult, G as GaslessPaymentResult, B as BridgeFeeQuote, a as BridgeResult } from '../ton-bridge-BN3RKhNy.mjs';
+export { d as TON_BRIDGE_TOOLS, e as TonMcpBridgeConfig, f as createTonBridgeToolSet, g as executeTonBridgeTool } from '../ton-bridge-BN3RKhNy.mjs';
 import { T402WDK } from '@t402/wdk';
 import 'viem';
 
@@ -535,6 +536,222 @@ declare function executeAutoPayDemo(input: AutoPayInput): AutoPayResult;
  */
 declare function formatAutoPayResult(result: AutoPayResult): string;
 
+/**
+ * Unified MCP Toolkit - Combines WDK wallet tools with t402 payment tools.
+ *
+ * Agent workflow: check price -> check balance -> bridge if needed -> pay
+ * All in one MCP session with a single server.
+ */
+
+/**
+ * Configuration for unified MCP mode
+ */
+interface UnifiedMcpConfig {
+    /** WDK seed phrase for wallet management */
+    wdkSeedPhrase?: string;
+    /** Chain RPC configurations */
+    chains?: Record<string, string | string[]>;
+    /** Enable auto-pay mode (automatic balance check + bridge + pay) */
+    autoPayEnabled?: boolean;
+}
+/**
+ * SmartPay input schema
+ */
+declare const smartPayInputSchema: z.ZodObject<{
+    url: z.ZodString;
+    maxBridgeFee: z.ZodOptional<z.ZodString>;
+    preferredNetwork: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    url: string;
+    maxBridgeFee?: string | undefined;
+    preferredNetwork?: string | undefined;
+}, {
+    url: string;
+    maxBridgeFee?: string | undefined;
+    preferredNetwork?: string | undefined;
+}>;
+type SmartPayInput = z.infer<typeof smartPayInputSchema>;
+/**
+ * SmartPay result
+ */
+interface SmartPayResult {
+    /** Whether the resource was successfully accessed */
+    success: boolean;
+    /** HTTP status code */
+    statusCode: number;
+    /** Response body (truncated if large) */
+    body: string;
+    /** Content type of the response */
+    contentType?: string;
+    /** Steps taken during smart payment */
+    steps: SmartPayStep[];
+    /** Payment details (if payment was made) */
+    payment?: {
+        network: string;
+        scheme: string;
+        amount: string;
+        payTo: string;
+    };
+    /** Error message (if failed) */
+    error?: string;
+}
+/**
+ * A step in the smart payment flow
+ */
+interface SmartPayStep {
+    action: 'check_price' | 'check_balance' | 'bridge' | 'pay' | 'fetch';
+    status: 'success' | 'skipped' | 'failed';
+    detail: string;
+}
+/**
+ * PaymentPlan input schema
+ */
+declare const paymentPlanInputSchema: z.ZodObject<{
+    paymentRequired: z.ZodObject<{
+        scheme: z.ZodOptional<z.ZodString>;
+        network: z.ZodOptional<z.ZodString>;
+        maxAmountRequired: z.ZodOptional<z.ZodString>;
+        resource: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        payTo: z.ZodOptional<z.ZodString>;
+        maxDeadline: z.ZodOptional<z.ZodNumber>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        scheme: z.ZodOptional<z.ZodString>;
+        network: z.ZodOptional<z.ZodString>;
+        maxAmountRequired: z.ZodOptional<z.ZodString>;
+        resource: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        payTo: z.ZodOptional<z.ZodString>;
+        maxDeadline: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        scheme: z.ZodOptional<z.ZodString>;
+        network: z.ZodOptional<z.ZodString>;
+        maxAmountRequired: z.ZodOptional<z.ZodString>;
+        resource: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        payTo: z.ZodOptional<z.ZodString>;
+        maxDeadline: z.ZodOptional<z.ZodNumber>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "strip", z.ZodTypeAny, {
+    paymentRequired: {
+        network?: string | undefined;
+        description?: string | undefined;
+        scheme?: string | undefined;
+        payTo?: string | undefined;
+        maxAmountRequired?: string | undefined;
+        resource?: string | undefined;
+        maxDeadline?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    paymentRequired: {
+        network?: string | undefined;
+        description?: string | undefined;
+        scheme?: string | undefined;
+        payTo?: string | undefined;
+        maxAmountRequired?: string | undefined;
+        resource?: string | undefined;
+        maxDeadline?: number | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}>;
+type PaymentPlanInput = z.infer<typeof paymentPlanInputSchema>;
+/**
+ * Payment plan result
+ */
+interface PaymentPlanResult {
+    /** Whether a viable plan was found */
+    viable: boolean;
+    /** Recommended network to pay on */
+    recommendedNetwork?: string;
+    /** Available balance on that network */
+    availableBalance?: string;
+    /** Whether bridging is needed */
+    bridgeRequired: boolean;
+    /** Bridge details if needed */
+    bridgeDetails?: {
+        fromChain: string;
+        toChain: string;
+        amount: string;
+        estimatedFee: string;
+    };
+    /** Balances across all chains */
+    balances: Array<{
+        chain: string;
+        usdt0: string;
+        usdc: string;
+    }>;
+    /** Reason if not viable */
+    reason?: string;
+}
+/**
+ * Unified tool definitions (additional tools beyond base + WDK)
+ */
+declare const UNIFIED_TOOL_DEFINITIONS: {
+    readonly 't402/smartPay': {
+        readonly name: "t402/smartPay";
+        readonly description: "Intelligent payment that automatically checks balance, bridges if needed, and pays. Handles the entire payment flow for 402-protected resources.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly url: {
+                    readonly type: "string";
+                    readonly description: "URL of the 402-protected resource";
+                };
+                readonly maxBridgeFee: {
+                    readonly type: "string";
+                    readonly description: "Maximum acceptable bridge fee in native token (optional)";
+                };
+                readonly preferredNetwork: {
+                    readonly type: "string";
+                    readonly description: "Preferred network for payment (optional)";
+                };
+            };
+            readonly required: readonly ["url"];
+        };
+    };
+    readonly 't402/paymentPlan': {
+        readonly name: "t402/paymentPlan";
+        readonly description: "Analyze a 402 response and create an optimal payment plan considering balances across all chains. Returns recommended network, bridge requirements, and balance overview.";
+        readonly inputSchema: {
+            readonly type: "object";
+            readonly properties: {
+                readonly paymentRequired: {
+                    readonly type: "object";
+                    readonly description: "The 402 PaymentRequired response";
+                };
+            };
+            readonly required: readonly ["paymentRequired"];
+        };
+    };
+};
+/**
+ * Execute t402/smartPay tool
+ */
+declare function executeSmartPay(input: SmartPayInput, wdk: T402WDK): Promise<SmartPayResult>;
+/**
+ * Execute t402/smartPay in demo mode
+ */
+declare function executeSmartPayDemo(input: SmartPayInput): SmartPayResult;
+/**
+ * Execute t402/paymentPlan tool
+ */
+declare function executePaymentPlan(input: PaymentPlanInput, wdk: T402WDK): Promise<PaymentPlanResult>;
+/**
+ * Execute t402/paymentPlan in demo mode
+ */
+declare function executePaymentPlanDemo(_input: PaymentPlanInput): PaymentPlanResult;
+/**
+ * Format smartPay result for display
+ */
+declare function formatSmartPayResult(result: SmartPayResult): string;
+/**
+ * Format paymentPlan result for display
+ */
+declare function formatPaymentPlanResult(result: PaymentPlanResult): string;
+
 /**
  * t402 MCP Tools - Export all payment tools
  */
@@ -821,4 +1038,4 @@ declare const WDK_TOOL_DEFINITIONS: {
     };
 };
 
-export { type AllBalancesResult, type AutoPayInput, type AutoPayResult, type BridgeInput, type BridgeOptions, GASLESS_SUPPORTED_NETWORKS, type GetAllBalancesInput, type GetBalanceInput, type GetBridgeFeeInput, type PayGaslessInput, type PayGaslessOptions, type PayInput, type PayOptions, TOOL_DEFINITIONS, WDK_TOOL_DEFINITIONS, type WdkBalancesResult, type WdkGetBalancesInput, type WdkGetWalletInput, type WdkSwapInput, type WdkSwapResult, type WdkTransferInput, type WdkTransferResult, type WdkWalletInfo, autoPayInputSchema, bridgeInputSchema, executeAutoPay, executeAutoPayDemo, executeBridge, executeGetAllBalances, executeGetBalance, executeGetBridgeFee, executePay, executePayGasless, executeWdkGetBalances, executeWdkGetBalancesDemo, executeWdkGetWallet, executeWdkGetWalletDemo, executeWdkSwap, executeWdkSwapDemo, executeWdkTransfer, executeWdkTransferDemo, formatAllBalancesResult, formatAutoPayResult, formatBalanceResult, formatBridgeFeeResult, formatBridgeResult, formatGaslessPaymentResult, formatPaymentResult, formatWdkBalancesResult, formatWdkSwapResult, formatWdkTransferResult, formatWdkWalletResult, getAllBalancesInputSchema, getBalanceInputSchema, getBridgeFeeInputSchema, payGaslessInputSchema, payInputSchema, wdkGetBalancesInputSchema, wdkGetWalletInputSchema, wdkSwapInputSchema, wdkTransferInputSchema };
+export { type AllBalancesResult, type AutoPayInput, type AutoPayResult, type BridgeInput, type BridgeOptions, GASLESS_SUPPORTED_NETWORKS, type GetAllBalancesInput, type GetBalanceInput, type GetBridgeFeeInput, type PayGaslessInput, type PayGaslessOptions, type PayInput, type PayOptions, type PaymentPlanInput, type PaymentPlanResult, type SmartPayInput, type SmartPayResult, type SmartPayStep, TOOL_DEFINITIONS, UNIFIED_TOOL_DEFINITIONS, type UnifiedMcpConfig, WDK_TOOL_DEFINITIONS, type WdkBalancesResult, type WdkGetBalancesInput, type WdkGetWalletInput, type WdkSwapInput, type WdkSwapResult, type WdkTransferInput, type WdkTransferResult, type WdkWalletInfo, autoPayInputSchema, bridgeInputSchema, executeAutoPay, executeAutoPayDemo, executeBridge, executeGetAllBalances, executeGetBalance, executeGetBridgeFee, executePay, executePayGasless, executePaymentPlan, executePaymentPlanDemo, executeSmartPay, executeSmartPayDemo, executeWdkGetBalances, executeWdkGetBalancesDemo, executeWdkGetWallet, executeWdkGetWalletDemo, executeWdkSwap, executeWdkSwapDemo, executeWdkTransfer, executeWdkTransferDemo, formatAllBalancesResult, formatAutoPayResult, formatBalanceResult, formatBridgeFeeResult, formatBridgeResult, formatGaslessPaymentResult, formatPaymentPlanResult, formatPaymentResult, formatSmartPayResult, formatWdkBalancesResult, formatWdkSwapResult, formatWdkTransferResult, formatWdkWalletResult, getAllBalancesInputSchema, getBalanceInputSchema, getBridgeFeeInputSchema, payGaslessInputSchema, payInputSchema, paymentPlanInputSchema, smartPayInputSchema, wdkGetBalancesInputSchema, wdkGetWalletInputSchema, wdkSwapInputSchema, wdkTransferInputSchema };

package/dist/esm/tools/index.mjs

@@ -1,9 +1,12 @@
 import {
   GASLESS_SUPPORTED_NETWORKS,
+  TON_BRIDGE_TOOLS,
   TOOL_DEFINITIONS,
+  UNIFIED_TOOL_DEFINITIONS,
   WDK_TOOL_DEFINITIONS,
   autoPayInputSchema,
   bridgeInputSchema,
+  createTonBridgeToolSet,
   executeAutoPay,
   executeAutoPayDemo,
   executeBridge,
@@ -12,6 +15,11 @@ import {
   executeGetBridgeFee,
   executePay,
   executePayGasless,
+  executePaymentPlan,
+  executePaymentPlanDemo,
+  executeSmartPay,
+  executeSmartPayDemo,
+  executeTonBridgeTool,
   executeWdkGetBalances,
   executeWdkGetBalancesDemo,
   executeWdkGetWallet,
@@ -26,7 +34,9 @@ import {
   formatBridgeFeeResult,
   formatBridgeResult,
   formatGaslessPaymentResult,
+  formatPaymentPlanResult,
   formatPaymentResult,
+  formatSmartPayResult,
   formatWdkBalancesResult,
   formatWdkSwapResult,
   formatWdkTransferResult,
@@ -36,17 +46,22 @@ import {
   getBridgeFeeInputSchema,
   payGaslessInputSchema,
   payInputSchema,
+  paymentPlanInputSchema,
+  smartPayInputSchema,
   wdkGetBalancesInputSchema,
   wdkGetWalletInputSchema,
   wdkSwapInputSchema,
   wdkTransferInputSchema
-} from "../chunk-5UOBQKXW.mjs";
+} from "../chunk-RDQ7AMR4.mjs";
 export {
   GASLESS_SUPPORTED_NETWORKS,
+  TON_BRIDGE_TOOLS,
   TOOL_DEFINITIONS,
+  UNIFIED_TOOL_DEFINITIONS,
   WDK_TOOL_DEFINITIONS,
   autoPayInputSchema,
   bridgeInputSchema,
+  createTonBridgeToolSet,
   executeAutoPay,
   executeAutoPayDemo,
   executeBridge,
@@ -55,6 +70,11 @@ export {
   executeGetBridgeFee,
   executePay,
   executePayGasless,
+  executePaymentPlan,
+  executePaymentPlanDemo,
+  executeSmartPay,
+  executeSmartPayDemo,
+  executeTonBridgeTool,
   executeWdkGetBalances,
   executeWdkGetBalancesDemo,
   executeWdkGetWallet,
@@ -69,7 +89,9 @@ export {
   formatBridgeFeeResult,
   formatBridgeResult,
   formatGaslessPaymentResult,
+  formatPaymentPlanResult,
   formatPaymentResult,
+  formatSmartPayResult,
   formatWdkBalancesResult,
   formatWdkSwapResult,
   formatWdkTransferResult,
@@ -79,6 +101,8 @@ export {
   getBridgeFeeInputSchema,
   payGaslessInputSchema,
   payInputSchema,
+  paymentPlanInputSchema,
+  smartPayInputSchema,
   wdkGetBalancesInputSchema,
   wdkGetWalletInputSchema,
   wdkSwapInputSchema,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@t402/mcp",
-  "version": "2.5.0",
+  "version": "2.6.0",
   "description": "t402 Payment Protocol MCP Server for AI Agents",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",
@@ -19,32 +19,36 @@
   ],
   "license": "Apache-2.0",
   "author": "T402 Team",
-  "repository": "https://github.com/t402-io/t402",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/t402-io/t402.git",
+    "directory": "sdks/typescript/packages/mcp"
+  },
   "devDependencies": {
     "@eslint/js": "^9.39.2",
-    "@types/node": "^25.2.2",
-    "@typescript-eslint/eslint-plugin": "^8.55.0",
-    "@typescript-eslint/parser": "^8.55.0",
+    "@types/node": "^25.2.3",
+    "@typescript-eslint/eslint-plugin": "^8.56.0",
+    "@typescript-eslint/parser": "^8.56.0",
     "eslint": "^9.24.0",
     "eslint-plugin-import": "^2.31.0",
-    "eslint-plugin-jsdoc": "^62.5.4",
+    "eslint-plugin-jsdoc": "^62.6.0",
     "eslint-plugin-prettier": "^5.5.5",
-    "glob": "^13.0.0",
+    "glob": "^13.0.5",
     "prettier": "3.8.1",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
-    "vite-tsconfig-paths": "^6.1.0",
+    "vite-tsconfig-paths": "^6.1.1",
     "vitest": "^3.2.4"
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "zod": "^3.24.2",
-    "@t402/core": "2.5.0",
-    "@t402/wdk-protocol": "2.5.0",
-    "@t402/wdk": "2.5.0",
-    "@t402/evm": "2.5.0"
+    "@t402/core": "2.6.0",
+    "@t402/evm": "2.6.0",
+    "@t402/wdk-protocol": "2.6.0",
+    "@t402/wdk": "2.6.0"
   },
   "peerDependencies": {
     "viem": "^2.0.0"
@@ -85,6 +89,10 @@
     "dist",
     "bin"
   ],
+  "homepage": "https://t402.io",
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "start": "node ./bin/t402-mcp.js",
     "build": "tsup",