MCP Sample Tools SuiteApp
The MCP Sample Tools SuiteApp will be removed from the SuiteApp Marketplace in September 2025.
This SuiteApp will be replaced by the new MCP Standard Tools SuiteApp, which is also targeted to be available in September 2025.
You can still find the sample tools in the MCP-Sample-Tools directory of the SuiteCloud Project Repository on Oracle Samples GitHub.
The MCP Sample Tools SuiteApp is designed for use with the NetSuite AI Connector Service. It provides basic examples of how to perform NetSuite operations using conversational AI. These tools let you interact with NetSuite using natural language commands from an AI client that communicates through Model Context Protocol (MCP). The MCP Sample Tools serve as a starting point for building your own solutions, demonstrating how SuiteScript and the SuiteCloud Development Framework (SDF) can be used to enable natural language interactions with NetSuite.
These tools are designed to work with your existing NetSuite roles and permissions. It uses the same access controls as the NetSuite UI, so you can only see data and take actions allowed by your assigned roles.
To learn more about the sample tools, see Available Tools in the MCP Sample Tools SuiteApp.
Read the following topics to learn more about the MCP sample tools:
Key Features
-
Conversational Data Access – Retrieve information about NetSuite records (such as customers, transactions, and financial data) using natural language queries.
-
Record Operations – Create or update records through conversational commands. Supported operations are securely executed according to your NetSuite permissions.
-
Data Visualization – View information in user-friendly formats such as tables and summaries, that are compatible with the AI client's display capabilities.
-
Permission Compliance – All data access and actions are determined by your NetSuite role and permissions. The tools don't provide any additional access beyond what your NetSuite role allows. Your ability to view data, perform operations, or use specific tools depends on the permissions assigned to the NetSuite role you use to connect.
How MCP Sample Tools Work
The MCP Sample Tools enable you to interact with NetSuite data using conversational AI. The typical workflow includes the following steps:
-
Install the MCP Sample Tools SuiteApp
Install the MCP Sample Tools SuiteApp from the SuiteApp Marketplace. For installation instructions, see Installing the MCP Sample Tools SuiteApp.
-
Invoke Tools through Conversational AI
After installation, connect to the AI client to start using the tools. See Connect to NetSuite AI Connector Service.
Open the AI client and start a conversation using natural language commands or queries. The conversational AI interprets your request and presents you with a set of available tools and actions. For more information about the available tools, see Available Tools in the MCP Sample Tools SuiteApp.
-
Perform Operations
When you make a request through the AI client, your commands are translated into the appropriate NetSuite API calls or operations.
The tools perform the task in NetSuite, such as retrieving records or updating information. The results are then returned to the AI client, where you can view the outcome directly in your conversation interface.
Common Tasks
You can use the MCP sample tools to perform common business tasks through conversational AI. Some examples include:
-
Creating a new customer record.
-
Updating a customer’s contact information.
-
Viewing a simple financial performance in graphs.
For information about the tools available in the SuiteApp, see Available Tools in the MCP Sample Tools SuiteApp.