SuiteScript 2.1 Custom Tool Script Type

Custom tool scripts let you build NetSuite tools that external AI clients can invoke through the NetSuite AI Connector Service. With these scripts, you can retrieve data, trigger actions, or perform most SuiteScript-supported operations—all from natural language prompts in your AI client.

By using custom tools, your AI client can provide more accurate responses to prompts and perform specific actions for you in NetSuite. You can deploy custom tools to your NetSuite account only through the SuiteCloud Development Framework (SDF), either as a SuiteApp project or an account customization project (ACP). Each tool must be defined in a JSON Schema.

Read the following topics to learn how custom tool scripts work, what their technical requirements are, and how to implement them effectively in your NetSuite account.

• SuiteScript 2.1 Custom Tool Script Type Reference

  • Custom Tool Script Requirements

  • Custom Tool JSON Schema

  • Custom Tool Script Best Practices

  • Custom Tool Script Impact on Other Customizations

  • Custom Tool Script Error Messages

• SuiteScript 2.1 Custom Tool Script Type Code Samples

• Creating Custom Tools for the NetSuite AI Connector Service

• Custom Tool Scripts as XML Definitions

NetSuite provides samples of basic tools to help you get started with the NetSuite AI Connector Service and the custom tool script type. You can find sample tool implementations in the MCP-Sample-Tools directory of the SuiteCloud Project Repository on Oracle Samples GitHub.

General Notices