bsv-mcp 0.0.25 → 0.0.27

package/CHANGELOG.md

@@ -0,0 +1,52 @@
+# BSV MCP Server Changelog
+
+## v0.0.27 - Enhanced Server Configuration & Maintenance
+
+### Major Changes
+- **Improved Changelog Management**: Added changelog as a MCP resource so you can just ask what has changed between versions
+  - Simplified maintenance with single source of truth for version history
+  - Automatic updates to MCP resources when changelog is modified
+- **Expanded Component Configuration**: Can now configure which components of the MCP are loaded by setting env vars. See the readme for more information.
+
+### Technical Improvements
+- Removed duplicate changelog content in code
+- Better error handling for resource loading
+- Code cleanup and organization improvements
+
+## v0.0.25 - Improved Error Handling & Optional Private Key
+
+### Major Changes
+- **Optional Private Key**: Server now starts without a PRIVATE_KEY_WIF environment variable
+  - Educational resources and non-wallet tools remain available in limited mode
+  - Wallet and MNEE tools gracefully fail with helpful error messages when no private key is provided
+- **Component Configuration**: Added environment variables to enable/disable specific components
+  - Selectively enable/disable prompts, resources, or tools
+  - Fine-grained control over which tool categories are loaded
+- **MNEE Token Support**: Added dedicated tools for MNEE token operations
+  - Get balance, send tokens, and parse transactions
+- **Enhanced Documentation**: Added detailed prompt examples and improved troubleshooting guidance
+- **Resource Improvements**: Added BRC specifications and other reference materials
+
+### Technical Improvements
+- Improved error handling throughout the codebase
+- Better initialization process for wallet component
+- Standardized error messages across tools
+- Expanded README with installation instructions for different platforms
+- Added npm alternatives to Bun commands
+- Added modular loading with configurable components
+
+## v0.0.24 - Initial Public Release
+
+### Features
+- Bitcoin SV wallet operations (send, receive, manage keys)
+- Ordinals creation and management
+- BSV blockchain interaction (transactions, blocks, addresses)
+- Cryptographic operations (signing, verification, encryption)
+- Educational prompts for BSV SDK and Ordinals
+
+### Toolkit Overview
+- Wallet tools for core BSV operations
+- Ordinals tools for NFT functionality
+- BSV tools for blockchain interaction
+- MNEE token tools
+- Utility tools for data conversion 

package/README.md

@@ -38,6 +38,8 @@ 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.
+
 ### Cursor
 
 To use the BSV MCP server with [Cursor](https://cursor.sh/):
@@ -110,9 +112,9 @@ Open the Claude configuration json file in your favorite text editor. If you pre
    {
      "mcpServers": {
        "Bitcoin SV": {
-         "command": "bunx",
+         "command": "bun",
          "args": [
-           "bsv-mcp@latest"
+           "run", "bsv-mcp@latest"
          ],
          "env": {
            "PRIVATE_KEY_WIF": "<your_private_key_wif>"
@@ -282,6 +284,11 @@ A collection of prompts providing detailed information about the Bitcoin SV SDK:
 
 The server also provides access to Bitcoin Request for Comments (BRC) specifications and documentation:
 
+#### Changelog Resource
+- **Identifier**: `bsv-mcp-changelog`
+- **Description**: Version history and changelog for the BSV MCP server.
+- **Usage**: "Show me the BSV MCP changelog" or "What's new in the latest version?"
+
 #### BRC Resources
 - **BRCs Overview**
   - **Identifier**: `brcs_readme`
@@ -333,6 +340,49 @@ When you interact with an MCP-enabled AI assistant:
 4. The results are returned to the AI assistant
 5. The assistant presents the information in a natural, conversational way
 
+## Customization Options
+
+The BSV MCP server can be customized using environment variables to enable or disable specific components:
+
+### Component Configuration
+
+| Environment Variable | Default | Description |
+| -------------------- | ------- | ----------- |
+| `DISABLE_PROMPTS` | `false` | Set to `true` to disable all educational prompts |
+| `DISABLE_RESOURCES` | `false` | Set to `true` to disable all resources (BRCs, changelog) |
+| `DISABLE_TOOLS` | `false` | Set to `true` to disable all tools |
+
+### Tool-Specific Configuration
+
+| Environment Variable | Default | Description |
+| -------------------- | ------- | ----------- |
+| `DISABLE_WALLET_TOOLS` | `false` | Set to `true` to disable Bitcoin wallet tools |
+| `DISABLE_MNEE_TOOLS` | `false` | Set to `true` to disable MNEE token tools |
+| `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 |
+| `DISABLE_A2B_TOOLS` | `false` | Set to `true` to disable agent-to-blockchain tools |
+
+### Examples
+
+Run with only educational resources and prompts, no tools:
+
+```bash
+DISABLE_TOOLS=true bunx bsv-mcp@latest
+```
+
+Run with only BSV tools, no wallet or other functionality:
+
+```bash
+DISABLE_PROMPTS=true DISABLE_RESOURCES=true DISABLE_WALLET_TOOLS=true DISABLE_MNEE_TOOLS=true DISABLE_ORDINALS_TOOLS=true DISABLE_UTILS_TOOLS=true bunx bsv-mcp@latest
+```
+
+Use all tools except wallet operations:
+
+```bash
+DISABLE_WALLET_TOOLS=true bunx bsv-mcp@latest
+```
+
 ## Troubleshooting
 
 If you're having issues with the BSV MCP server:
@@ -392,7 +442,7 @@ The tool supports the following endpoint categories and specific endpoints:
 
 | Endpoint             | Description                                     | Required Parameters | Example Response                                                                      |
 | -------------------- | ----------------------------------------------- | ------------------- | ------------------------------------------------------------------------------------- |
-| `chain_info`         | Network statistics, difficulty, and chain work  | None                | `{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"000000000000..."}` |
+| `chain_info`         | Network statistics, difficulty, and chain work  | None                | `{"chain":"main","blocks":826458,"headers":826458,"bestblockhash":"0000000000..."}` |
 | `chain_tips`         | Current chain tips including heights and states | None                | `[{"height":826458,"hash":"000000000000...","branchlen":0,"status":"active"}]`        |
 | `circulating_supply` | Current BSV circulating supply                  | None                | `{"bsv":21000000}`                                                                    |
 | `peer_info`          | Connected peer statistics                       | None                | `[{"addr":"1.2.3.4:8333","services":"000000000000...","lastsend":1621234567}]`        |

package/index.ts

@@ -5,9 +5,27 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { registerAllPrompts } from "./prompts";
 import { registerResources } from "./resources/resources";
 import { registerAllTools } from "./tools";
+import { registerMneeTools } from "./tools/mnee";
 import { registerWalletTools } from "./tools/wallet/tools";
 import { Wallet } from "./tools/wallet/wallet";
-import { registerMneeTools } from "./tools/mnee";
+
+/**
+ * Configuration options from environment variables
+ */
+const CONFIG = {
+	// Whether to load various components
+	loadPrompts: process.env.DISABLE_PROMPTS !== "true",
+	loadResources: process.env.DISABLE_RESOURCES !== "true",
+	loadTools: process.env.DISABLE_TOOLS !== "true",
+
+	// Fine-grained tool category control
+	loadWalletTools: process.env.DISABLE_WALLET_TOOLS !== "true",
+	loadMneeTools: process.env.DISABLE_MNEE_TOOLS !== "true",
+	loadBsvTools: process.env.DISABLE_BSV_TOOLS !== "true",
+	loadOrdinalsTools: process.env.DISABLE_ORDINALS_TOOLS !== "true",
+	loadUtilsTools: process.env.DISABLE_UTILS_TOOLS !== "true",
+	loadA2bTools: process.env.DISABLE_A2B_TOOLS !== "true",
+};
 
 /**
  * Try to initialize the private key from environment variables
@@ -52,7 +70,7 @@ function initializePrivateKey(): PrivateKey | undefined {
 const privKey = initializePrivateKey();
 
 const server = new McpServer(
-	{ name: "Bitcoin SV", version: "0.0.25" },
+	{ name: "Bitcoin SV", version: "0.0.27" },
 	// {
 	// 	// Advertise only what you actually implement
 	// 	capabilities: {
@@ -71,25 +89,46 @@ const server = new McpServer(
 	// },
 );
 
-// Initialize wallet with the validated private key only if available
+// Initialize wallet and register tools based on configuration
 let wallet: Wallet | null = null;
-if (privKey) {
-  	// Register MNEE tools
-	registerMneeTools(server);
-  // Initialize wallet with the private key
-	wallet = new Wallet(privKey);
-  // Register wallet tools
-  registerWalletTools(server, wallet);
-}
 
-// Register all other tools (BSV, Ordinals, Utils, etc.)
-registerAllTools(server);
+if (CONFIG.loadTools) {
+	if (privKey) {
+		// Register MNEE tools if enabled
+		if (CONFIG.loadMneeTools) {
+			console.log("Registering MNEE tools");
+			registerMneeTools(server);
+		}
 
-// Register resources
-registerResources(server);
+		// Initialize wallet with the private key if wallet tools are enabled
+		if (CONFIG.loadWalletTools) {
+			console.log("Initializing wallet and registering wallet tools");
+			wallet = new Wallet(privKey);
+			registerWalletTools(server, wallet);
+		}
+	}
+
+	// Register all other tools based on configuration
+	console.log("Registering other tools");
+	registerAllTools(server, {
+		enableBsvTools: CONFIG.loadBsvTools,
+		enableOrdinalsTools: CONFIG.loadOrdinalsTools,
+		enableUtilsTools: CONFIG.loadUtilsTools,
+		enableA2bTools: CONFIG.loadA2bTools,
+	});
+}
 
-// Register prompts
-registerAllPrompts(server);
+// Register resources if enabled
+if (CONFIG.loadResources) {
+	console.log("Registering resources");
+	registerResources(server);
+}
+
+// Register prompts if enabled
+if (CONFIG.loadPrompts) {
+	console.log("Registering prompts");
+	registerAllPrompts(server);
+}
 
 // Connect to the transport
 const transport = new StdioServerTransport();

package/package.json

@@ -2,7 +2,7 @@
 	"name": "bsv-mcp",
 	"module": "index.ts",
 	"type": "module",
-	"version": "0.0.25",
+	"version": "0.0.27",
 	"license": "MIT",
 	"author": "satchmo",
 	"description": "A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework",
@@ -25,8 +25,13 @@
 		"*.ts",
 		"tools/*.ts",
 		"tools/**/*.ts",
+		"prompts/*.ts",
+		"prompts/**/*.ts",
+		"resources/*.ts",
+		"resources/**/*.ts",
 		"LICENSE",
 		"README.md",
+		"CHANGELOG.md",
 		"smithery.yaml"
 	],
 	"bin": {
@@ -51,7 +56,6 @@
 	},
 	"scripts": {
 		"lint": "biome check .",
-		"lint:fix": "biome check . --write",
-		"prepare": "chmod +x ./index.ts"
+		"lint:fix": "biome check . --write"
 	}
 }

package/prompts/bsvSdk/auth.ts

@@ -0,0 +1,61 @@
+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";
+
+/**
+ * BSV SDK Authentication Prompt
+ *
+ * Provides detailed information about the authentication functionality in the BSV SDK,
+ * including identity protocols, certificates, and session management.
+ */
+export const BSV_SDK_AUTH_PROMPT = `
+# BSV SDK - Authentication Module
+
+The Authentication module in the BSV SDK provides robust mechanisms for identity management, peer authentication, and certificate handling on the Bitcoin SV blockchain.
+
+## Key Components
+
+This section includes a placeholder for detailed content about the BSV SDK authentication mechanisms.
+
+## Core Features
+
+- Identity management
+- Certificate handling
+- Peer authentication
+- Session management
+
+## Best Practices
+
+1. **Security**: Follow best practices for authentication security
+2. **Testing**: Test authentication flows thoroughly before production use
+3. **Error Handling**: Implement proper error handling
+
+For complete API documentation and additional authentication features, refer to the official BSV SDK documentation.
+`;
+
+/**
+ * Register the BSV SDK Authentication prompt with the MCP server
+ * @param server The MCP server instance
+ */
+export function registerAuthPrompt(server: McpServer): void {
+	server.prompt(
+		"bitcoin_sv_sdk_auth",
+		"Detailed information about the authentication functionality in the BSV SDK, including identity protocols, certificates, and session management.",
+		async (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {
+			return {
+				messages: [
+					{
+						role: "assistant",
+						content: {
+							type: "text",
+							text: BSV_SDK_AUTH_PROMPT,
+						},
+					},
+				],
+			};
+		},
+	);
+}

package/prompts/bsvSdk/cryptography.ts

@@ -0,0 +1,62 @@
+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";
+
+/**
+ * BSV SDK Cryptography Prompt
+ *
+ * Provides detailed information about the cryptographic functionality in the BSV SDK,
+ * including key generation, signing, encryption, and hashing.
+ */
+export const BSV_SDK_CRYPTOGRAPHY_PROMPT = `
+# BSV SDK - Cryptography Module
+
+The Cryptography module in the BSV SDK provides comprehensive tools for handling cryptographic operations required for secure Bitcoin transactions and applications.
+
+## Key Cryptographic Operations
+
+This section includes a placeholder for detailed content about the BSV SDK cryptographic operations.
+
+## Core Features
+
+- Key generation and management
+- Digital signatures (ECDSA)
+- Message signing and verification
+- Encryption and decryption
+- Hash functions (SHA-256, RIPEMD-160, etc.)
+
+## Best Practices
+
+1. **Key Security**: Always handle private keys securely
+2. **Random Number Generation**: Use cryptographically secure random number generation
+3. **Testing**: Verify cryptographic operations with known test vectors
+
+For complete API documentation and additional cryptographic features, refer to the official BSV SDK documentation.
+`;
+
+/**
+ * Register the BSV SDK Cryptography prompt with the MCP server
+ * @param server The MCP server instance
+ */
+export function registerCryptographyPrompt(server: McpServer): void {
+	server.prompt(
+		"bitcoin_sv_sdk_cryptography",
+		"Detailed information about the cryptographic functionality in the BSV SDK, including key generation, signing, encryption, and hashing.",
+		async (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {
+			return {
+				messages: [
+					{
+						role: "assistant",
+						content: {
+							type: "text",
+							text: BSV_SDK_CRYPTOGRAPHY_PROMPT,
+						},
+					},
+				],
+			};
+		},
+	);
+}

package/prompts/bsvSdk/index.ts

@@ -0,0 +1,34 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+import { registerAuthPrompt } from "./auth";
+import { registerCryptographyPrompt } from "./cryptography";
+// Import all prompt registration functions
+import { registerOverviewPrompt } from "./overview";
+import { registerPrimitivesPrompt } from "./primitives";
+import { registerScriptPrompt } from "./script";
+import { registerTransactionPrompt } from "./transaction";
+import { registerWalletPrompt } from "./wallet";
+
+/**
+ * Register all BSV SDK prompts with the MCP server
+ * @param server The MCP server instance
+ */
+export function registerAllBsvSdkPrompts(server: McpServer): void {
+	// Register all BSV SDK related prompts
+	registerOverviewPrompt(server);
+	registerWalletPrompt(server);
+	registerTransactionPrompt(server);
+	registerAuthPrompt(server);
+	registerCryptographyPrompt(server);
+	registerScriptPrompt(server);
+	registerPrimitivesPrompt(server);
+}
+
+// Export all prompts
+export { registerOverviewPrompt } from "./overview";
+export { registerWalletPrompt } from "./wallet";
+export { registerTransactionPrompt } from "./transaction";
+export { registerAuthPrompt } from "./auth";
+export { registerCryptographyPrompt } from "./cryptography";
+export { registerScriptPrompt } from "./script";
+export { registerPrimitivesPrompt } from "./primitives";

package/prompts/bsvSdk/overview.ts

@@ -0,0 +1,105 @@
+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";
+
+/**
+ * BSV SDK Overview Prompt
+ *
+ * Provides a general overview of the Bitcoin SV SDK,
+ * including what it is, its purpose, and its main components.
+ */
+export const BSV_SDK_OVERVIEW_PROMPT = `
+# BSV SDK - Overview
+
+The BSV SDK is a comprehensive TypeScript/JavaScript library designed to provide a unified and modern 
+layer for developing scalable applications on the Bitcoin SV blockchain. This SDK addresses limitations 
+of previous tools by offering a fresh approach that adheres to the principles of SPV (Simplified Payment 
+Verification) while ensuring privacy and scalability.
+
+## Core Objectives
+
+- Provide a unified, modern API for Bitcoin SV development
+- Enable secure, peer-to-peer operations
+- Support SPV (Simplified Payment Verification) principles
+- Ensure privacy and scalability in blockchain applications
+- Simplify integration with the Bitcoin SV ecosystem
+
+## Main Components
+
+The BSV SDK is organized into several key modules:
+
+1. **Wallet**: Manage keys, addresses, and UTXOs
+2. **Transaction**: Build and manipulate Bitcoin transactions
+3. **Auth**: Authentication and identity protocols
+4. **Cryptography**: Signing, encryption, and verification
+5. **Script**: Bitcoin scripting and contract capabilities
+6. **Primitives**: Core data types and structures
+7. **Messages**: Network message handling
+8. **Overlay Tools**: Additional utilities and extensions
+
+## Getting Started
+
+To use the BSV SDK in your project:
+
+\`\`\`bash
+# Install with npm
+npm install @bsv/sdk
+
+# Or with yarn
+yarn add @bsv/sdk
+\`\`\`
+
+Then import the components you need:
+
+\`\`\`typescript
+import { PrivateKey, Transaction } from "@bsv/sdk";
+\`\`\`
+
+## Use Cases
+
+- Wallet applications
+- Payment systems
+- Smart contract platforms
+- Token systems
+- Identity solutions
+- Data storage and verification
+
+## Additional Resources
+
+For detailed information about specific components, please see the dedicated prompts for each module:
+- Wallet operations: Use prompt "bitcoin_sv_sdk_wallet"
+- Transaction building: Use prompt "bitcoin_sv_sdk_transaction"
+- Authentication: Use prompt "bitcoin_sv_sdk_auth"
+- Cryptography: Use prompt "bitcoin_sv_sdk_cryptography"
+- Scripting: Use prompt "bitcoin_sv_sdk_script"
+- Primitives: Use prompt "bitcoin_sv_sdk_primitives"
+
+For official documentation, visit the BSV Blockchain Libraries Project repository.
+`;
+
+/**
+ * Register the BSV SDK Overview prompt with the MCP server
+ * @param server The MCP server instance
+ */
+export function registerOverviewPrompt(server: McpServer): void {
+	server.prompt(
+		"bitcoin_sv_sdk_overview",
+		"General overview of the Bitcoin SV SDK, including its purpose and main components.",
+		async (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {
+			return {
+				messages: [
+					{
+						role: "assistant",
+						content: {
+							type: "text",
+							text: BSV_SDK_OVERVIEW_PROMPT,
+						},
+					},
+				],
+			};
+		},
+	);
+}

package/prompts/bsvSdk/primitives.ts

@@ -0,0 +1,69 @@
+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";
+
+/**
+ * BSV SDK Primitives Prompt
+ *
+ * Provides detailed information about the primitive data types and structures in the BSV SDK,
+ * including Binary, Hex, Points, and other fundamental types.
+ */
+export const BSV_SDK_PRIMITIVES_PROMPT = `
+# BSV SDK - Primitives Module
+
+The Primitives module in the BSV SDK provides fundamental data types and structures that form the building blocks for working with Bitcoin transactions and blockchain data.
+
+## Core Primitive Types
+
+This section includes a placeholder for detailed content about the primitive types available in the BSV SDK.
+
+## Key Primitives
+
+- Binary data handling
+- Hex string conversion
+- Point and curve operations
+- Bitcoin-specific data structures
+- Network message formats
+
+## Common Operations
+
+- Serialization and deserialization
+- Type conversion
+- Data validation
+- Encoding and decoding
+
+## Best Practices
+
+1. **Type Safety**: Use appropriate types for Bitcoin operations
+2. **Validation**: Validate input data before processing
+3. **Performance**: Consider performance implications when working with large data structures
+
+For complete API documentation and additional information about primitives, refer to the official BSV SDK documentation.
+`;
+
+/**
+ * Register the BSV SDK Primitives prompt with the MCP server
+ * @param server The MCP server instance
+ */
+export function registerPrimitivesPrompt(server: McpServer): void {
+	server.prompt(
+		"bitcoin_sv_sdk_primitives",
+		"Detailed information about the primitive data types and structures in the BSV SDK, including Binary, Hex, Points, and other fundamental types.",
+		async (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {
+			return {
+				messages: [
+					{
+						role: "assistant",
+						content: {
+							type: "text",
+							text: BSV_SDK_PRIMITIVES_PROMPT,
+						},
+					},
+				],
+			};
+		},
+	);
+}

package/prompts/bsvSdk/script.ts

@@ -0,0 +1,70 @@
+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";
+
+/**
+ * BSV SDK Script Prompt
+ *
+ * Provides detailed information about the script functionality in the BSV SDK,
+ * including Bitcoin Script operations, locking and unlocking scripts, and OP_CODES.
+ */
+export const BSV_SDK_SCRIPT_PROMPT = `
+# BSV SDK - Script Module
+
+The Script module in the BSV SDK provides comprehensive tools for working with Bitcoin Script, the programming language used to specify conditions for spending Bitcoin.
+
+## Bitcoin Script Basics
+
+This section includes a placeholder for detailed content about Bitcoin Script and its implementation in the BSV SDK.
+
+## Core Features
+
+- Creating and manipulating scripts
+- Locking script (scriptPubKey) creation
+- Unlocking script (scriptSig) creation
+- Script verification and execution
+- Support for all Bitcoin OP_CODES
+
+## Common Script Types
+
+- P2PKH (Pay to Public Key Hash)
+- P2PK (Pay to Public Key)
+- P2MS (Multi-signature)
+- OP_RETURN (Data storage)
+- Custom scripts
+
+## Best Practices
+
+1. **Testing**: Test scripts thoroughly before production use
+2. **Security**: Be aware of potential script vulnerabilities
+3. **Compatibility**: Ensure scripts are compatible with network rules
+
+For complete API documentation and additional script features, refer to the official BSV SDK documentation.
+`;
+
+/**
+ * Register the BSV SDK Script prompt with the MCP server
+ * @param server The MCP server instance
+ */
+export function registerScriptPrompt(server: McpServer): void {
+	server.prompt(
+		"bitcoin_sv_sdk_script",
+		"Detailed information about the script functionality in the BSV SDK, including Bitcoin Script operations, locking and unlocking scripts, and OP_CODES.",
+		async (extra: RequestHandlerExtra<ServerRequest, ServerNotification>) => {
+			return {
+				messages: [
+					{
+						role: "assistant",
+						content: {
+							type: "text",
+							text: BSV_SDK_SCRIPT_PROMPT,
+						},
+					},
+				],
+			};
+		},
+	);
+}