Create a tool from an Action

task brazil Updated Jul 29, 2026 2 min read create-action-tool.md
Raw file servicenow.com

Create a tool from an Action to expose it to Model Context Protocol (MCP) clients from an MCP Server.

Before you begin

Perform these steps before creating a tool from an Action:

  1. Create an Action in Workflow Studio using supported input and output data types. See Create an action in Workflow Studio to learn more.

    Note: Only synchronous actions are supported. Actions with wait steps, asynchronous execution, or human intervention steps can't be used as tools.

  2. Establish the requisite AI Access Control List (ACL) to facilitate external invocation of the component. See Create an AI ACL for a Subflow or Action to learn more.

  3. Confirm the compatibility status in the staging table. See Check the compatibility of a Subflow or Action to learn more.

Role required: sn_mcp_server.tools_admin, sn_mcp_server.admin, or admin

Procedure

  1. Select Action from these categories.

    [Omitted image "mcp-create-tool-moveworks.png"] Alt text: Tool creation

  2. On the form, fill in the fields.

    [Omitted image "mcp-server-create-tool-action.png"] Alt text: Create tool from Action

    Note: The category is auto-populated if selected in the last modal.

Field

Description

Action

Select an Action type from the list.

Label

An internal name for the tool.

MCP app

An active MCP app linked to this action.

Description

The description of what the tool intends to do. This input is exposed to AI clients and used to determine when to call this tool.

Note: Admins must add specific and action-oriented description as the AI clients access it to decide when to invoke the tool.

Annotations

Indication of the tool's behavior with MCP clients, including whether it only reads data, is idempotent, makes destructive changes or updates, or can call external links. You can also specifically combine these annotations as needed.

The MCP client will use the selected annotations to categorise tools according to their behavior.

Required roles

The MCP Tools admin selects one or more roles from the User Role [sys_user_role] table to specify which roles can access and use the tool.

MCP Servers

One or more servers you want to add your tool to.

**Note:** A tool can be used by multiple servers so any changes that you make to a tool apply to all servers that use the tool. Before editing a tool, review which servers it's associated with to determine the impact for every server.
In the Tool inputs section, the fields associated with the capability are added.
  1. Turn off inputs from the tool that you don't want to expose.

    1. In the Tool inputs section, locate the tool input.

    2. From the Enabled column, select the toggle to turn off the input.

      Note: Some tool inputs are required and can't be turned off.

  2. Select Create.

What to do next

Invoke the tool via Claude or an alternative MCP client and verify that it functions as intended with the tool you registered. Launch MCP client to test end-to-end execution. For more information, see Connecting to an MCP server from an MCP client.

Parent Topic:Creating tools for a Model Context Protocol server

Keywords Create subflow tool type for MCP server
Search documentation
Search document titles and file paths on the brazil branch