bsv-mcp 0.0.13 → 0.0.15

package/README.md

@@ -266,6 +266,7 @@ The tool supports the following endpoint categories and specific endpoints:
 |----------|-------------|---------------------|------------------|
 | `block_by_hash` | Complete block data via hash | `blockHash` | `{"hash":"000000000000...","confirmations":1000,"size":1000000,...}` |
 | `block_by_height` | Complete block data via height | `blockHeight` | `{"hash":"000000000000...","confirmations":1000,"size":1000000,...}` |
+| `tag_count_by_height` | Stats on tag count for a specific block | `blockHeight` | `{"tags":{"amp":3,"bitkey":5,"metanet":12,"planaria":7,"b":120}}` |
 
 #### Transaction Data
 | Endpoint | Description | Required Parameters | Example Response |
@@ -292,6 +293,7 @@ The `bsv_explore` tool can be used with natural language prompts like:
 ```
 "Get the current Bitcoin SV blockchain information"
 "Show me block #800000 details"
+"Get tag count statistics for block #800000"
 "Fetch transaction history for address 1ExampleBsvAddressXXXXXXXX"
 "Get unspent outputs for my wallet address"
 "Check transaction details for txid a1b2c3d4e5f6..."

package/index.ts

@@ -34,11 +34,10 @@ function validatePrivateKey(): PrivateKey {
 
 // Validate private key early before starting the server
 const privKey = validatePrivateKey();
-console.log("\x1b[32mPrivate key validated successfully\x1b[0m");
 
 const server = new McpServer({
 	name: "Bitcoin SV MCP Server",
-	version: "0.0.13",
+	version: "0.0.15",
 });
 
 // Initialize wallet with the validated private key
@@ -50,10 +49,6 @@ registerWalletTools(server, wallet);
 // Register all other tools (BSV, Ordinals, Utils, etc.)
 registerAllTools(server);
 
-// Debug: Log all registered tools
-console.log("Registered tools:", Object.keys(server));
-console.log("MCP Server ready 🚀");
-
 // Connect to the transport
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/package.json

@@ -2,7 +2,7 @@
 	"name": "bsv-mcp",
 	"module": "index.ts",
 	"type": "module",
-	"version": "0.0.13",
+	"version": "0.0.15",
 	"license": "MIT",
 	"author": "satchmo",
 	"description": "A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework",

package/tools/bsv/explore.ts

@@ -17,6 +17,7 @@ enum ExploreEndpoint {
   // Block endpoints
   BLOCK_BY_HASH = "block_by_hash",
   BLOCK_BY_HEIGHT = "block_by_height",
+  TAG_COUNT_BY_HEIGHT = "tag_count_by_height",
   
   // Transaction endpoints
   TX_BY_HASH = "tx_by_hash",
@@ -65,7 +66,8 @@ export function registerExploreTool(server: McpServer): void {
     "- peer_info: Connected peer statistics\n\n" +
     "BLOCK DATA:\n" +
     "- block_by_hash: Complete block data via hash (requires blockHash parameter)\n" +
-    "- block_by_height: Complete block data via height (requires blockHeight parameter)\n\n" +
+    "- block_by_height: Complete block data via height (requires blockHeight parameter)\n" +
+    "- tag_count_by_height: Stats on tag count for a specific block via height (requires blockHeight parameter)\n\n" +
     "TRANSACTION DATA:\n" +
     "- tx_by_hash: Detailed transaction data (requires txHash parameter)\n" +
     "- tx_raw: Raw transaction hex data (requires txHash parameter)\n" +
@@ -86,8 +88,8 @@ export function registerExploreTool(server: McpServer): void {
           throw new Error("blockHash is required for block_by_hash endpoint");
         }
         
-        if (params.endpoint === ExploreEndpoint.BLOCK_BY_HEIGHT && params.blockHeight === undefined) {
-          throw new Error("blockHeight is required for block_by_height endpoint");
+        if ((params.endpoint === ExploreEndpoint.BLOCK_BY_HEIGHT || params.endpoint === ExploreEndpoint.TAG_COUNT_BY_HEIGHT) && params.blockHeight === undefined) {
+          throw new Error("blockHeight is required for block_by_height and tag_count_by_height endpoints");
         }
 
         if ([ExploreEndpoint.TX_BY_HASH, ExploreEndpoint.TX_RAW, ExploreEndpoint.TX_RECEIPT].includes(params.endpoint) && !params.txHash) {
@@ -120,6 +122,9 @@ export function registerExploreTool(server: McpServer): void {
           case ExploreEndpoint.BLOCK_BY_HEIGHT:
             apiUrl += `/block/height/${params.blockHeight}`;
             break;
+          case ExploreEndpoint.TAG_COUNT_BY_HEIGHT:
+            apiUrl += `/block/tagcount/height/${params.blockHeight}/stats`;
+            break;
           case ExploreEndpoint.TX_BY_HASH:
             apiUrl += `/tx/hash/${params.txHash}`;
             break;

package/tools/wallet/schemas.ts

@@ -76,14 +76,15 @@ export const walletDecryptArgsSchema = z.object({
 export const walletEncryptionArgsSchema = z.object({
 	mode: z.enum(["encrypt", "decrypt"]).describe("Operation mode: 'encrypt' to encrypt data or 'decrypt' to decrypt data"),
 	data: z.array(z.number()).describe("Data to process: plaintext for encryption or ciphertext for decryption"),
-	protocolID: walletProtocolSchema,
-	keyID: z.string(),
-	privilegedReason: z.string().optional(),
+	protocolID: walletProtocolSchema.describe("Protocol identifier - common values are 'aes' for symmetric encryption or 'ecies' for asymmetric encryption"),
+	keyID: z.string().describe("Key identifier - use 'default' or 'primary' for the default wallet key"),
+	privilegedReason: z.string().optional().describe("Required reason for privileged operations"),
 	counterparty: z
 		.union([z.string(), z.literal("self"), z.literal("anyone")])
-		.optional(),
-	privileged: z.boolean().optional(),
-}).describe("Combined schema for encryption and decryption operations, with a mode parameter to switch between functions");
+		.optional()
+		.describe("Recipient of encryption. Use 'self' for personal encryption, or provide a specific key for a recipient"),
+	privileged: z.boolean().optional().describe("Indicates if operation requires elevated privileges"),
+}).describe("Combined schema for encryption and decryption operations. Use 'mode' to specify the operation type, with required parameters data, protocolID, and keyID.");
 
 // Create HMAC arguments
 export const createHmacArgsSchema = z.object({

package/tools/wallet/tools.ts

@@ -173,7 +173,29 @@ export function registerWalletTools(
 	// Register combined wallet_encryption tool
 	registerTool(
 		"wallet_encryption",
-		"Combined tool for encrypting and decrypting data using the wallet's cryptographic keys. Supports both encryption of plaintext data and decryption of previously encrypted content. Use the 'mode' parameter to switch between operations.",
+		"Combined tool for encrypting and decrypting data using the wallet's cryptographic keys.\n\n" +
+		"PARAMETERS:\n" +
+		"- mode: (required) Either \"encrypt\" to encrypt plaintext or \"decrypt\" to decrypt ciphertext\n" +
+		"- data: (required) Array of byte values to process (plaintext for encryption or ciphertext for decryption)\n" +
+		"- protocolID: (required) Protocol to use (commonly \"aes\" or \"ecies\")\n" +
+		"- keyID: (required) Key identifier (use \"default\" or \"primary\" for default wallet key)\n" +
+		"- counterparty: (optional) Set to \"self\" for personal encryption or specific key for recipient\n" +
+		"- privileged: (optional) Boolean indicating if operation requires elevated privileges\n\n" +
+		"EXAMPLES:\n" +
+		"1. Encrypt data:\n" +
+		"   {\n" +
+		"     \"mode\": \"encrypt\",\n" +
+		"     \"data\": [84, 104, 105, 115, 32, 105, 115, 32, 116, 101, 115, 116],\n" +
+		"     \"protocolID\": \"aes\",\n" +
+		"     \"keyID\": \"default\"\n" +
+		"   }\n\n" +
+		"2. Decrypt previously encrypted data:\n" +
+		"   {\n" +
+		"     \"mode\": \"decrypt\",\n" +
+		"     \"data\": [encrypted bytes from previous response],\n" +
+		"     \"protocolID\": \"aes\",\n" +
+		"     \"keyID\": \"default\"\n" +
+		"   }",
 		{ args: walletEncryptionArgsSchema },
 		async (
 			{ args }: { args: z.infer<typeof walletEncryptionArgsSchema> },

package/tools/wallet/wallet.ts

@@ -94,7 +94,6 @@ export class Wallet extends ProtoWallet implements WalletInterface {
 			this.nftUtxos = nftUtxos;
 			this.lastUtxoFetch = Date.now();
 
-			// console.log(`Fetched ${utxos.length} UTXOs for address ${address}`);
 		} catch (error) {
 			console.error("Error refreshing UTXOs:", error);
 			throw error;