bsv-mcp 0.0.34 → 0.0.36

package/index.ts

@@ -39,18 +39,19 @@ function initializePrivateKey(): PrivateKey | undefined {
 
 	// Check if private key is set
 	if (!privateKeyWif) {
-		console.warn(
-			"\x1b[33mWarning: PRIVATE_KEY_WIF environment variable is not set\x1b[0m",
-		);
-		console.warn(
-			"The server will run, but wallet operations requiring a private key will return errors.",
-		);
-		console.warn(
-			"Set this variable with a valid Bitcoin SV private key in WIF format to enable all features:",
-		);
-		console.warn(
-			"Example: PRIVATE_KEY_WIF=your_private_key_wif bun run index.ts",
-		);
+		// stdio protocol you cant send anything to console!!
+		// console.warn(
+		// 	"\x1b[33mWarning: PRIVATE_KEY_WIF environment variable is not set\x1b[0m",
+		// );
+		// console.warn(
+		// 	"The server will run, but wallet operations requiring a private key will return errors.",
+		// );
+		// console.warn(
+		// 	"Set this variable with a valid Bitcoin SV private key in WIF format to enable all features:",
+		// );
+		// console.warn(
+		// 	"Example: PRIVATE_KEY_WIF=your_private_key_wif bun run index.ts",
+		// );
 		return undefined;
 	}
 
@@ -58,13 +59,13 @@ function initializePrivateKey(): PrivateKey | undefined {
 	try {
 		return PrivateKey.fromWif(privateKeyWif);
 	} catch (error) {
-		console.warn("\x1b[33mWarning: Invalid private key format\x1b[0m");
-		console.warn(
-			"The PRIVATE_KEY_WIF provided is not a valid Bitcoin SV private key in WIF format.",
-		);
-		console.warn(
-			"The server will run, but wallet operations requiring a private key will return errors.",
-		);
+		// console.warn("\x1b[33mWarning: Invalid private key format\x1b[0m");
+		// console.warn(
+		// 	"The PRIVATE_KEY_WIF provided is not a valid Bitcoin SV private key in WIF format.",
+		// );
+		// console.warn(
+		// 	"The server will run, but wallet operations requiring a private key will return errors.",
+		// );
 		return undefined;
 	}
 }
@@ -73,23 +74,18 @@ function initializePrivateKey(): PrivateKey | undefined {
 const privKey = initializePrivateKey();
 
 const server = new McpServer(
-	{ name: "Bitcoin SV", version: "0.0.34" },
-	// {
-	// 	// Advertise only what you actually implement
-	// 	capabilities: {
-	// 		completions: {},
-	// 		experimental: {},
-	// 		logging: {},
-	// 		prompts: {},
-	// 		resources: {},
-	// 		tools: {},
-	// 	},
-	// 	// Optional instructions banner for clients
-	// 	instructions: `
-	// 		This server exposes Bitcoin SV helpers.
-	// 		Tools are idempotent unless marked destructive.
-	// 	`,
-	// },
+	{ name: "Bitcoin SV", version: "0.0.36" },
+	{
+		capabilities: {
+			prompts: {},
+			resources: {},
+			tools: {},
+		},
+		instructions: `
+			This server exposes Bitcoin SV helpers.
+			Tools are idempotent unless marked destructive.
+		`,
+	},
 );
 
 // Initialize wallet and register tools based on configuration
@@ -134,3 +130,4 @@ if (CONFIG.loadPrompts) {
 // Connect to the transport
 const transport = new StdioServerTransport();
 await server.connect(transport);
+console.error("BSV MCP Server running on stdio");

package/package.json

@@ -1,8 +1,8 @@
 {
 	"name": "bsv-mcp",
-	"module": "index.ts",
+	"module": "dist/index.js",
 	"type": "module",
-	"version": "0.0.34",
+	"version": "0.0.36",
 	"license": "MIT",
 	"author": "satchmo",
 	"description": "A collection of Bitcoin SV (BSV) tools for the Model Context Protocol (MCP) framework",
@@ -14,13 +14,15 @@
 		"bitcoin",
 		"bsv",
 		"bitcoin-sv",
-		"mcp",
-		"model-context-protocol",
 		"wallet",
 		"ordinals",
-		"blockchain"
+		"blockchain",
+		"1sat-ordinals",
+		"explorer",
+		"block explorer"
 	],
 	"files": [
+		"dist/**/*.js",
 		"package.json",
 		"*.ts",
 		"tools/*.ts",
@@ -35,7 +37,7 @@
 		"smithery.yaml"
 	],
 	"bin": {
-		"bsv-mcp": "./index.ts"
+		"bsv-mcp": "./dist/index.js"
 	},
 	"private": false,
 	"devDependencies": {
@@ -48,7 +50,8 @@
 	"dependencies": {
 		"@bsv/sdk": "^1.4.20",
 		"@modelcontextprotocol/sdk": "^1.10.2",
-		"@types/node": "^22.14.1",
+		"@types/node": "^22.15.2",
+		"bun": "^1.2.10",
 		"js-1sat-ord": "^0.1.81",
 		"mnee": "^2.0.0",
 		"satoshi-token": "^0.0.4",
@@ -56,6 +59,7 @@
 		"zod": "^3.24.3"
 	},
 	"scripts": {
+		"build": "bun build ./index.ts --outdir ./dist --target node",
 		"lint": "biome check .",
 		"lint:fix": "biome check . --write"
 	}

package/resources/junglebus.ts

@@ -0,0 +1,242 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+
+// Main JungleBus API documentation URL
+const JUNGLEBUS_DOCS_URL = "https://junglebus.gorillapool.io/docs/";
+
+/**
+ * Manually structured JungleBus API documentation
+ * Provides a clean summary of key JungleBus API endpoints and functionality
+ */
+export function getJungleBusDocumentation(): string {
+	return `# JungleBus API Documentation
+
+## Overview
+
+JungleBus is a transaction monitoring service for Bitcoin SV that allows applications to subscribe to transaction events and filter them based on specific criteria. The API provides both subscription and querying capabilities.
+
+## API Endpoints
+
+### Base URL
+\`\`\`
+https://junglebus.gorillapool.io/v1
+\`\`\`
+
+### Transaction API
+
+#### Get Transaction by ID
+\`\`\`
+GET /transaction/get/{txid}
+\`\`\`
+
+Returns detailed information about a specific transaction, including:
+- Transaction data (hex format)
+- Block information (hash, height, time)
+- Input and output details
+- Address information
+
+#### Get Transactions by Block Hash
+\`\`\`
+GET /block/{blockhash}/transactions
+\`\`\`
+
+Returns all transactions within a specific block.
+
+### Subscription API
+
+#### Create Subscription
+\`\`\`
+POST /subscribe
+\`\`\`
+
+Create a new subscription to monitor transactions based on filtering criteria.
+
+Example request body:
+\`\`\`json
+{
+  "callback": "https://your-callback-url.com",
+  "fromBlock": 0,
+  "query": {
+    "find": {
+      "out.tape.cell.s": "BEEF"
+    }
+  }
+}
+\`\`\`
+
+#### Delete Subscription
+\`\`\`
+DELETE /subscribe/{id}
+\`\`\`
+
+Deletes an existing subscription.
+
+### Network API
+
+#### Get Network Info
+\`\`\`
+GET /network/info
+\`\`\`
+
+Returns current blockchain network information, including block height and other statistics.
+
+## Client Implementations
+
+### TypeScript Client
+
+Installation:
+\`\`\`bash
+$ npm install @gorillapool/js-junglebus
+\`\`\`
+
+Usage:
+\`\`\`javascript
+import { JungleBusClient } from '@gorillapool/js-junglebus';
+
+const server = "junglebus.gorillapool.io";
+const jungleBusClient = new JungleBusClient(server, {
+  onConnected(ctx) {
+    // add your own code here
+    console.log(ctx);
+  },
+  onConnecting(ctx) {
+    // add your own code here
+    console.log(ctx);
+  },
+  onDisconnected(ctx) {
+    // add your own code here
+    console.log(ctx);
+  },
+  onError(ctx) {
+    // add your own code here
+    console.error(ctx);
+  }
+});
+
+// create subscriptions in the dashboard of the JungleBus website
+const subId = "...."; // fill in the ID for the subscription
+const fromBlock = 750000;
+
+const subscription = jungleBusClient.Subscribe(
+  subId,
+  fromBlock,
+  onPublish(tx) => {
+    // add your own code here
+    console.log(tx);
+  },
+  onStatus(ctx) => {
+    // add your own code here
+    console.log(ctx);
+  },
+  onError(ctx) => {
+    // add your own code here
+    console.log(ctx);
+  },
+  onMempool(tx) => {
+    // add your own code here
+    console.log(tx);
+  }
+);
+
+// For lite mode (transaction hash and block height only)
+await client.Subscribe("a5e2fa655c41753331539a2a86546bf9335ff6d9b7a512dc9acddb00ab9985c0", 1550000, onPublish, onStatus, onError, onMempool, true);
+\`\`\`
+
+### Go Client
+
+Installation:
+\`\`\`bash
+go get github.com/GorillaPool/go-junglebus
+\`\`\`
+
+Usage:
+\`\`\`go
+package main
+
+import (
+  "context"
+  "log"
+  "sync"
+  "github.com/GorillaPool/go-junglebus"
+  "github.com/GorillaPool/go-junglebus/models"
+)
+
+func main() {
+  wg := &sync.WaitGroup{}
+  
+  junglebusClient, err := junglebus.New(
+    junglebus.WithHTTP("https://junglebus.gorillapool.io"),
+  )
+  if err != nil {
+    log.Fatalln(err.Error())
+  }
+  
+  subscriptionID := "..." // fill in the ID for the subscription
+  fromBlock := uint64(750000)
+  
+  eventHandler := junglebus.EventHandler{
+    // do not set this function to leave out mined transactions
+    OnTransaction: func(tx *models.TransactionResponse) {
+      log.Printf("[TX]: %d: %v", tx.BlockHeight, tx.Id)
+    },
+    // do not set this function to leave out mempool transactions
+    OnMempool: func(tx *models.TransactionResponse) {
+      log.Printf("[MEMPOOL TX]: %v", tx.Id)
+    },
+    OnStatus: func(status *models.ControlResponse) {
+      log.Printf("[STATUS]: %v", status)
+    },
+    OnError: func(err error) {
+      log.Printf("[ERROR]: %v", err)
+    },
+  }
+  
+  var subscription *junglebus.Subscription
+  if subscription, err = junglebusClient.Subscribe(context.Background(), subscriptionID, fromBlock, eventHandler); err != nil {
+    log.Printf("ERROR: failed getting subscription %s", err.Error())
+  }
+  
+  // For lite mode
+  if subscription, err := junglebusClient.SubscribeWithQueue(context.Background(), subscriptionID, fromBlock, 0, eventHandler, &junglebus.SubscribeOptions{
+    QueueSize: 100000,
+    LiteMode: true,
+  }); err != nil {
+    log.Printf("ERROR: failed getting subscription %s", err.Error())
+  }
+  
+  wg.Add(1)
+  wg.Wait()
+}
+\`\`\`
+
+## Further Reading
+
+For complete API documentation, visit [JungleBus Docs](${JUNGLEBUS_DOCS_URL})
+`;
+}
+
+/**
+ * Register the JungleBus API documentation resource with the MCP server
+ * @param server The MCP server instance
+ */
+export function registerJungleBusResource(server: McpServer): void {
+	server.resource(
+		"junglebus-api-docs",
+		JUNGLEBUS_DOCS_URL,
+		{
+			title: "JungleBus API Documentation",
+			description:
+				"API documentation for JungleBus, a transaction monitoring service for Bitcoin SV",
+		},
+		async (uri) => {
+			const documentationContent = getJungleBusDocumentation();
+			return {
+				contents: [
+					{
+						uri: uri.href,
+						text: documentationContent,
+					},
+				],
+			};
+		},
+	);
+}

package/resources/resources.ts

@@ -1,6 +1,7 @@
 import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { registerBRCsResources } from "./brcs";
 import { registerChangelogResource } from "./changelog";
+import { registerJungleBusResource } from "./junglebus";
 
 /**
  * Register all resources with the MCP server
@@ -13,5 +14,8 @@ export function registerResources(server: McpServer): void {
 	// Register changelog resource
 	registerChangelogResource(server);
 
+	// Register JungleBus API documentation resource
+	registerJungleBusResource(server);
+
 	// Add more resource categories here as needed
 }

package/tools/a2b/discover.ts

@@ -6,25 +6,34 @@ import type {
 } from "@modelcontextprotocol/sdk/types.js";
 import { z } from "zod";
 
-type OverlayRequest = {
+// API endpoint for the A2B Overlay service
+const OVERLAY_API_URL = "https://a2b-overlay-production.up.railway.app/v1";
+
+type A2BDiscoveryItem = {
+	txid: string;
+	outpoint: string;
 	type: "agent" | "tool";
-	query: string;
-	limit: number;
-	offset: number;
-	fromBlock?: number;
-	toBlock?: number;
+	app: string;
+	serverName: string;
+	command: string;
+	description: string;
+	keywords: string[];
+	args: Record<string, string>;
+	env: Record<string, string>;
+	blockHeight: number;
+	timestamp: string;
+	tools?: string[];
+	prompts?: string[];
+	resources?: string[];
 };
 
-type OverlayResponse = {
-	agents: {
-		name: string;
-		description: string;
-		capabilities: string[];
-	}[];
-	tools: {
-		name: string;
-		description: string;
-	}[];
+type OverlaySearchResponse = {
+	items: A2BDiscoveryItem[];
+	total: number;
+	limit: number;
+	offset: number;
+	queryType: "agent" | "tool" | "all";
+	query: string;
 };
 
 // Schema for agent discovery parameters
@@ -38,6 +47,73 @@ export const a2bDiscoverArgsSchema = z.object({
 });
 export type A2bDiscoverArgs = z.infer<typeof a2bDiscoverArgsSchema>;
 
+/**
+ * Format the response in a user-friendly way
+ */
+function formatSearchResults(data: unknown, queryType: string): string {
+	// console.log(`Received data: ${JSON.stringify(data).substring(0, 200)}...`); // Debug log
+
+	// Check if data is an object with items property
+	if (!data) {
+		return `No ${queryType} results found.`;
+	}
+
+	// Handle the new API format where data is an object with 'items' array
+	const items = Array.isArray(data)
+		? data
+		: (data as { items?: A2BDiscoveryItem[] }).items;
+
+	// Ensure items is an array
+	if (!items || !Array.isArray(items) || items.length === 0) {
+		return `No ${queryType} results found.`;
+	}
+
+	let result = `Found ${items.length} ${queryType === "all" ? "items" : `${queryType}s`}:\n\n`;
+
+	items.forEach((item, index) => {
+		if (!item) return;
+
+		// Agent or MCP server name with description
+		result += `${index + 1}. **${item.serverName || "Unknown"}** - ${item.description || "No description"}\n`;
+
+		// Display command to run
+		if (item.command) {
+			const args = item.args ? Object.values(item.args).join(" ") : "";
+			result += `   Command: \`${item.command} ${args}\`\n`;
+		}
+
+		// Add tools count if available
+		if (item.tools && Array.isArray(item.tools)) {
+			result += `   Tools: ${item.tools.length} available\n`;
+		}
+
+		// Add keywords if available
+		if (
+			item.keywords &&
+			Array.isArray(item.keywords) &&
+			item.keywords.length > 0
+		) {
+			result += `   Keywords: ${item.keywords.join(", ")}\n`;
+		}
+
+		// Add blockchain details
+		if (item.outpoint) {
+			result += `   Outpoint: ${item.outpoint}\n`;
+		}
+
+		if (item.blockHeight !== undefined) {
+			const date = item.timestamp
+				? new Date(item.timestamp).toLocaleDateString()
+				: "Unknown date";
+			result += `   Block: ${item.blockHeight}, ${date}\n`;
+		}
+
+		result += "\n";
+	});
+
+	return result;
+}
+
 /**
  * Registers the a2b_discover tool for on-chain agent discovery
  */
@@ -50,49 +126,113 @@ export function registerA2bDiscoverTool(server: McpServer) {
 			{ args }: { args: A2bDiscoverArgs },
 			extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
 		) => {
-			if (args.queryType === "agent") {
-				return {
-					content: [
-						{ type: "text", text: "Agent discovery is not supported yet" },
-					],
-					isError: true,
-				};
-			}
-
-			if (args.queryType !== "tool") {
-				return {
-					content: [
-						{
-							type: "text",
-							text: "Only tool discovery is supported currently",
-						},
-					],
-					isError: true,
-				};
-			}
-
 			try {
 				const params = new URLSearchParams();
+
+				// Set query type (agent, tool, or all)
 				params.set("type", args.queryType);
-				params.set("query", args.query);
-				params.set("limit", args.limit?.toString() ?? "5");
+
+				// Use enhanced search for better relevance scoring
+				let searchEndpoint = "/search/enhanced";
+
+				// For empty queries, use the regular search endpoint
+				if (!args.query || !args.query.trim()) {
+					searchEndpoint = "/search";
+				} else {
+					params.set("q", args.query); // enhanced search uses 'q' parameter
+				}
+
+				// Add pagination parameters
+				params.set("limit", args.limit?.toString() ?? "10");
 				params.set("offset", args.offset?.toString() ?? "0");
+
+				// Add block range if specified
 				if (args.fromBlock) {
 					params.set("fromBlock", args.fromBlock.toString());
 				}
 				if (args.toBlock) {
 					params.set("toBlock", args.toBlock.toString());
 				}
-				const OVERLAY_URL = `https://overlay.a2b.network/v1/search?${params.toString()}`;
-				const response = await fetch(OVERLAY_URL);
-				const data = (await response.json()) as OverlayResponse;
+
+				// Construct the full URL
+				const searchUrl = `${OVERLAY_API_URL}${searchEndpoint}?${params.toString()}`;
+				//console.log(`Searching URL: ${searchUrl}`);
+
+				// Make the request to the overlay API
+				const response = await fetch(searchUrl, {
+					method: "GET",
+					headers: {
+						Accept: "application/json",
+					},
+				});
+
+				if (!response.ok) {
+					throw new Error(
+						`API returned status ${response.status}: ${response.statusText}`,
+					);
+				}
+
+				const data = (await response.json()) as OverlaySearchResponse;
+
+				// Format the results for better readability
+				let result = "";
+
+				if (data?.items?.length > 0) {
+					result = `Found ${data.items.length} ${args.queryType}(s):\n\n`;
+
+					data.items.forEach((item: A2BDiscoveryItem, index: number) => {
+						// Server name and description
+						result += `${index + 1}. **${item.serverName || "Unknown"}** - ${item.description || "No description"}\n`;
+
+						// Command to run
+						if (item.command) {
+							const cmdArgs = item.args
+								? Object.values(item.args).join(" ")
+								: "";
+							result += `   Command: \`${item.command} ${cmdArgs}\`\n`;
+						}
+
+						// Tools available
+						if (item.tools?.length) {
+							result += `   Tools: ${item.tools.length} available\n`;
+						}
+
+						// Keywords
+						if (item.keywords?.length) {
+							result += `   Keywords: ${item.keywords.join(", ")}\n`;
+						}
+
+						// Blockchain details
+						if (item.outpoint) {
+							result += `   Outpoint: ${item.outpoint}\n`;
+						}
+
+						if (item.blockHeight !== undefined) {
+							const date = item.timestamp
+								? new Date(item.timestamp).toLocaleDateString()
+								: "Unknown date";
+							result += `   Block: ${item.blockHeight}, ${date}\n`;
+						}
+
+						result += "\n";
+					});
+				} else {
+					result = `No ${args.queryType} results found.`;
+				}
+
 				return {
-					content: [{ type: "text", text: JSON.stringify(data) }],
+					content: [{ type: "text", text: result }],
 					isError: false,
 				};
 			} catch (error) {
+				console.error("Search error:", error);
 				return {
-					content: [{ type: "text", text: `Error querying overlay: ${error}` }],
+					content: [
+						{
+							type: "text",
+							text: `Error querying A2B Overlay: ${error instanceof Error ? error.message : String(error)}`,
+						},
+					],
 					isError: true,
 				};
 			}