bsv-mcp 0.0.32 → 0.0.33

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # BSV MCP Server Changelog
 
+## v0.0.33 - Identity Key Sigma Signing
+
+### Features
+- Added optional `IDENTITY_KEY_WIF` environment variable for sigma-protocol signing.
+- `wallet_a2bPublishMcp`, `wallet_createOrdinals`, and `wallet_purchaseListing` tools now support signing with an identity key.
+- Updated `README.md` to document `IDENTITY_KEY_WIF` usage and JSON configuration examples.
+
 ## v0.0.32 - Reliability Improvements
 
 ### Bug Fixes

package/README.md

@@ -18,8 +18,7 @@ This project is built using [Bun](https://bun.sh/), a fast JavaScript runtime an
 
 **macOS (using Homebrew):**
 ```bash
-brew tap oven-sh/bun
-brew install bun
+brew install oven-sh/bun/bun
 ```
 
 **macOS/Linux/WSL (using installer script):**
@@ -38,7 +37,7 @@ This server implements the [Model Context Protocol](https://modelcontextprotocol
 
 ![MCP Configuration Example](docs/images/mcp-config-example.png)
 
-> **Note:** The PRIVATE_KEY_WIF environment variable is now optional. Without it, the server runs in limited mode with educational resources and non-wallet tools available. Wallet and MNEE token operations require a valid private key.
+> **Note:** The `PRIVATE_KEY_WIF` environment variable is now optional. Without it, the server runs in limited mode with educational resources and non-wallet tools available. Wallet and MNEE token operations require a valid private key. You can also set the `IDENTITY_KEY_WIF` environment variable to enable sigma-protocol signing of ordinals inscriptions for authentication, curation, and web-of-trust.
 
 ### Cursor
 
@@ -58,14 +57,15 @@ To use the BSV MCP server with [Cursor](https://cursor.sh/):
         "bsv-mcp@latest"
       ],
       "env": {
-        "PRIVATE_KEY_WIF": "<your_private_key_wif>"
+        "PRIVATE_KEY_WIF": "<your_private_key_wif>",
+        "IDENTITY_KEY_WIF": "<your_identity_key_wif>"
       }
     }
   }
 }
 ```
 
-5. Replace `<your_private_key_wif>` with your actual private key WIF (keep this secure!) If you dont have one you can leave this off for now but you wont be able to use tools that require a wallet.
+5. Replace `<your_private_key_wif>` with your actual private key WIF (keep this secure!) If you dont have one you can leave this off for now but you wont be able to use tools that require a wallet. `<your_identity_key_wif>` is also optional. It will sign 1Sat Ordinals with Sigma protocol using the provided identity key.
 
 6. Click "Save"
 
@@ -84,7 +84,8 @@ If you prefer to use npm instead of Bun:
         "bsv-mcp@latest"
       ],
       "env": {
-        "PRIVATE_KEY_WIF": "<your_private_key_wif>"
+        "PRIVATE_KEY_WIF": "<your_private_key_wif>",
+        "IDENTITY_KEY_WIF": "<your_identity_key_wif>"
       }
     }
   }
@@ -118,7 +119,8 @@ Open the Claude configuration json file in your favorite text editor. If you pre
            "run", "bsv-mcp@latest"
          ],
          "env": {
-           "PRIVATE_KEY_WIF": "<your_private_key_wif>"
+           "PRIVATE_KEY_WIF": "<your_private_key_wif>",
+           "IDENTITY_KEY_WIF": "<your_identity_key_wif>"
          }
        }
      }
@@ -362,6 +364,7 @@ The BSV MCP server can be customized using environment variables to enable or di
 | `DISABLE_BSV_TOOLS` | `false` | Set to `true` to disable BSV blockchain tools |
 | `DISABLE_ORDINALS_TOOLS` | `false` | Set to `true` to disable Ordinals/NFT tools |
 | `DISABLE_UTILS_TOOLS` | `false` | Set to `true` to disable utility tools |
+| `IDENTITY_KEY_WIF`    | `not set` | Optional WIF for identity key; if set, ordinals inscriptions will be signed with sigma-protocol for authentication, curation, and web-of-trust. |
 
 ### Examples
 

package/index.ts

@@ -70,7 +70,7 @@ function initializePrivateKey(): PrivateKey | undefined {
 const privKey = initializePrivateKey();
 
 const server = new McpServer(
-	{ name: "Bitcoin SV", version: "0.0.32" },
+	{ name: "Bitcoin SV", version: "0.0.33" },
 	// {
 	// 	// Advertise only what you actually implement
 	// 	capabilities: {

package/package.json

@@ -2,7 +2,7 @@
 	"name": "bsv-mcp",
 	"module": "index.ts",
 	"type": "module",
-	"version": "0.0.32",
+	"version": "0.0.33",
 	"license": "MIT",
 	"author": "satchmo",
 	"description": "A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework",
@@ -52,6 +52,7 @@
 		"js-1sat-ord": "^0.1.81",
 		"mnee": "^2.0.0",
 		"satoshi-token": "^0.0.4",
+		"sigma-protocol": "^0.1.6",
 		"zod": "^3.24.3"
 	},
 	"scripts": {

package/smithery.yaml

@@ -5,17 +5,74 @@ startCommand:
   type: stdio
   configSchema:
     type: object
-    required:
-      - privateKeyWif
     properties:
       privateKeyWif:
         type: string
-        description: "The private key WIF (Wallet Import Format) for Bitcoin SV transactions. This key is used to sign transactions and is required for wallet operations."
+        title: "Private Key (WIF)"
+        description: "The private key WIF (Wallet Import Format) for Bitcoin SV transactions. Optional but required for wallet operations. Without this, the server runs in limited mode with only educational resources and non-wallet tools."
+      disablePrompts:
+        type: boolean
+        title: "Disable Prompts"
+        description: "Set to true to disable all educational prompts"
+        default: false
+      disableResources:
+        type: boolean
+        title: "Disable Resources"
+        description: "Set to true to disable all resources (BRCs, changelog)"
+        default: false
+      disableTools:
+        type: boolean
+        title: "Disable All Tools"
+        description: "Set to true to disable all tools"
+        default: false
+      disableWalletTools:
+        type: boolean
+        title: "Disable Wallet Tools"
+        description: "Set to true to disable Bitcoin wallet tools"
+        default: false
+      disableMneeTools:
+        type: boolean
+        title: "Disable MNEE Tools"
+        description: "Set to true to disable MNEE token tools"
+        default: false
+      disableBsvTools:
+        type: boolean
+        title: "Disable BSV Blockchain Tools"
+        description: "Set to true to disable BSV blockchain tools"
+        default: false
+      disableOrdinalsTools:
+        type: boolean
+        title: "Disable Ordinals Tools"
+        description: "Set to true to disable Ordinals/NFT tools"
+        default: false
+      disableUtilsTools:
+        type: boolean
+        title: "Disable Utility Tools"
+        description: "Set to true to disable utility tools"
+        default: false
+    additionalProperties: false
   commandFunction: |
-    (config) => ({ 
-      command: 'bun', 
-      args: ['run', 'index.ts'], 
-      env: { 
-        PRIVATE_KEY_WIF: config.privateKeyWif 
-      } 
-    })
+    (config) => {
+      const env = {};
+      
+      // Add private key if provided
+      if (config.privateKeyWif) {
+        env.PRIVATE_KEY_WIF = config.privateKeyWif;
+      }
+      
+      // Map boolean config options to environment variables
+      if (config.disablePrompts) env.DISABLE_PROMPTS = 'true';
+      if (config.disableResources) env.DISABLE_RESOURCES = 'true';
+      if (config.disableTools) env.DISABLE_TOOLS = 'true';
+      if (config.disableWalletTools) env.DISABLE_WALLET_TOOLS = 'true';
+      if (config.disableMneeTools) env.DISABLE_MNEE_TOOLS = 'true';
+      if (config.disableBsvTools) env.DISABLE_BSV_TOOLS = 'true';
+      if (config.disableOrdinalsTools) env.DISABLE_ORDINALS_TOOLS = 'true';
+      if (config.disableUtilsTools) env.DISABLE_UTILS_TOOLS = 'true';
+      
+      return { 
+        command: 'bun', 
+        args: ['run', 'index.ts'],
+        env
+      };
+    }

package/tools/wallet/a2bPublishMcp.ts

@@ -1,4 +1,4 @@
-import { Utils } from "@bsv/sdk";
+import { PrivateKey, Utils } from "@bsv/sdk";
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
 import type {
@@ -12,6 +12,7 @@ import type {
 	Inscription,
 	PreMAP,
 } from "js-1sat-ord";
+import { Sigma } from "sigma-protocol";
 import { z } from "zod";
 import type { Wallet } from "./wallet";
 const { toArray, toBase64 } = Utils;
@@ -56,6 +57,20 @@ export function registerA2bPublishMcpTool(server: McpServer, wallet: Wallet) {
 			extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
 		) => {
 			try {
+				// Load optional identity key for sigma signing
+				const identityKeyWif = process.env.IDENTITY_KEY_WIF;
+				let identityPk: PrivateKey | undefined;
+				if (identityKeyWif) {
+					try {
+						identityPk = PrivateKey.fromWif(identityKeyWif);
+					} catch (e) {
+						console.warn(
+							"Warning: Invalid IDENTITY_KEY_WIF environment variable; sigma signing disabled",
+							e,
+						);
+					}
+				}
+
 				const paymentPk = wallet.getPrivateKey();
 				if (!paymentPk) throw new Error("No private key available");
 
@@ -77,10 +92,13 @@ export function registerA2bPublishMcpTool(server: McpServer, wallet: Wallet) {
 
 				// Prepare the full configuration with metadata
 				const fullConfig = {
-					name: args.toolName,
-					description: args.description || `MCP Tool: ${args.toolName}`,
-					config: toolConfig,
-					type: "mcp-tool",
+					mcpServers: {
+						[args.toolName]: {
+							description: args.description || `MCP Tool: ${args.toolName}`,
+							type: "mcp-tool",
+							...toolConfig,
+						},
+					},
 				};
 
 				const fileContent = JSON.stringify(fullConfig, null, 2);
@@ -112,8 +130,14 @@ export function registerA2bPublishMcpTool(server: McpServer, wallet: Wallet) {
 
 				const changeResult = result as ChangeResult;
 
+				let finalTx = changeResult.tx;
+				if (identityPk) {
+					const sigma = new Sigma(result.tx);
+					const signResponse = sigma.sign(identityPk);
+					finalTx = signResponse.signedTx;
+				}
 				// Broadcast the transaction
-				await changeResult.tx.broadcast();
+				await finalTx.broadcast();
 
 				// Refresh UTXOs after spending
 				try {

package/tools/wallet/createOrdinals.ts

@@ -1,6 +1,11 @@
+import { PrivateKey } from "@bsv/sdk";
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
-import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type {
+	CallToolResult,
+	ServerNotification,
+	ServerRequest,
+} from "@modelcontextprotocol/sdk/types.js";
 import { createOrdinals } from "js-1sat-ord";
 import type {
 	ChangeResult,
@@ -10,6 +15,7 @@ import type {
 	Inscription,
 	PreMAP,
 } from "js-1sat-ord";
+import { Sigma } from "sigma-protocol";
 import { z } from "zod";
 import type { Wallet } from "./wallet";
 
@@ -47,9 +53,23 @@ export function registerCreateOrdinalsTool(server: McpServer, wallet: Wallet) {
 		{ args: createOrdinalsArgsSchema },
 		async (
 			{ args }: { args: CreateOrdinalsArgs },
-			extra: RequestHandlerExtra,
+			extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
 		): Promise<CallToolResult> => {
 			try {
+				// Load optional identity key for sigma signing
+				const identityKeyWif = process.env.IDENTITY_KEY_WIF;
+				let identityPk: PrivateKey | undefined;
+				if (identityKeyWif) {
+					try {
+						identityPk = PrivateKey.fromWif(identityKeyWif);
+					} catch (e) {
+						console.warn(
+							"Warning: Invalid IDENTITY_KEY_WIF environment variable; sigma signing disabled",
+							e,
+						);
+					}
+				}
+
 				// 1. Get private key from wallet
 				const paymentPk = wallet.getPrivateKey();
 				if (!paymentPk) {
@@ -95,8 +115,14 @@ export function registerCreateOrdinalsTool(server: McpServer, wallet: Wallet) {
 
 				const changeResult = result as ChangeResult;
 
-				// 7. Broadcast the transaction
-				await changeResult.tx.broadcast();
+				// 7. Optionally sign with identity key and broadcast the transaction
+				let finalTx = changeResult.tx;
+				if (identityPk) {
+					const sigma = new Sigma(changeResult.tx);
+					const signResponse = sigma.sign(identityPk);
+					finalTx = signResponse.signedTx;
+				}
+				await finalTx.broadcast();
 
 				// 8. Refresh the wallet's UTXOs after spending
 				try {

package/tools/wallet/purchaseListing.ts

@@ -1,6 +1,10 @@
-// import { PrivateKey } from "@bsv/sdk"; // not used here
+import { PrivateKey } from "@bsv/sdk";
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import type {
+	ServerNotification,
+	ServerRequest,
+} from "@modelcontextprotocol/sdk/types.js";
 import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
 import {
 	type ChangeResult,
@@ -14,6 +18,7 @@ import {
 	purchaseOrdListing,
 	purchaseOrdTokenListing,
 } from "js-1sat-ord";
+import { Sigma } from "sigma-protocol";
 import type { z } from "zod";
 import {
 	MARKET_FEE_PERCENTAGE,
@@ -82,9 +87,23 @@ export function registerPurchaseListingTool(server: McpServer, wallet: Wallet) {
 		{ args: purchaseListingArgsSchema },
 		async (
 			{ args }: { args: z.infer<typeof purchaseListingArgsSchema> },
-			extra: RequestHandlerExtra,
+			extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
 		): Promise<CallToolResult> => {
 			try {
+				// Load optional identity key for sigma signing
+				const identityKeyWif = process.env.IDENTITY_KEY_WIF;
+				let identityPk: PrivateKey | undefined;
+				if (identityKeyWif) {
+					try {
+						identityPk = PrivateKey.fromWif(identityKeyWif);
+					} catch (e) {
+						console.warn(
+							"Warning: Invalid IDENTITY_KEY_WIF environment variable; sigma signing disabled",
+							e,
+						);
+					}
+				}
+
 				// Fetch the listing info directly from the API
 				const response = await fetch(
 					`https://ordinals.gorillapool.io/api/txos/${args.listingOutpoint}?script=true`,
@@ -252,10 +271,14 @@ Please fund this wallet address with enough BSV to cover the purchase price
 					// Remove console.warn
 				}
 
-				// Broadcast the transaction
-				const broadcastResult = await transaction.tx.broadcast(
-					oneSatBroadcaster(),
-				);
+				// Optionally sign with identity key then broadcast the transaction
+				let finalTx = transaction.tx;
+				if (identityPk) {
+					const sigma = new Sigma(finalTx);
+					const signResponse = sigma.sign(identityPk);
+					finalTx = signResponse.signedTx;
+				}
+				const broadcastResult = await finalTx.broadcast(oneSatBroadcaster());
 
 				// Handle broadcast response
 				const resultStatus =

package/tools/wallet/sendOrdinals.ts

@@ -1,6 +1,11 @@
+import { PrivateKey } from "@bsv/sdk";
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import type { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
-import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type {
+	CallToolResult,
+	ServerNotification,
+	ServerRequest,
+} from "@modelcontextprotocol/sdk/types.js";
 import { sendOrdinals } from "js-1sat-ord";
 import type { ChangeResult, SendOrdinalsConfig } from "js-1sat-ord";
 import { z } from "zod";
@@ -37,7 +42,7 @@ export function registerSendOrdinalsTool(server: McpServer, wallet: Wallet) {
 		{ args: sendOrdinalsArgsSchema },
 		async (
 			{ args }: { args: SendOrdinalsArgs },
-			extra: RequestHandlerExtra,
+			extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
 		): Promise<CallToolResult> => {
 			try {
 				// 1. Get private key from wallet
@@ -86,6 +91,18 @@ export function registerSendOrdinalsTool(server: McpServer, wallet: Wallet) {
 					changeAddress: walletAddress,
 				};
 
+				const identityKeyWif = process.env.IDENTITY_KEY_WIF;
+				let identityPk: PrivateKey | undefined;
+				if (identityKeyWif) {
+					try {
+						identityPk = PrivateKey.fromWif(identityKeyWif);
+					} catch (e) {
+						console.warn(
+							"Warning: Invalid IDENTITY_KEY_WIF environment variable; sigma signing disabled",
+							e,
+						);
+					}
+				}
 				// Add metadata if provided
 				if (args.metadata) {
 					sendOrdinalsConfig.metaData = args.metadata;

package/tools/wallet/tools.ts

@@ -133,7 +133,7 @@ export function registerWalletTools(
 	// registerA2bPublishAgentTool(server, wallet);
 
 	// Register the wallet_a2bPublishMcp tool
-	// registerA2bPublishMcpTool(server, wallet);
+	registerA2bPublishMcpTool(server, wallet);
 
 	// Register only the minimal public-facing tools
 	// wallet_createAction, wallet_signAction and wallet_getHeight have been removed