bsv-mcp 0.2.7 → 0.2.9

package/dist/index.js

@@ -86255,7 +86255,7 @@ var package_default = {
   name: "bsv-mcp",
   module: "dist/index.js",
   type: "module",
-  version: "0.2.7",
+  version: "0.2.8",
   license: "MIT",
   author: "satchmo",
   description: "A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework",
@@ -86276,6 +86276,7 @@ var package_default = {
   ],
   files: [
     "dist/**/*.js",
+    "dist/**/*.html",
     "package.json",
     "*.ts",
     "tools/*.ts",
@@ -90657,7 +90658,7 @@ var createPostArgsSchema = exports_external.object({
   content: exports_external.string().describe("The content of the post"),
   contentType: exports_external.enum(["text/plain", "text/markdown"]).default("text/plain").describe("Content type of the post"),
   app: exports_external.string().default("bsv-mcp").describe("Application name creating the post"),
-  additionalMapData: exports_external.record(exports_external.string()).optional().describe("Additional MAP protocol key-value pairs")
+  additionalMapData: exports_external.string().optional().describe(`Additional MAP protocol key-value pairs as a JSON object string, e.g. '{"key": "value"}'`)
 });
 async function createSocialPost(args, wallet3) {
   try {
@@ -90688,7 +90689,8 @@ async function createSocialPost(args, wallet3) {
       toArray8("post", "utf8")
     ];
     if (additionalMapData) {
-      for (const [key, value] of Object.entries(additionalMapData)) {
+      const parsedMapData = JSON.parse(additionalMapData);
+      for (const [key, value] of Object.entries(parsedMapData)) {
         mapData.push(toArray8(key, "utf8"), toArray8(value, "utf8"));
       }
     }
@@ -123699,7 +123701,7 @@ var package_default2 = {
   name: "bsv-mcp",
   module: "dist/index.js",
   type: "module",
-  version: "0.2.7",
+  version: "0.2.8",
   license: "MIT",
   author: "satchmo",
   description: "A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework",
@@ -123720,6 +123722,7 @@ var package_default2 = {
   ],
   files: [
     "dist/**/*.js",
+    "dist/**/*.html",
     "package.json",
     "*.ts",
     "tools/*.ts",
@@ -124432,7 +124435,7 @@ var mintCollectionArgsSchema = exports_external.object({
     label: exports_external.string(),
     percentage: exports_external.number().min(0).max(100)
   })).optional().describe("Rarity labels and their percentages"),
-  traits: exports_external.record(exports_external.array(exports_external.string())).optional().describe("Collection traits as key-value pairs where values are arrays of possible trait values"),
+  traits: exports_external.string().optional().describe(`Collection traits as JSON string of key-value pairs where values are arrays, e.g. '{"Background": ["Blue", "Red"], "Eyes": ["Big", "Small"]}'`),
   skipBroadcast: exports_external.boolean().optional().describe("Skip broadcasting transactions (for testing)")
 });
 async function getImageFiles(folderPath) {
@@ -124481,8 +124484,9 @@ function generateItemTraits(itemIndex, collectionTraits) {
   return traits;
 }
 function registerMintCollectionTool(server, wallet4) {
-  server.tool("wallet_mintCollection", "Mint a collection of ordinals from a folder of images with proper metadata. This tool creates a collection inscription first, then mints each image as a collection item with the appropriate metadata linking it to the collection.", { ...mintCollectionArgsSchema.shape }, async ({ folderPath, collectionName, description, rarityLabels, traits, skipBroadcast }) => {
+  server.tool("wallet_mintCollection", "Mint a collection of ordinals from a folder of images with proper metadata. This tool creates a collection inscription first, then mints each image as a collection item with the appropriate metadata linking it to the collection.", { ...mintCollectionArgsSchema.shape }, async ({ folderPath, collectionName, description, rarityLabels, traits: traitsJson, skipBroadcast }) => {
     try {
+      const traits = traitsJson ? JSON.parse(traitsJson) : undefined;
       const paymentPk = wallet4.getPaymentKey();
       if (!paymentPk) {
         throw new Error("No payment key available in wallet");
@@ -127609,7 +127613,8 @@ function registerMcpAppTools(server2, wallet4) {
   }, async () => {
     return {
       content: [{ type: "text", text: "BSV Dashboard opened" }],
-      structuredContent: { view: "dashboard", ready: true }
+      structuredContent: { view: "dashboard", ready: true },
+      _meta: { viewUUID: crypto.randomUUID() }
     };
   });
   ID(server2, "app_explorer_data", {
@@ -127664,7 +127669,8 @@ function registerMcpAppTools(server2, wallet4) {
                 height: jbData.block_height
               } : null
             }
-          }
+          },
+          _meta: { viewUUID: crypto.randomUUID() }
         };
       } catch (err) {
         return {
@@ -127674,7 +127680,8 @@ function registerMcpAppTools(server2, wallet4) {
               text: `Error: ${err instanceof Error ? err.message : String(err)}`
             }
           ],
-          structuredContent: { error: String(err) }
+          structuredContent: { error: String(err) },
+          _meta: { viewUUID: crypto.randomUUID() }
         };
       }
     }
@@ -127692,7 +127699,8 @@ function registerMcpAppTools(server2, wallet4) {
           ],
           structuredContent: {
             addressInfo: { balance, history }
-          }
+          },
+          _meta: { viewUUID: crypto.randomUUID() }
         };
       } catch (err) {
         return {
@@ -127702,7 +127710,8 @@ function registerMcpAppTools(server2, wallet4) {
               text: `Error: ${err instanceof Error ? err.message : String(err)}`
             }
           ],
-          structuredContent: { error: String(err) }
+          structuredContent: { error: String(err) },
+          _meta: { viewUUID: crypto.randomUUID() }
         };
       }
     }
@@ -127719,7 +127728,8 @@ function registerMcpAppTools(server2, wallet4) {
             text: `BSV price: $${price.toFixed(2)}`
           }
         ],
-        structuredContent: { price, chainInfo }
+        structuredContent: { price, chainInfo },
+        _meta: { viewUUID: crypto.randomUUID() }
       };
     } catch (err) {
       return {
@@ -127729,7 +127739,8 @@ function registerMcpAppTools(server2, wallet4) {
             text: `Error: ${err instanceof Error ? err.message : String(err)}`
           }
         ],
-        structuredContent: { error: String(err) }
+        structuredContent: { error: String(err) },
+        _meta: { viewUUID: crypto.randomUUID() }
       };
     }
   });
@@ -127751,7 +127762,8 @@ function registerMcpAppTools(server2, wallet4) {
         ],
         structuredContent: {
           error: "No wallet configured. Set PRIVATE_KEY_WIF or generate keys."
-        }
+        },
+        _meta: { viewUUID: crypto.randomUUID() }
       };
     }
     try {
@@ -127787,7 +127799,8 @@ function registerMcpAppTools(server2, wallet4) {
             satoshis: u.satoshis
           })),
           price
-        }
+        },
+        _meta: { viewUUID: crypto.randomUUID() }
       };
     } catch (err) {
       return {
@@ -127797,7 +127810,8 @@ function registerMcpAppTools(server2, wallet4) {
             text: `Error: ${err instanceof Error ? err.message : String(err)}`
           }
         ],
-        structuredContent: { error: String(err) }
+        structuredContent: { error: String(err) },
+        _meta: { viewUUID: crypto.randomUUID() }
       };
     }
   });
@@ -127833,7 +127847,8 @@ function registerMcpAppTools(server2, wallet4) {
           structuredContent: {
             results: data2.results || [],
             total: data2.total || 0
-          }
+          },
+          _meta: { viewUUID: crypto.randomUUID() }
         };
       }
       const res = await fetch("https://ordinals.gorillapool.io/api/market?limit=20&offset=0&sort=recent&dir=desc");
@@ -127847,7 +127862,8 @@ function registerMcpAppTools(server2, wallet4) {
         structuredContent: {
           listings: data.results || [],
           total: data.total || 0
-        }
+        },
+        _meta: { viewUUID: crypto.randomUUID() }
       };
     } catch (err) {
       return {
@@ -127857,12 +127873,13 @@ function registerMcpAppTools(server2, wallet4) {
             text: `Error: ${err instanceof Error ? err.message : String(err)}`
           }
         ],
-        structuredContent: { error: String(err) }
+        structuredContent: { error: String(err) },
+        _meta: { viewUUID: crypto.randomUUID() }
       };
     }
   });
   cD(server2, "BSV Dashboard", APP_RESOURCE_URI, { description: "Interactive BSV dashboard with Explorer, Wallet, and Ordinals tabs" }, async () => {
-    const distPath = join2(__appDirname, "dist", "app.html");
+    const distPath = __appDirname.endsWith("dist") ? join2(__appDirname, "app.html") : join2(__appDirname, "dist", "app.html");
     let html;
     try {
       html = await readFile(distPath, "utf-8");

package/index.ts

@@ -256,6 +256,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 			return {
 				content: [{ type: "text" as const, text: "BSV Dashboard opened" }],
 				structuredContent: { view: "dashboard", ready: true },
+				_meta: { viewUUID: crypto.randomUUID() },
 			};
 		},
 	);
@@ -335,6 +336,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 									: null,
 							},
 						},
+						_meta: { viewUUID: crypto.randomUUID() },
 					};
 				} catch (err) {
 					return {
@@ -345,6 +347,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 							},
 						],
 						structuredContent: { error: String(err) },
+						_meta: { viewUUID: crypto.randomUUID() },
 					};
 				}
 			}
@@ -374,6 +377,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 						structuredContent: {
 							addressInfo: { balance, history },
 						},
+						_meta: { viewUUID: crypto.randomUUID() },
 					};
 				} catch (err) {
 					return {
@@ -384,6 +388,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 							},
 						],
 						structuredContent: { error: String(err) },
+						_meta: { viewUUID: crypto.randomUUID() },
 					};
 				}
 			}
@@ -406,6 +411,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 						},
 					],
 					structuredContent: { price, chainInfo },
+					_meta: { viewUUID: crypto.randomUUID() },
 				};
 			} catch (err) {
 				return {
@@ -416,6 +422,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 						},
 					],
 					structuredContent: { error: String(err) },
+					_meta: { viewUUID: crypto.randomUUID() },
 				};
 			}
 		},
@@ -445,6 +452,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 					structuredContent: {
 						error: "No wallet configured. Set PRIVATE_KEY_WIF or generate keys.",
 					},
+					_meta: { viewUUID: crypto.randomUUID() },
 				};
 			}
 
@@ -487,6 +495,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 						})),
 						price,
 					},
+					_meta: { viewUUID: crypto.randomUUID() },
 				};
 			} catch (err) {
 				return {
@@ -497,6 +506,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 						},
 					],
 					structuredContent: { error: String(err) },
+					_meta: { viewUUID: crypto.randomUUID() },
 				};
 			}
 		},
@@ -546,6 +556,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 							results: data.results || [],
 							total: data.total || 0,
 						},
+						_meta: { viewUUID: crypto.randomUUID() },
 					};
 				}
 
@@ -564,6 +575,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 						listings: data.results || [],
 						total: data.total || 0,
 					},
+					_meta: { viewUUID: crypto.randomUUID() },
 				};
 			} catch (err) {
 				return {
@@ -574,6 +586,7 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 						},
 					],
 					structuredContent: { error: String(err) },
+					_meta: { viewUUID: crypto.randomUUID() },
 				};
 			}
 		},
@@ -586,7 +599,11 @@ function registerMcpAppTools(server: McpServer, wallet?: Wallet) {
 		APP_RESOURCE_URI,
 		{ description: "Interactive BSV dashboard with Explorer, Wallet, and Ordinals tabs" },
 		async () => {
-			const distPath = join(__appDirname, "dist", "app.html");
+			// When running from bundle (dist/index.js), app.html is a sibling.
+			// When running from source (index.ts), it's in dist/.
+			const distPath = __appDirname.endsWith("dist")
+				? join(__appDirname, "app.html")
+				: join(__appDirname, "dist", "app.html");
 			let html: string;
 			try {
 				html = await readFile(distPath, "utf-8");

package/package.json

@@ -2,7 +2,7 @@
 	"name": "bsv-mcp",
 	"module": "dist/index.js",
 	"type": "module",
-	"version": "0.2.7",
+	"version": "0.2.9",
 	"license": "MIT",
 	"author": "satchmo",
 	"description": "A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework",
@@ -23,6 +23,7 @@
 	],
 	"files": [
 		"dist/**/*.js",
+		"dist/**/*.html",
 		"package.json",
 		"*.ts",
 		"tools/*.ts",

package/tools/bsocial/createPost.ts

@@ -25,9 +25,9 @@ const createPostArgsSchema = z.object({
 		.default("bsv-mcp")
 		.describe("Application name creating the post"),
 	additionalMapData: z
-		.record(z.string())
+		.string()
 		.optional()
-		.describe("Additional MAP protocol key-value pairs"),
+		.describe("Additional MAP protocol key-value pairs as a JSON object string, e.g. '{\"key\": \"value\"}'"),
 });
 
 type CreatePostArgs = z.infer<typeof createPostArgsSchema>;
@@ -80,9 +80,10 @@ export async function createSocialPost(
 			toArray("post", "utf8"),
 		];
 
-		// Add any additional MAP data
+		// Add any additional MAP data (parse JSON string if provided)
 		if (additionalMapData) {
-			for (const [key, value] of Object.entries(additionalMapData)) {
+			const parsedMapData: Record<string, string> = JSON.parse(additionalMapData);
+			for (const [key, value] of Object.entries(parsedMapData)) {
 				mapData.push(toArray(key, "utf8"), toArray(value, "utf8"));
 			}
 		}

package/tools/bsv/token.ts

@@ -17,7 +17,7 @@ export function registerTokenTools(server: McpServer): void {
 	server.tool(
 		"bsv_toSatoshi",
 		{
-			bitcoin: z.union([z.number(), z.string()]),
+			bitcoin: z.string().describe("Bitcoin amount (accepts numeric strings like '1.5')"),
 			returnType: z.enum(["number", "string", "bigint"]).optional(),
 		},
 		async ({ bitcoin, returnType }) => {
@@ -46,7 +46,7 @@ export function registerTokenTools(server: McpServer): void {
 	server.tool(
 		"bsv_toBitcoin",
 		{
-			satoshis: z.union([z.number(), z.string(), z.bigint()]),
+			satoshis: z.string().describe("Satoshi amount (accepts numeric strings like '100000000')"),
 			returnType: z.enum(["number", "string", "bigint"]).optional(),
 		},
 		async ({ satoshis, returnType }) => {
@@ -87,7 +87,7 @@ export function registerTokenTools(server: McpServer): void {
 	server.tool(
 		"bsv_toTokenSatoshi",
 		{
-			token: z.union([z.number(), z.string(), z.bigint()]),
+			token: z.string().describe("Token amount (accepts numeric strings like '1.5')"),
 			decimals: z.number().int().min(0),
 			returnType: z.enum(["number", "string", "bigint"]).optional(),
 		},
@@ -117,7 +117,7 @@ export function registerTokenTools(server: McpServer): void {
 	server.tool(
 		"bsv_toToken",
 		{
-			tokenSatoshi: z.union([z.number(), z.string(), z.bigint()]),
+			tokenSatoshi: z.string().describe("Token satoshi amount (accepts numeric strings)"),
 			decimals: z.number().int().min(0),
 			returnType: z.enum(["number", "string", "bigint"]).optional(),
 		},

package/tools/wallet/mintCollection.ts

@@ -35,10 +35,10 @@ const mintCollectionArgsSchema = z.object({
 		.optional()
 		.describe("Rarity labels and their percentages"),
 	traits: z
-		.record(z.array(z.string()))
+		.string()
 		.optional()
 		.describe(
-			"Collection traits as key-value pairs where values are arrays of possible trait values",
+			'Collection traits as JSON string of key-value pairs where values are arrays, e.g. \'{"Background": ["Blue", "Red"], "Eyes": ["Big", "Small"]}\'',
 		),
 	skipBroadcast: z
 		.boolean()
@@ -121,8 +121,10 @@ export function registerMintCollectionTool(server: McpServer, wallet: Wallet) {
 		"wallet_mintCollection",
 		"Mint a collection of ordinals from a folder of images with proper metadata. This tool creates a collection inscription first, then mints each image as a collection item with the appropriate metadata linking it to the collection.",
 		{ ...mintCollectionArgsSchema.shape },
-		async ({ folderPath, collectionName, description, rarityLabels, traits, skipBroadcast }): Promise<CallToolResult> => {
+		async ({ folderPath, collectionName, description, rarityLabels, traits: traitsJson, skipBroadcast }): Promise<CallToolResult> => {
 			try {
+				// Parse traits JSON string if provided
+				const traits: Record<string, string[]> | undefined = traitsJson ? JSON.parse(traitsJson) : undefined;
 				// Get keys from wallet
 				const paymentPk = wallet.getPaymentKey();
 				if (!paymentPk) {