Nano Currency MCP Server

Instructions

Implementation Reference

• nano-currency.js:264-274 (handler)

  The handler function for nano_account_info tool. It fetches account information using getAccountInfo helper, formats the balance, and returns a formatted text response or handles errors.

  async function (parameters) {  
    try {
      let accountInfo =  await getAccountInfo(parameters.address)
  
      return createTextResponse(`The account information for ${parameters.address} is ` + JSON.stringify({ ...accountInfo, balance: friendlyAmount(accountInfo.balance) }))
    }
    catch (error) {
      console.error('[nano_account_info] Error:', error.message || error);
      return createErrorResponse(error)
    }    
  }

• nano-currency.js:254-258 (schema)

  Zod schema defining the input parameter 'address' with validation and description for the nano_account_info tool.

  const nano_account_info_parameters = {
    address: z.string({ required_error: 'Address is required' })
      .refine(address_ => N.checkAddress(address_), { message: 'Nano address is not valid' })
      .describe("Nano address/account to get information about")
  }

• nano-currency.js:260-275 (registration)

  Registration of the nano_account_info tool using server.tool, specifying name, description, parameters schema, and handler function.

  server.tool(
    'nano_account_info',
    'Retrieve detailed information about a specific Nano account/address, including balance (in Nano and raw units), representative, and frontier block.',
    nano_account_info_parameters,
    async function (parameters) {  
      try {
        let accountInfo =  await getAccountInfo(parameters.address)
  
        return createTextResponse(`The account information for ${parameters.address} is ` + JSON.stringify({ ...accountInfo, balance: friendlyAmount(accountInfo.balance) }))
      }
      catch (error) {
        console.error('[nano_account_info] Error:', error.message || error);
        return createErrorResponse(error)
      }    
    }
  )

• nano-currency.js:152-163 (helper)

  Helper function that performs the Nano RPC 'account_info' call to retrieve detailed account information, used by the nano_account_info handler.

  async function getAccountInfo(address) {
    return (
      await rpcCall(
        NANO_RPC_URL_KEY,
        'account_info',
        {
          account: address,
          representative: 'true'
        }
      )
    )
  }

• nano-currency.js:137-139 (helper)

  Helper function to format balance in both Nano and raw units, used in the response formatting.

  function friendlyAmount (balance) {
    return `${convertRawToNano(balance)} in nano units or ${balance} in raw units`
  }