@goplausible/algorand-mcp 3.1.1 → 3.2.1

package/README.md

@@ -501,6 +501,24 @@ See [Secure Wallet](#secure-wallet) for full architecture details.
 | `api_tinyman_get_validator_optin_quote` | Get quote for validator opt-in |
 | `api_tinyman_get_validator_optout_quote` | Get quote for validator opt-out |
 
+### Haystack Router Tools (3 tools)
+
+| Tool | Description |
+|---|---|
+| `api_haystack_get_swap_quote` | Get optimized swap quote with routing across Tinyman V2, Pact, Folks, and LST protocols |
+| `api_haystack_execute_swap` | All-in-one swap: quote → sign (via wallet) → submit → confirm |
+| `api_haystack_needs_optin` | Check if address needs asset opt-in before swapping |
+
+### Pera Wallet Tools (3 tools)
+
+| Tool | Description |
+|---|---|
+| `api_pera_asset_verification_status` | Get verification status of a mainnet asset (verified, trusted, suspicious, unknown) |
+| `api_pera_verified_asset_details` | Get detailed asset info from Pera (name, unit, logo, decimals, verification) |
+| `api_pera_verified_asset_search` | Search Pera verified assets by name, unit name, or keyword |
+
+> Pera Wallet tools are **mainnet only** — the Pera public API does not support testnet or localnet.
+
 ### ARC-26 URI Tools (1 tool)
 
 | Tool | Description |
@@ -567,7 +585,8 @@ algorand-mcp/
 │   │       ├── indexer/         # Indexer API
 │   │       ├── nfd/             # NFDomains
 │   │       ├── tinyman/         # Tinyman AMM
-│   │       └── example/         # Example tools
+│   │       ├── hayrouter/       # Haystack Router DEX aggregator
+│   │       └── pera/            # Pera Wallet verified assets
 │   └── utils/
 │       └── responseProcessor.ts # Pagination and formatting
 ├── tests/                       # Test suite

package/dist/tools/apiManager/index.js

@@ -4,8 +4,8 @@ import { nfdTools, handleNFDTools } from './nfd/index.js';
 // import { vestigeTools, handleVestigeTools } from './vestige/index.js';
 import { tinymanTools, handleTinymanTools } from './tinyman/index.js';
 // import { ultradeTools, handleUltradeTools } from './ultrade/index.js';
-import { exampleTools, handleExampleTools } from './example/index.js';
 import { haystackTools, handleHaystackTools } from './hayrouter/index.js';
+import { peraTools, handlePeraTools } from './pera/index.js';
 import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
 import { ResponseProcessor } from '../../utils/responseProcessor.js';
 // Combine all API tools
@@ -15,7 +15,7 @@ export const apiManager = [
     ...nfdTools,
     ...tinymanTools,
     ...haystackTools,
-    ...exampleTools
+    ...peraTools
 ];
 // Handle all API tools
 export async function handleApiManager(name, args) {
@@ -41,8 +41,9 @@ export async function handleApiManager(name, args) {
         else if (name.startsWith('api_haystack_')) {
             response = await handleHaystackTools(name, args);
         }
-        else if (name.startsWith('api_example_')) {
-            response = await handleExampleTools(name, args);
+        // Pera Wallet tools
+        else if (name.startsWith('api_pera_')) {
+            response = await handlePeraTools(name, args);
         }
         else {
             throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);

package/dist/tools/apiManager/pera/asset.d.ts

@@ -0,0 +1,3 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const peraAssetTools: Tool[];
+export declare function handlePeraAssetTools(args: any): Promise<any>;

package/dist/tools/apiManager/pera/asset.js

@@ -0,0 +1,122 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+const PERA_API_BASE = 'https://mainnet.api.perawallet.app/v1/public';
+export const peraAssetTools = [
+    {
+        name: 'api_pera_asset_verification_status',
+        description: 'Get the verification status of an Algorand mainnet asset from Pera Wallet. Returns verification tier (verified, trusted, suspicious, unverified) and explorer URL.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                assetId: {
+                    type: 'integer',
+                    description: 'Asset ID to check verification status',
+                },
+            },
+            required: ['assetId'],
+        },
+    },
+    {
+        name: 'api_pera_verified_asset_details',
+        description: 'Get detailed information about an Algorand mainnet asset from Pera Wallet, including name, unit name, decimals, total supply, USD value, logo, verification tier, and collectible status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                assetId: {
+                    type: 'integer',
+                    description: 'Asset ID to get detailed information',
+                },
+            },
+            required: ['assetId'],
+        },
+    },
+    {
+        name: 'api_pera_verified_asset_search',
+        description: 'Search Pera Wallet verified Algorand mainnet assets by name, unit name, or keyword. Returns matching assets with verification status, USD value, and logo.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search query — asset name, unit name, or keyword',
+                },
+                verifiedOnly: {
+                    type: 'boolean',
+                    description: 'If true, only return assets with "verified" or "trusted" tier (default: false)',
+                },
+            },
+            required: ['query'],
+        },
+    },
+];
+export async function handlePeraAssetTools(args) {
+    const name = args.name;
+    switch (name) {
+        case 'api_pera_asset_verification_status': {
+            const { assetId } = args;
+            if (!assetId && assetId !== 0) {
+                throw new McpError(ErrorCode.InvalidParams, 'assetId is required');
+            }
+            const response = await fetch(`${PERA_API_BASE}/asset-verifications/${assetId}/`);
+            if (!response.ok) {
+                if (response.status === 404) {
+                    return {
+                        asset_id: assetId,
+                        verification_tier: 'unverified',
+                        explorer_url: `https://explorer.perawallet.app/asset/${assetId}/`,
+                        message: 'Asset not found in Pera verification database',
+                    };
+                }
+                throw new McpError(ErrorCode.InternalError, `Pera API request failed with status: ${response.status}`);
+            }
+            const data = await response.json();
+            return {
+                asset_id: data.asset_id,
+                verification_tier: data.verification_tier,
+                explorer_url: data.explorer_url,
+            };
+        }
+        case 'api_pera_verified_asset_details': {
+            const { assetId } = args;
+            if (!assetId && assetId !== 0) {
+                throw new McpError(ErrorCode.InvalidParams, 'assetId is required');
+            }
+            const response = await fetch(`${PERA_API_BASE}/assets/${assetId}/`);
+            if (!response.ok) {
+                if (response.status === 404) {
+                    throw new McpError(ErrorCode.InvalidParams, `Asset with ID ${assetId} not found in Pera Wallet database`);
+                }
+                throw new McpError(ErrorCode.InternalError, `Pera API request failed with status: ${response.status}`);
+            }
+            return await response.json();
+        }
+        case 'api_pera_verified_asset_search': {
+            const { query, verifiedOnly } = args;
+            if (!query) {
+                throw new McpError(ErrorCode.InvalidParams, 'query is required');
+            }
+            const url = `${PERA_API_BASE}/assets/?search=${encodeURIComponent(query)}&limit=50&has_collectible=false`;
+            const response = await fetch(url);
+            if (!response.ok) {
+                throw new McpError(ErrorCode.InternalError, `Pera API search failed with status: ${response.status}`);
+            }
+            const data = await response.json();
+            let results = data.results || [];
+            if (verifiedOnly) {
+                results = results.filter((a) => a.verification_tier === 'verified' || a.verification_tier === 'trusted');
+            }
+            return results.map((a) => ({
+                asset_id: a.asset_id,
+                name: a.name,
+                unit_name: a.unit_name,
+                decimals: a.fraction_decimals,
+                verification_tier: a.verification_tier,
+                usd_value: a.usd_value,
+                logo: a.logo,
+                creator_address: a.creator_address,
+                is_deleted: a.is_deleted,
+            }));
+        }
+        default:
+            throw new McpError(ErrorCode.MethodNotFound, `Unknown Pera tool: ${name}`);
+    }
+}

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

@@ -0,0 +1,3 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const peraTools: Tool[];
+export declare function handlePeraTools(name: string, args: any): Promise<any>;

package/dist/tools/apiManager/pera/index.js

@@ -0,0 +1,17 @@
+import { ErrorCode, McpError } from '@modelcontextprotocol/sdk/types.js';
+import { peraAssetTools, handlePeraAssetTools } from './asset.js';
+export const peraTools = [
+    ...peraAssetTools,
+];
+export async function handlePeraTools(name, args) {
+    try {
+        const combinedArgs = { name, ...args };
+        return handlePeraAssetTools(combinedArgs);
+    }
+    catch (error) {
+        if (error instanceof McpError) {
+            throw error;
+        }
+        throw new McpError(ErrorCode.InternalError, `Failed to handle Pera tool: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}

package/dist/tools/utilityManager.js

@@ -86,7 +86,7 @@ export class UtilityManager {
                                 type: 'text',
                                 text: JSON.stringify({
                                     name: 'Algorand MCP Server',
-                                    version: '3.1.1',
+                                    version: '3.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": "3.1.1",
+  "version": "3.2.1",
   "publishConfig": {
     "access": "public"
   },

package/dist/tools/apiManager/example/get-balance.d.ts

@@ -1,11 +0,0 @@
-export declare const getBalanceToolSchema: {
-    type: string;
-    properties: {
-        address: {
-            type: string;
-            description: string;
-        };
-    };
-    required: string[];
-};
-export declare const getBalanceTool: (args: Record<string, unknown>) => Promise<import("algosdk/dist/types/client/v2/algod/models/types.js").Account>;

package/dist/tools/apiManager/example/get-balance.js

@@ -1,32 +0,0 @@
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
-import { getAlgodClient, extractNetwork } from '../../../algorand-client.js';
-export const getBalanceToolSchema = {
-    type: 'object',
-    properties: {
-        address: {
-            type: 'string',
-            description: 'Algorand address in standard format (58 characters)',
-        },
-    },
-    required: ['address'],
-};
-export const getBalanceTool = async (args) => {
-    try {
-        if (!args.address) {
-            throw new McpError(ErrorCode.InvalidParams, 'Missing required parameter: address');
-        }
-        if (!/^[A-Z2-7]{58}$/.test(args.address)) {
-            throw new McpError(ErrorCode.InvalidParams, 'Invalid Algorand address format');
-        }
-        const network = extractNetwork(args);
-        const algodClient = getAlgodClient(network);
-        const accountInfo = await algodClient.accountInformation(args.address).do();
-        return accountInfo;
-    }
-    catch (error) {
-        if (error instanceof McpError)
-            throw error;
-        const errorMessage = error instanceof Error ? error.message : 'Unknown error occurred';
-        throw new McpError(ErrorCode.InternalError, `Failed to get account balance: ${errorMessage}`);
-    }
-};

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

@@ -1,6 +0,0 @@
-export declare const exampleTools: {
-    name: string;
-    description: string;
-    inputSchema: any;
-}[];
-export declare function handleExampleTools(name: string, args: Record<string, unknown>): Promise<import("algosdk/dist/types/client/v2/algod/models/types.js").Account>;

package/dist/tools/apiManager/example/index.js

@@ -1,18 +0,0 @@
-import { McpError, ErrorCode } from '@modelcontextprotocol/sdk/types.js';
-import { getBalanceTool, getBalanceToolSchema } from './get-balance.js';
-import { withCommonParams } from '../../commonParams.js';
-export const exampleTools = [
-    {
-        name: 'api_example_get_balance',
-        description: 'Get account balance and assets',
-        inputSchema: withCommonParams(getBalanceToolSchema),
-    },
-];
-export async function handleExampleTools(name, args) {
-    switch (name) {
-        case 'api_example_get_balance':
-            return getBalanceTool(args);
-        default:
-            throw new McpError(ErrorCode.MethodNotFound, `Unknown example tool: ${name}`);
-    }
-}