MCP Standard Tools 3.0.0: Apps and Access Rules

MCP Standard Tools 3.0.0 adds File Cabinet apps, runtime session details, and record transformations. Review access requirements and tool boundaries.

·5 min read·NetSuite 2026.2·View Oracle Docs

MCP Standard Tools SuiteApp version 3.0.0 adds File Cabinet apps and tools, runtime session information, and record transformation enhancements. File reads, uploads, and replacements require configured folder access alongside role permissions. That folder configuration does not filter listings, file-name searches, path lookups, or record attachments—a distinction administrators should review before rollout.

What's New in MCP Standard Tools?

The update covers three areas: interactive File Cabinet apps and supporting tools, a runtime session tool for inspecting the AI client connection, and record tools that identify and perform supported transformations. These capabilities support file handling, connection-context checks, and creating new records from existing records.

For broader release planning, see the NetSuite 2026.2 documentation updates. The sections below focus on the capabilities and access boundaries documented for MCP Standard Tools SuiteApp version 3.0.0.

What Can the File Cabinet MCP Apps Do?

The File Cabinet MCP Apps provide interactive interfaces for browsing folders, searching file names, uploading files, and sending supported file contents to the conversation. The three apps offer different entry points depending on whether the user needs to browse, retrieve a known file, or upload files.

MCP AppDocumented capabilities
File Cabinet Browser MCP AppBrowse folders, search file names, upload files, and send supported contents from selected files to the conversation.
Get File MCP AppRequest confirmation before sending supported file contents to the conversation; requires the complete File Cabinet path.
Upload File MCP AppUpload one or more files to a specified File Cabinet folder.

For a known file, prepare its complete File Cabinet path before using Get File. For exploratory work, the Browser app provides folder navigation and file-name search. Supported contents is an important qualification: do not assume every File Cabinet file can be sent to a conversation. The source does not identify supported formats.

How Are Uploads and Replacements Handled?

Uploads through the File Cabinet Browser and Upload File apps retain the files' original names. When the destination folder already contains a file with the same name, click Replace Existing File to confirm replacement.

These are not the complete replacement requirements: the available upload documentation cuts off during an additional condition. Before relying on replacements, check the complete requirements and test with a noncritical file. Do not assume matching names and sufficient permissions are the only conditions.

How Does Allowed File Cabinet Access Work?

A user with the Administrator role must configure Allowed File Cabinet Access on the Custom Tools page before the apps can read, upload, or replace files. An empty allowed-folder list blocks all three operations. The configured access levels work alongside existing NetSuite role permissions; they do not override them.

File operationMinimum allowed-folder access level
Read an existing fileView
Upload a new fileCreate
Replace an existing fileEdit

Treat this as a two-part access review: check the allowed-folder configuration and the user's underlying role permissions. An allowed folder configured at View does not meet the documented minimum for uploading a new file. Likewise, configured folder access does not grant permissions missing from the NetSuite role.

Allowed File Cabinet Access is not a universal visibility filter. The list does not filter folder listings, file-name searches, path lookups, or record attachments. Administrators should review those operations separately from file-content reading and upload access.

For validation, test reading, uploading, and replacing independently under the intended user role. Also check what that role can discover through searches and path lookups. This separates the configured content-access restrictions from the role permissions that still govern files, folders, and records.

Which File Cabinet Tools Are Available?

The tools complement the interactive apps with file discovery, path resolution, and record attachment operations. Existing NetSuite file, folder, and record permissions continue to apply.

ToolPurpose
ns_attachFileAttach an existing File Cabinet file to a NetSuite record.
ns_detachFileRemove a file's attachment to a record without deleting the file.
ns_getFolderByPathList files and folders directly inside the specified folder.
ns_getIdFromPathResolve a file or folder path to its internal ID.
ns_getPathFromIdResolve a file or folder internal ID to its complete path.
ns_searchFilesSearch file names across accessible File Cabinet folders.

Keep three boundaries in mind when designing a workflow. File-name search should not be treated as file-content search. Detaching a file removes the record association, not the file itself. The folder-listing tool lists direct contents; do not assume recursive traversal from that description.

What Does the Runtime Session Tool Return?

The runtime session tool returns NetSuite account and role information, enabled features, granted permissions, and supported preference values for the AI client connection. This provides connection-specific context when assessing an operation's prerequisites.

As a troubleshooting practice, inspect this context when investigating a failed file operation or record transformation. Compare the returned role, features, and permissions with the operation's requirements. The documented capability is inspection, not changing connection permissions or account configuration.

How Do Record Transformations Work?

Record transformation tools let users identify supported transformations and create new records from existing records. The documented example is creating invoices from sales orders. Success depends on account configuration, role permissions, and source-record eligibility.

Before building a workflow around a transformation, verify that it is supported and test an eligible source record using the intended role. Do not treat the sales-order example as a guarantee that every sales order can become an invoice. The source does not enumerate all transformations or eligibility rules.

Who This Affects

  • Administrators: Configure allowed-folder access and review its interaction with NetSuite role permissions. Validate discovery and attachment operations separately from content access.
  • Integration developers: Account for complete file paths, internal IDs, attachment behavior, runtime context, and transformation prerequisites.
  • AI client users: Prepare complete paths for Get File, confirm content retrieval when prompted, and review replacement confirmations before proceeding.
  • Transaction-processing teams: Validate transformation support and source-record eligibility before relying on record transformations.

For related documentation planning, review the NetSuite help updates covering AI and MCP tools.

Key Takeaways

  • MCP Standard Tools SuiteApp version 3.0.0 includes File Cabinet apps and tools, runtime session information, and record transformation enhancements.
  • File reads, uploads, and replacements require configured allowed-folder access plus existing role permissions.
  • Allowed-folder settings do not filter listings, file-name searches, path lookups, or record attachments.
  • Runtime session details expose connection context; transformation success depends on configuration, permissions, and source eligibility.

Frequently Asked Questions (4)

What folder access level is required to read, upload, or replace a File Cabinet file?
Allowed File Cabinet Access must be configured on the Custom Tools page, and the user's NetSuite role permissions must also permit the operation. Reading requires View, uploading a new file requires Create, and replacing an existing file requires Edit. An empty allowed-folder list blocks reads, uploads, and replacements.
Does Allowed File Cabinet Access restrict file searches, path lookups, or record attachments?
No. The configured folder list does not filter folder listings, file-name searches, path lookups, or record attachments. Those operations remain subject to existing NetSuite file, folder, and record permissions, so administrators should review them separately from file-content access.
Does detaching a File Cabinet file from a record delete the file?
No. The `ns_detachFile` tool removes the file's attachment to the record but does not delete the File Cabinet file. Existing NetSuite file and record permissions continue to apply.
What determines whether a record transformation, such as creating an invoice from a sales order, succeeds?
Transformation success depends on account configuration, role permissions, and whether the source record is eligible. The sales-order-to-invoice example does not mean every sales order can be transformed. Verify that the transformation is supported and test an eligible source record using the intended role.

Weekly Update History (1)

Integration SuiteAppsadded

Added the following entries for MCP Standard Tools SuiteApp: New MCP Apps and Tools in MCP Standard Tools SuiteApp Record Actions in MCP Standard Tools SuiteApp

View Oracle Docs
Source: New MCP Apps and Tools in MCP Standard Tools SuiteApp — Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?

More in AI

View all AI articles →

Also from NetSuite 2026.2

View all NetSuite 2026.2 changes →