Available Tools in the MCP Sample Tools

Important:

As of September 2025, the MCP Sample Tools SuiteApp is no longer available for new installations. It has been replaced by the MCP Standard Tools SuiteApp, which is available for installation from the SuiteApp Marketplace. For more information, see MCP Standard Tools SuiteApp.

If the MCP Sample Tools SuiteApp is still installed in your account, you should uninstall it and switch to the MCP Standard Tools SuiteApp as soon as possible. There will be no further updates or fixes for existing installations of the MCP Sample Tools SuiteApp. Additionally, the SuiteApp will stop working at any time from December 2025 onward. For information about uninstalling SuiteApps, see Uninstalling SuiteApps Obtained from the SuiteApp Marketplace.

The MCP-Sample-Tools project from the SuiteCloud Project Repository on Oracle Samples GitHub includes a set of tools that demonstrate the types of operations you can perform through conversational AI. These tools serve as practical examples of what you can build using SuiteScript. The tools are implemented using custom tool scripts and SuiteScript 2.1, and are developed and managed within an SDF account customization project (ACP). 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:

NetSuite also provides the MCP Standard Tools SuiteApp, which you can install from the SuiteApp Marketplace. For more information, see MCP Standard Tools SuiteApp.

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.

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