@goplausible/algorand-mcp 4.1.0 → 4.2.1

package/dist/tools/apiManager/index.d.ts

@@ -38,7 +38,7 @@ export declare const apiManager: ({
         src: string;
         mimeType?: string | undefined;
         sizes?: string[] | undefined;
-        theme?: "light" | "dark" | undefined;
+        theme?: "dark" | "light" | undefined;
     }[] | undefined;
     title?: string | undefined;
 })[];

package/dist/tools/arc26Manager.d.ts

@@ -22,18 +22,19 @@ export declare class Arc26Manager {
         qrCodePng: string;
         qrCodeUtf8: string;
     }>;
+    /**
+     * Constructs an Algorand URI according to ARC-26 specification and generates a QR code
+     * @param params The parameters for constructing the URI
+     * @returns Object containing the URI and QR code as base64 data URL
+     */
+    generateUri(params: Arc26ToolInput): Promise<{
+        uri: string;
+    }>;
     handleTool(name: string, args: Record<string, unknown>): Promise<{
-        content: ({
+        content: {
             type: string;
             text: string;
-            data?: undefined;
-            mimeType?: undefined;
-        } | {
-            type: string;
-            data: string;
-            mimeType: string;
-            text?: undefined;
-        })[];
+        }[];
     }>;
 }
 export declare const arc26Manager: Arc26Manager;

package/dist/tools/arc26Manager.js

@@ -101,7 +101,11 @@ export class Arc26Manager {
         const qrCodePng = await QRCode.toDataURL(uri, {
             type: 'image/png',
             errorCorrectionLevel: 'H',
-            // margin: 1,
+            color: {
+                dark: '#000000',
+                light: '#FFFFFF'
+            },
+            margin: 4,
             width: 128
         });
         return {
@@ -110,6 +114,52 @@ export class Arc26Manager {
             qrCodeUtf8: qrCodeUtf8
         };
     }
+    /**
+     * Constructs an Algorand URI according to ARC-26 specification and generates a QR code
+     * @param params The parameters for constructing the URI
+     * @returns Object containing the URI and QR code as base64 data URL
+     */
+    async generateUri(params) {
+        // Validate address format (base32 string)
+        if (!params.address || !/^[A-Z2-7]{58}$/.test(params.address)) {
+            throw new McpError(ErrorCode.InvalidParams, 'Invalid Algorand address format');
+        }
+        // Start building the URI with the scheme and address
+        let uri = `algorand://${params.address}`;
+        // Build query parameters
+        const queryParams = [];
+        // Add optional parameters if provided
+        if (params.label) {
+            queryParams.push(`label=${encodeURIComponent(params.label)}`);
+        }
+        if (typeof params.amount === 'number') {
+            if (params.amount < 0) {
+                throw new McpError(ErrorCode.InvalidParams, 'Amount must be non-negative');
+            }
+            // Convert to microAlgos and ensure no decimals
+            const microAlgos = Math.floor(params.amount);
+            queryParams.push(`amount=${microAlgos}`);
+        }
+        if (typeof params.asset === 'number') {
+            if (params.asset < 0) {
+                throw new McpError(ErrorCode.InvalidParams, 'Asset ID must be non-negative');
+            }
+            queryParams.push(`asset=${params.asset}`);
+        }
+        if (params.note) {
+            queryParams.push(`note=${encodeURIComponent(params.note)}`);
+        }
+        if (params.xnote) {
+            queryParams.push(`xnote=${encodeURIComponent(params.xnote)}`);
+        }
+        // Add query parameters to URI if any exist
+        if (queryParams.length > 0) {
+            uri += '?' + queryParams.join('&');
+        }
+        return {
+            uri,
+        };
+    }
     async handleTool(name, args) {
         // Cast args to Arc26ToolInput after validation
         const toolArgs = {
@@ -121,13 +171,32 @@ export class Arc26Manager {
             xnote: args.xnote
         };
         if (name === 'generate_algorand_qrcode') {
-            const { uri, qrCodePng, qrCodeUtf8 } = await this.generateUriAndQr(toolArgs);
-            return {
-                content: [
-                    { type: "text", text: qrCodeUtf8 + "\n\n```\n" + uri + "\n```" },
-                    { type: "image", data: qrCodePng.replace(/^data:image\/png;base64,/, ''), mimeType: "image/png" }
-                ]
-            };
+            // const { uri, qrCodePng, qrCodeUtf8 } = await this.generateUriAndQr(toolArgs);
+            const { uri } = await this.generateUri(toolArgs);
+            // return {
+            //   content: [
+            //     { type: "text", text: qrCodeUtf8 + "\n\n```\n" + uri + "\n```" },
+            //     { type: "image", data: qrCodePng.replace(/^data:image\/png;base64,/, ''), mimeType: "image/png" }
+            //   ]
+            // };
+            try {
+                const qrclawUrl = `https://qrclaw.goplausible.xyz/?q=${encodeURIComponent(uri)}`;
+                const response = await fetch(qrclawUrl, {
+                    method: 'GET',
+                    headers: { 'Accept': 'application/json' }
+                });
+                if (response.ok) {
+                    const data = await response.json();
+                    return {
+                        content: [
+                            { type: "text", text: data.qr + "\n\n```\n" + uri + "\n```\n\nLink: " + data.link + "\nExpires in: " + data.expires_in }
+                        ]
+                    };
+                }
+            }
+            catch (error) {
+                throw new McpError(ErrorCode.InternalError, `QR Tool Error: ${error instanceof Error ? error.message : String(error)}`);
+            }
         }
         throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
     }

package/dist/tools/utilityManager.js

@@ -86,7 +86,7 @@ export class UtilityManager {
                                 type: 'text',
                                 text: JSON.stringify({
                                     name: 'Algorand MCP Server',
-                                    version: '4.1.0',
+                                    version: '4.2.1',
                                     builder: 'GoPlausible',
                                     description: 'A Model Context Protocol (MCP) server providing comprehensive access to the Algorand blockchain. Supports account management, transaction building and signing, smart contract interaction, asset operations, ARC-26 URI generation, and deep integration with Algorand ecosystem services including NFDomains, Tinyman, Vestige, and Ultrade.',
                                     blockchain: 'Algorand — a carbon-negative, pure proof-of-stake Layer 1 blockchain delivering instant finality, low fees, and advanced smart contract capabilities via AVM (Algorand Virtual Machine).',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goplausible/algorand-mcp",
-  "version": "4.1.0",
+  "version": "4.2.1",
   "publishConfig": {
     "access": "public"
   },