Available Tools in the MCP Sample Tools SuiteApp

The MCP Sample Tools SuiteApp includes a set of predefined tools that demonstrate the types of operations you can perform through conversational AI. These tools serve as practical examples of what you can build with SuiteScript in the SuiteCloud environment. The tools are implemented using custom tool scripts and SuiteScript 2.1, and are developed and managed within an SDF SuiteApp project. These tools use the same SuiteScript modules, script types, and project structure available to SuiteCloud developers, enabling you to develop and deploy your own custom tools using the same approach.

For information about the available tools in this sample SuiteCloud project, see List of Sample Tools.

Read the following help topics for information about the NetSuite AI Connector Service and developing custom tools:

• Get Started with the NetSuite AI Connector Service

• Creating Custom Tools for the NetSuite AI Connector Service

• SuiteScript 2.1 Custom Tool Script Type

How To Invoke a Tool

You can use natural language in your AI client to invoke a tool. Use the tool description as a guide on how to write your message. For example: Create a customer for Name Surname in NetSuite.

The client then shows a pop-up asking for permission to use an external integration tool.

Permissions for MCP Sample Tools

The permissions defined for each tool determine the visibility of the tool in the AI client. A tool is visible only if your NetSuite role has all the required permissions for that tool. However, access to data and the ability to execute tool actions still depend on your NetSuite role and permissions. You can only access data and perform operations that your NetSuite role allows, regardless of tool visibility.

To use most tools, you need at least view permissions. Creating or updating customer records require edit permissions. The SuiteQL tool is an exception, there are no specific permission requirements to access it. However, the data you can see or query with SuiteQL still depends on your existing NetSuite permissions.

List of Sample Tools

The following table provides an overview of the MCP Sample Tools. For detailed information such as the permissions and required parameters, see the help topic for each tool.

Note:

Parameters provided to a tool call are verified. Required parameters must be included in the request.

Name	Description
checkInventoryLevels	Checks inventory levels, with an option to filter by location ID.
createCustomer	Creates a new customer record in NetSuite.
generateSalesReport	Generates a sales report, with an option to group by customer or date.
getCustomerBalance	Retrieves customer balance information.
getCustomerDetails	Retrieves detailed information about a specific customer.
getCustomerTransactions	Retrieves the transaction history for a customer.
getFinancialPerformance	Generates a simple financial performance summary for a specific date range.
getItemDetails	Retrieves detailed information about a specific item, including inventory details by location.
getSalesOrder	Retrieves detailed information about a specific sales order, including header fields and line items.
getSalesOrderWithFilters	Retrieves sales orders, with an option to filter by customer, date range, and status.
runCustomSuiteQL	Runs a custom SuiteQL query in NetSuite. Only read-only queries are supported. Useful for gathering information of all types.
searchCustomer	Searches for customers in NetSuite based on a partial name match. With an empty string, it retrieves all customers.
updateCustomer	Updates customer information in NetSuite.

General Notices