@wowok/agent-mcp 2.3.10 → 2.3.12

package/dist/index.js

@@ -1056,11 +1056,11 @@ async function main() {
     }, handleOnchainEvents);
     server.registerTool("wowok_buildin_info", {
         title: "ℹ️ WoWok Build-in Information",
-        description: "Query WoWok protocol information: 'constants', 'built-in permissions', 'guard instructions', 'current network', or 'value types'.",
+        description: "Query WoWok protocol information: 'constants', 'built-in permissions', 'guard instructions', 'current network', 'value types', or 'mainnet bridge tokens'. For 'mainnet bridge tokens': returns cross-chain bridge tokens (ETH, WETH, WBTC, USDC, USDT) with each token's symbol, WOW-side type tag (wowTypeTag), EVM address, decimals, and description. The wowTypeTag (format {address}::{module}::{struct}) can be used directly as the `type_parameter` of Service / Treasury / Reward / Allocation objects to set their payment token — e.g. use USDT's wowTypeTag to create a Service that accepts USDT payments.",
         inputSchema: ProtocolInfoQuerySchema,
         outputSchema: ProtocolInfoResultSchema,
         annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true },
-        _meta: createToolMeta("WoWok info", ["build-in", "constants", "permissions", "guard", "network", "value-types"]),
+        _meta: createToolMeta("WoWok info", ["build-in", "constants", "permissions", "guard", "network", "value-types", "bridge-tokens"]),
     }, handleWowokInfo);
     server.registerTool("schema_query", {
         title: "📋 Schema Query",

package/dist/schema/call/base.js

@@ -42,14 +42,14 @@ export const DescriptionObjectSchema = z.union([
     NamedObjectWithDescriptionSchema.describe("Object format: CREATE a NEW object with name, optional description, and visibility settings. Extends NamedObjectSchema with an additional 'description' field for detailed object information.")
 ]).describe("Two ways to specify an object: (1) STRING - Reference an EXISTING object by name or ID; (2) OBJECT - CREATE a NEW object with full configuration including optional name, tags, description, and visibility settings (local private by default, or public on-chain with onChain:true).");
 export const TypeNamedObjectSchema = NamedObjectSchema.extend({
-    type_parameter: TokenTypeWithDefaultSchema.describe("Token type of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments."),
-}).describe("Create a new named object (with optional tags) and specify a token type for payments (e.g., WOW).");
+    type_parameter: TokenTypeWithDefaultSchema.describe("Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here."),
+}).describe("Create a new named object (with optional tags) and specify a token type for payments (e.g., WOW, USDT, ETH).");
 export const NamedObjectWithPermissionSchema = NamedObjectSchema.extend({
     permission: DescriptionObjectSchema.optional(),
 }).strict().describe("Use a Permission object to manage access control: (1) Specify an existing Permission object's name or ID; (2) Create a new Permission object (which can be named and tagged); or (3) Leave empty to automatically create a new unnamed Permission object.");
 export const TypeNamedObjectWithPermissionSchema = NamedObjectWithPermissionSchema.extend({
-    type_parameter: TokenTypeWithDefaultSchema.describe("Type parameter (token type) of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments."),
-}).strict().describe("Create a new named on-chain object with both a specific token type AND permission control. Use this when you need to specify a token type (e.g., WOW) for payment operations AND require permission management (who can manage/operate this object). For objects without permission management, use TypeNamedObjectSchema instead.");
+    type_parameter: TokenTypeWithDefaultSchema.describe("Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here."),
+}).strict().describe("Create a new named on-chain object with both a specific token type (e.g., WOW, USDT, ETH) AND permission control. Use this when you need to specify a token type for payment operations AND require permission management (who can manage/operate this object). For objects without permission management, use TypeNamedObjectSchema instead.");
 export const CoinParamSchema = z.union([
     z.object({
         balance: BalanceTypeSchema,

package/dist/schema/call/bridge.d.ts

@@ -1019,17 +1019,17 @@ export declare const BridgeQuerySupportedTokensResultSchema: z.ZodArray<z.ZodObj
         symbol: string;
         description: string;
         tokenId: number;
+        wowTypeTag: string;
         evmAddress: string;
         evmDecimals: number;
-        wowTypeTag: string;
         wowDecimals: number;
     }, {
         symbol: string;
         description: string;
         tokenId: number;
+        wowTypeTag: string;
         evmAddress: string;
         evmDecimals: number;
-        wowTypeTag: string;
         wowDecimals: number;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -1037,9 +1037,9 @@ export declare const BridgeQuerySupportedTokensResultSchema: z.ZodArray<z.ZodObj
         symbol: string;
         description: string;
         tokenId: number;
+        wowTypeTag: string;
         evmAddress: string;
         evmDecimals: number;
-        wowTypeTag: string;
         wowDecimals: number;
     }[];
     chainId: number;
@@ -1050,9 +1050,9 @@ export declare const BridgeQuerySupportedTokensResultSchema: z.ZodArray<z.ZodObj
         symbol: string;
         description: string;
         tokenId: number;
+        wowTypeTag: string;
         evmAddress: string;
         evmDecimals: number;
-        wowTypeTag: string;
         wowDecimals: number;
     }[];
     chainId: number;
@@ -1626,17 +1626,17 @@ export declare const BridgeOutputSchema: z.ZodDiscriminatedUnion<"operation_type
             symbol: string;
             description: string;
             tokenId: number;
+            wowTypeTag: string;
             evmAddress: string;
             evmDecimals: number;
-            wowTypeTag: string;
             wowDecimals: number;
         }, {
             symbol: string;
             description: string;
             tokenId: number;
+            wowTypeTag: string;
             evmAddress: string;
             evmDecimals: number;
-            wowTypeTag: string;
             wowDecimals: number;
         }>, "many">;
     }, "strip", z.ZodTypeAny, {
@@ -1644,9 +1644,9 @@ export declare const BridgeOutputSchema: z.ZodDiscriminatedUnion<"operation_type
             symbol: string;
             description: string;
             tokenId: number;
+            wowTypeTag: string;
             evmAddress: string;
             evmDecimals: number;
-            wowTypeTag: string;
             wowDecimals: number;
         }[];
         chainId: number;
@@ -1657,9 +1657,9 @@ export declare const BridgeOutputSchema: z.ZodDiscriminatedUnion<"operation_type
             symbol: string;
             description: string;
             tokenId: number;
+            wowTypeTag: string;
             evmAddress: string;
             evmDecimals: number;
-            wowTypeTag: string;
             wowDecimals: number;
         }[];
         chainId: number;
@@ -1673,9 +1673,9 @@ export declare const BridgeOutputSchema: z.ZodDiscriminatedUnion<"operation_type
             symbol: string;
             description: string;
             tokenId: number;
+            wowTypeTag: string;
             evmAddress: string;
             evmDecimals: number;
-            wowTypeTag: string;
             wowDecimals: number;
         }[];
         chainId: number;
@@ -1690,9 +1690,9 @@ export declare const BridgeOutputSchema: z.ZodDiscriminatedUnion<"operation_type
             symbol: string;
             description: string;
             tokenId: number;
+            wowTypeTag: string;
             evmAddress: string;
             evmDecimals: number;
-            wowTypeTag: string;
             wowDecimals: number;
         }[];
         chainId: number;

package/dist/schema/common/index.js

@@ -49,10 +49,10 @@ export const TokenTypeSchema = z
 }, {
     message: "Invalid token type format. Expected: {address}::{module}::{struct} where address is 0x+64hex, module/struct are valid Move identifiers, or '0x2::wow::WOW'"
 })
-    .describe("Token type in format: {address}::{module}::{struct}. Example: 0x2::wow::WOW");
+    .describe("Token type in format: {address}::{module}::{struct}. e.g. '0x2::wow::WOW' (WOW), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). To discover all available tokens and their type tags, query 'mainnet bridge tokens' via wowok_buildin_info and use the returned `wowTypeTag` here.");
 export const TokenTypeWithDefaultSchema = TokenTypeSchema
     .default(WOW_TOKEN_TYPE)
-    .describe("Token type in format: {address}::{module}::{struct}. Default: 0x2::wow::WOW");
+    .describe("Token type in format: {address}::{module}::{struct}. Default: '0x2::wow::WOW'. Other examples: '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). To discover all available tokens and their type tags, query 'mainnet bridge tokens' via wowok_buildin_info and use the returned `wowTypeTag` here.");
 export const NameSchema = z
     .string()
     .refine(isValidName, "Name string (max 64 bcs characters, must not start with '0x')");

package/dist/schema/query/index.d.ts

@@ -47077,6 +47077,34 @@ export declare const PermissionFilterSchema: z.ZodObject<{
     objectType?: import("@wowok/wowok").ObjectType | undefined;
     index?: number | undefined;
 }>;
+export declare const BridgeTokenInfoSchema: z.ZodObject<{
+    tokenId: z.ZodNumber;
+    symbol: z.ZodString;
+    wowTypeTag: z.ZodString;
+    evmAddress: z.ZodString;
+    evmDecimals: z.ZodNumber;
+    wowDecimals: z.ZodNumber;
+    evmChains: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    symbol: string;
+    tokenId: number;
+    wowTypeTag: string;
+    evmAddress: string;
+    evmDecimals: number;
+    wowDecimals: number;
+    description?: string | undefined;
+    evmChains?: number[] | undefined;
+}, {
+    symbol: string;
+    tokenId: number;
+    wowTypeTag: string;
+    evmAddress: string;
+    evmDecimals: number;
+    wowDecimals: number;
+    description?: string | undefined;
+    evmChains?: number[] | undefined;
+}>;
 export declare const ProtocolInfoQuerySchema: z.ZodDiscriminatedUnion<"info", [z.ZodObject<{
     info: z.ZodLiteral<"constants">;
 }, "strip", z.ZodTypeAny, {
@@ -47173,6 +47201,12 @@ export declare const ProtocolInfoQuerySchema: z.ZodDiscriminatedUnion<"info", [z
     info: "value types";
 }, {
     info: "value types";
+}>, z.ZodObject<{
+    info: z.ZodLiteral<"mainnet bridge tokens">;
+}, "strip", z.ZodTypeAny, {
+    info: "mainnet bridge tokens";
+}, {
+    info: "mainnet bridge tokens";
 }>]>;
 export declare const BuiltinPermissionSchema: z.ZodObject<{
     result: z.ZodArray<z.ZodObject<{
@@ -47361,6 +47395,60 @@ export declare const ProtocolInfoResultWrappedSchema: z.ZodDiscriminatedUnion<"i
         description: string;
     }[];
     info: "value types";
+}>, z.ZodObject<{
+    info: z.ZodLiteral<"mainnet bridge tokens">;
+    result: z.ZodArray<z.ZodObject<{
+        tokenId: z.ZodNumber;
+        symbol: z.ZodString;
+        wowTypeTag: z.ZodString;
+        evmAddress: z.ZodString;
+        evmDecimals: z.ZodNumber;
+        wowDecimals: z.ZodNumber;
+        evmChains: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+        description: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        symbol: string;
+        tokenId: number;
+        wowTypeTag: string;
+        evmAddress: string;
+        evmDecimals: number;
+        wowDecimals: number;
+        description?: string | undefined;
+        evmChains?: number[] | undefined;
+    }, {
+        symbol: string;
+        tokenId: number;
+        wowTypeTag: string;
+        evmAddress: string;
+        evmDecimals: number;
+        wowDecimals: number;
+        description?: string | undefined;
+        evmChains?: number[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    result: {
+        symbol: string;
+        tokenId: number;
+        wowTypeTag: string;
+        evmAddress: string;
+        evmDecimals: number;
+        wowDecimals: number;
+        description?: string | undefined;
+        evmChains?: number[] | undefined;
+    }[];
+    info: "mainnet bridge tokens";
+}, {
+    result: {
+        symbol: string;
+        tokenId: number;
+        wowTypeTag: string;
+        evmAddress: string;
+        evmDecimals: number;
+        wowDecimals: number;
+        description?: string | undefined;
+        evmChains?: number[] | undefined;
+    }[];
+    info: "mainnet bridge tokens";
 }>]>;
 export declare const ProtocolInfoResultSchema: z.ZodObject<{
     result: z.ZodDiscriminatedUnion<"info", [z.ZodObject<{
@@ -47518,6 +47606,60 @@ export declare const ProtocolInfoResultSchema: z.ZodObject<{
             description: string;
         }[];
         info: "value types";
+    }>, z.ZodObject<{
+        info: z.ZodLiteral<"mainnet bridge tokens">;
+        result: z.ZodArray<z.ZodObject<{
+            tokenId: z.ZodNumber;
+            symbol: z.ZodString;
+            wowTypeTag: z.ZodString;
+            evmAddress: z.ZodString;
+            evmDecimals: z.ZodNumber;
+            wowDecimals: z.ZodNumber;
+            evmChains: z.ZodOptional<z.ZodArray<z.ZodNumber, "many">>;
+            description: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            symbol: string;
+            tokenId: number;
+            wowTypeTag: string;
+            evmAddress: string;
+            evmDecimals: number;
+            wowDecimals: number;
+            description?: string | undefined;
+            evmChains?: number[] | undefined;
+        }, {
+            symbol: string;
+            tokenId: number;
+            wowTypeTag: string;
+            evmAddress: string;
+            evmDecimals: number;
+            wowDecimals: number;
+            description?: string | undefined;
+            evmChains?: number[] | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        result: {
+            symbol: string;
+            tokenId: number;
+            wowTypeTag: string;
+            evmAddress: string;
+            evmDecimals: number;
+            wowDecimals: number;
+            description?: string | undefined;
+            evmChains?: number[] | undefined;
+        }[];
+        info: "mainnet bridge tokens";
+    }, {
+        result: {
+            symbol: string;
+            tokenId: number;
+            wowTypeTag: string;
+            evmAddress: string;
+            evmDecimals: number;
+            wowDecimals: number;
+            description?: string | undefined;
+            evmChains?: number[] | undefined;
+        }[];
+        info: "mainnet bridge tokens";
     }>]>;
 }, "strip", z.ZodTypeAny, {
     result: {
@@ -47557,6 +47699,18 @@ export declare const ProtocolInfoResultSchema: z.ZodObject<{
             description: string;
         }[];
         info: "value types";
+    } | {
+        result: {
+            symbol: string;
+            tokenId: number;
+            wowTypeTag: string;
+            evmAddress: string;
+            evmDecimals: number;
+            wowDecimals: number;
+            description?: string | undefined;
+            evmChains?: number[] | undefined;
+        }[];
+        info: "mainnet bridge tokens";
     };
 }, {
     result: {
@@ -47596,6 +47750,18 @@ export declare const ProtocolInfoResultSchema: z.ZodObject<{
             description: string;
         }[];
         info: "value types";
+    } | {
+        result: {
+            symbol: string;
+            tokenId: number;
+            wowTypeTag: string;
+            evmAddress: string;
+            evmDecimals: number;
+            wowDecimals: number;
+            description?: string | undefined;
+            evmChains?: number[] | undefined;
+        }[];
+        info: "mainnet bridge tokens";
     };
 }>;
 export declare const LocalQueryResultSchema: z.ZodUnion<[z.ZodObject<{
@@ -73356,6 +73522,7 @@ export type ServiceSale = z.infer<typeof ServiceSaleSchema>;
 export type PurchasedItem = z.infer<typeof PurchasedItemSchema>;
 export type ConstantItem = z.infer<typeof ConstantItemSchema>;
 export type PermissionInfoType = z.infer<typeof PermissionInfoTypeSchema>;
+export type BridgeTokenInfo = z.infer<typeof BridgeTokenInfoSchema>;
 export type ProtocolInfoQuery = z.infer<typeof ProtocolInfoQuerySchema>;
 export type ProtocolInfoResult = z.infer<typeof ProtocolInfoResultSchema>;
 export type ProtocolInfoResultWrapped = z.infer<typeof ProtocolInfoResultWrappedSchema>;

package/dist/schema/query/index.js

@@ -1185,6 +1185,16 @@ export const PermissionFilterSchema = z.object({
     index: z.optional(PermissionIndexTypeSchema).describe('Index filter'),
     description: z.optional(z.string()).describe('Description filter')
 }).describe('Permission filter');
+export const BridgeTokenInfoSchema = z.object({
+    tokenId: z.number().describe('On-chain token ID (mainnet: WBTC=1, ETH/WETH=2, USDC=3, USDT=4)'),
+    symbol: z.string().describe('Token symbol/abbreviation (ETH, WETH, WBTC, USDC, USDT)'),
+    wowTypeTag: z.string().describe('WOW-side token type tag (format: {address}::{module}::{struct}, e.g. "0x2::wow::WOW", "0x...::usdt::USDT"). IMPORTANT: This value can be used directly as the `type_parameter` for Service / Treasury / Reward / Allocation objects to set their payment token. e.g. use USDT\'s wowTypeTag to create a Service that accepts USDT payments. To discover all available tokens, query this info type.'),
+    evmAddress: z.string().describe('EVM-side contract address (0x000...000 for native ETH; ERC20 contract address otherwise)'),
+    evmDecimals: z.number().describe('EVM-side decimals (ETH/WETH=18, WBTC=8, USDC/USDT=6)'),
+    wowDecimals: z.number().describe('WOW-side decimals (ETH/WBTC=8, USDC/USDT=6)'),
+    evmChains: z.array(z.number()).optional().describe('Bridge protocol chain IDs where this token is available (e.g. 10 = ETH mainnet)'),
+    description: z.string().optional().describe('Token description'),
+}).describe('Mainnet Bridge token info');
 export const ProtocolInfoQuerySchema = z.discriminatedUnion('info', [
     z.object({
         info: z.literal('constants')
@@ -1202,7 +1212,10 @@ export const ProtocolInfoQuerySchema = z.discriminatedUnion('info', [
     }).describe('Current network entrypoint'),
     z.object({
         info: z.literal('value types')
-    }).describe('Value types query - returns all supported value types with their numeric and string representations')
+    }).describe('Value types query - returns all supported value types with their numeric and string representations'),
+    z.object({
+        info: z.literal('mainnet bridge tokens')
+    }).describe('Mainnet Bridge tokens query - returns all tokens deployed on the mainnet bridge with their symbol, WOW-side type tag, EVM address, decimals, and description')
 ]).describe('WoWok Build-in infomation query');
 export const BuiltinPermissionSchema = z.object({
     result: z.array(PermissionInfoTypeSchema).describe('Built-in permissions result')
@@ -1227,6 +1240,10 @@ export const ProtocolInfoResultWrappedSchema = z.discriminatedUnion('info', [
     z.object({
         info: z.literal('value types'),
         result: z.array(ConstantItemSchema).describe('Value types result - each item contains name (string), value (string), and description showing the numeric mapping')
+    }),
+    z.object({
+        info: z.literal('mainnet bridge tokens'),
+        result: z.array(BridgeTokenInfoSchema).describe('Mainnet Bridge tokens result - each item contains tokenId, symbol, wowTypeTag, evmAddress, evmDecimals, wowDecimals, evmChains, and description')
     })
 ]).describe('Protocol info result');
 export const ProtocolInfoResultSchema = z.object({

package/dist/schemas/index.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "title": "WoWok MCP Schema Index",
   "description": "Index of all available JSON schemas for WoWok MCP tools",
-  "generatedAt": "2026-07-09T02:11:08.097Z",
+  "generatedAt": "2026-07-12T08:57:43.173Z",
   "tools": [
     {
       "name": "onchain_operations",

package/dist/schemas/onchain_operations.schema.json

@@ -1169,7 +1169,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Type parameter (token type) of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },
@@ -3929,7 +3929,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Type parameter (token type) of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },
@@ -4802,7 +4802,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Type parameter (token type) of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },
@@ -5384,7 +5384,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Type parameter (token type) of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },
@@ -5730,7 +5730,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Token type of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },
@@ -7293,12 +7293,12 @@
             },
             "type_parameter": {
               "type": "string",
-              "description": "Token type of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+              "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
               "default": "0x2::wow::WOW"
             }
           },
           "additionalProperties": false,
-          "description": "Create a new named object (with optional tags) and specify a token type for payments (e.g., WOW)."
+          "description": "Create a new named object (with optional tags) and specify a token type for payments (e.g., WOW, USDT, ETH)."
         },
         "revenue": {
           "type": "array",

package/dist/schemas/onchain_operations_allocation.schema.json

@@ -55,7 +55,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Token type of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },

package/dist/schemas/onchain_operations_arbitration.schema.json

@@ -91,7 +91,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Type parameter (token type) of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },

package/dist/schemas/onchain_operations_payment.schema.json

@@ -53,12 +53,12 @@
             },
             "type_parameter": {
               "type": "string",
-              "description": "Token type of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+              "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
               "default": "0x2::wow::WOW"
             }
           },
           "additionalProperties": false,
-          "description": "Create a new named object (with optional tags) and specify a token type for payments (e.g., WOW)."
+          "description": "Create a new named object (with optional tags) and specify a token type for payments (e.g., WOW, USDT, ETH)."
         },
         "revenue": {
           "type": "array",

package/dist/schemas/onchain_operations_reward.schema.json

@@ -91,7 +91,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Type parameter (token type) of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },

package/dist/schemas/onchain_operations_service.schema.json

@@ -91,7 +91,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Type parameter (token type) of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },

package/dist/schemas/onchain_operations_treasury.schema.json

@@ -91,7 +91,7 @@
                 },
                 "type_parameter": {
                   "type": "string",
-                  "description": "Type parameter (token type) of the on-chain object, e.g. '0x2::wow::WOW'. Defines what token this object can use for payments.",
+                  "description": "Payment token type for this object (format: {address}::{module}::{struct}). e.g. '0x2::wow::WOW' (WOW, the default), '0x...::usdt::USDT' (USDT), '0x...::eth::ETH' (ETH). Defines which token this object accepts for payments. To discover all available tokens and their type tags, call wowok_buildin_info with info 'mainnet bridge tokens' and use the returned `wowTypeTag` value here.",
                   "default": "0x2::wow::WOW"
                 }
               },

package/dist/schemas/wowok_buildin_info.output.json

@@ -562,6 +562,74 @@
                 "result"
               ],
               "additionalProperties": false
+            },
+            {
+              "type": "object",
+              "properties": {
+                "info": {
+                  "type": "string",
+                  "const": "mainnet bridge tokens"
+                },
+                "result": {
+                  "type": "array",
+                  "items": {
+                    "type": "object",
+                    "properties": {
+                      "tokenId": {
+                        "type": "number",
+                        "description": "On-chain token ID (mainnet: WBTC=1, ETH/WETH=2, USDC=3, USDT=4)"
+                      },
+                      "symbol": {
+                        "type": "string",
+                        "description": "Token symbol/abbreviation (ETH, WETH, WBTC, USDC, USDT)"
+                      },
+                      "wowTypeTag": {
+                        "type": "string",
+                        "description": "WOW-side token type tag (format: {address}::{module}::{struct}, e.g. \"0x2::wow::WOW\", \"0x...::usdt::USDT\"). IMPORTANT: This value can be used directly as the `type_parameter` for Service / Treasury / Reward / Allocation objects to set their payment token. e.g. use USDT's wowTypeTag to create a Service that accepts USDT payments. To discover all available tokens, query this info type."
+                      },
+                      "evmAddress": {
+                        "type": "string",
+                        "description": "EVM-side contract address (0x000...000 for native ETH; ERC20 contract address otherwise)"
+                      },
+                      "evmDecimals": {
+                        "type": "number",
+                        "description": "EVM-side decimals (ETH/WETH=18, WBTC=8, USDC/USDT=6)"
+                      },
+                      "wowDecimals": {
+                        "type": "number",
+                        "description": "WOW-side decimals (ETH/WBTC=8, USDC/USDT=6)"
+                      },
+                      "evmChains": {
+                        "type": "array",
+                        "items": {
+                          "type": "number"
+                        },
+                        "description": "Bridge protocol chain IDs where this token is available (e.g. 10 = ETH mainnet)"
+                      },
+                      "description": {
+                        "type": "string",
+                        "description": "Token description"
+                      }
+                    },
+                    "required": [
+                      "tokenId",
+                      "symbol",
+                      "wowTypeTag",
+                      "evmAddress",
+                      "evmDecimals",
+                      "wowDecimals"
+                    ],
+                    "additionalProperties": false,
+                    "description": "Mainnet Bridge token info"
+                  },
+                  "description": "Mainnet Bridge tokens result - each item contains tokenId, symbol, wowTypeTag, evmAddress, evmDecimals, wowDecimals, evmChains, and description"
+                }
+              },
+              "required": [
+                "info",
+                "result"
+              ],
+              "additionalProperties": false
             }
           ],
           "description": "Protocol info result"

package/dist/schemas/wowok_buildin_info.schema.json

@@ -479,6 +479,20 @@
           ],
           "additionalProperties": false,
           "description": "Value types query - returns all supported value types with their numeric and string representations"
+        },
+        {
+          "type": "object",
+          "properties": {
+            "info": {
+              "type": "string",
+              "const": "mainnet bridge tokens"
+            }
+          },
+          "required": [
+            "info"
+          ],
+          "additionalProperties": false,
+          "description": "Mainnet Bridge tokens query - returns all tokens deployed on the mainnet bridge with their symbol, WOW-side type tag, EVM address, decimals, and description"
         }
       ],
       "description": "WoWok Build-in infomation query"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wowok/agent-mcp",
-  "version": "2.3.10",
+  "version": "2.3.12",
   "description": "Making It Easy for AI Agents to Communicate, Collaborate, Trade, and Trust.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -36,7 +36,7 @@
   "license": "Apache-2.0",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
-    "@wowok/wowok": "2.3.10",
+    "@wowok/wowok": "2.3.12",
     "lodash": "^4.18.1",
     "zod": "^3.25.76"
   },