Algorand MCP Server

Instructions

Implementation Reference

• src/algorand.ts:101-106 (handler)

  Core handler function in AlgorandService class that generates a new Algorand account using algosdk.generateAccount() and derives the mnemonic from the secret key.

  generateAccount(): { account: algosdk.Account; mnemonic: string } {
      const account = algosdk.generateAccount();
      const mnemonic = algosdk.secretKeyToMnemonic(account.sk);
  
      return { account, mnemonic };
  }

• src/index.ts:498-521 (handler)

  MCP server tool execution handler (switch case) that parses arguments, calls algorandService.generateAccount(), and formats the response.

  case 'generate_algorand_account': {
      GenerateAccountArgsSchema.parse(args);
      try {
          const { account, mnemonic } = algorandService.generateAccount();
          return {
              content: [
                  {
                      type: 'text',
                      text: `New Algorand Account Generated:\nAddress: ${account.addr}\nMnemonic: ${mnemonic}\n\n⚠️ SECURITY WARNING: Store the mnemonic phrase securely and never share it. This is required to access your account.`,
                  },
              ],
          };
      } catch (error) {
          return {
              content: [
                  {
                      type: 'text',
                      text: `Error generating account: ${error}`,
                  },
              ],
              isError: true,
          };
      }
  }

• src/index.ts:34-34 (schema)

  Zod schema definition for generate_algorand_account tool input arguments (empty object, no parameters).

  const GenerateAccountArgsSchema = z.object({});

• src/index.ts:156-164 (registration)

  Tool registration entry in the TOOLS array, specifying name, description, and input schema for MCP server.

  {
      name: 'generate_algorand_account',
      description: 'Generate a new Algorand account with address and mnemonic',
      inputSchema: {
          type: 'object',
          properties: {},
          required: [],
      },
  },