> This page is for Tools.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.moveworks.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.moveworks.com/_mcp/server.

# ToolSmith

# Overview

ToolSmith is an assistant in Tool Studio that builds, changes, and debugs plugins. You describe the result you want, the systems it touches, and who will use it. ToolSmith proposes a plan, and once you approve it, it builds the plugin. You do not need to know the system's API or how Tool Studio assets fit together.

ToolSmith also works on plugins you already have. Reference a plugin to change it, ask how it works, or find out why it fails. Every change goes through a plan that you approve first.

> **Note**
>
> ToolSmith is in controlled availability. To register interest, use the [ToolSmith page on the AI Agent Marketplace](https://marketplace.moveworks.com/toolsmith).

## What you can do with ToolSmith

#### [Review and approve plans](/tool-studio/toolsmith/review-and-approve-plans)

Check what ToolSmith will build, change the plan, and approve it.

#### [Modify a plugin](/tool-studio/toolsmith/modify-a-plugin)

Change a plugin you already have, or ask how it works.

#### [Debug a plugin](/tool-studio/toolsmith/debug-a-plugin)

Find out why a plugin fails and fix it.

# How a build works

#### Describe the plugin

Open ToolSmith from Tool Studio. Say what the plugin should do, which systems it uses, and who will use it. See [Write effective prompts](#write-effective-prompts).

#### Answer any questions

ToolSmith might ask a few questions first, such as your instance's base URL or how the connector should authenticate.

#### Review and approve the plan

The plan lists what ToolSmith will create, change, or reuse, the external actions it will run, and how it will test the result. Select **Modify plan** to change it, or **Approve plan** to start the build. Approving the plan also runs its external actions. See [Review and approve plans](/tool-studio/toolsmith/review-and-approve-plans).

#### Configure credentials

If the plugin needs a new connector, ToolSmith asks for its credentials in a secure form. See [Configure credentials securely](#configure-credentials-securely).

#### Review what ToolSmith built

ToolSmith builds the assets, tests its actions against the live system, and reports progress in the chat. When it finishes, it lists the assets it created or changed, in the chat and under **Assets** in the Artifacts panel.

#### Test and roll out

The result is a normal Tool Studio plugin, available only to you or to the people you select. Test it with real requests in your assistant. To widen access, update its [Launch Configuration](/platform-management/access-control/end-user-access-control/launch-configuration).

You can leave the chat and come back later. ToolSmith keeps working until it needs something from you, such as an approval or credentials.

## What ToolSmith uses

* **The [Action Catalog](/tool-studio/toolsmith/action-catalog).** A library of third-party API documentation that ToolSmith checks first. When it needs more, it researches the vendor's public API documentation. You can also give it an API schema in the chat.
* **Your existing assets.** ToolSmith reuses suitable assets you already have, especially [connectors](/tool-studio/connectors). See [Reused and new assets](/tool-studio/toolsmith/review-and-approve-plans#reused-and-new-assets).
* **Moveworks documentation.** ToolSmith follows Moveworks documentation and plugin-building best practices.
* **Execution logs.** When you ask ToolSmith to [debug a plugin](/tool-studio/toolsmith/debug-a-plugin), it reads the plugin's execution logs.

# Before you begin

Before using ToolSmith:

* Make sure ToolSmith is enabled for your organization. You open it from Tool Studio.
* Start with a focused workflow involving one or two systems.
* Use a test or non-production environment. While it builds and tests a plugin, ToolSmith calls external endpoints, and some of those calls can send data to or change data in a connected system. To move a finished plugin to production, see [Plugin Promotion](/tool-studio/development-and-testing/managing-plugins/plugin-promotion).

# Write effective prompts

ToolSmith works out the API calls and the Tool Studio assets. Your prompt describes the result: what the plugin does, who uses it, and how it behaves. ToolSmith builds with what your prompt gives it and asks you questions when it needs to resolve something ambiguous.

A good prompt covers:

* **The outcome and the users.** What the plugin does, and who uses it.
* **The systems.** Each system the plugin reads from or changes, and any existing plugin, action, or connector to use or leave unchanged.
* **The rules.** Conditions, filters, confirmations, and exceptions.
* **The results.** The fields to show, and what to do when nothing matches, the input is invalid, or the system returns an error.
* **The limits.** What ToolSmith must not change, and what is out of scope.

For example:

```text
Build a plugin that shows employees their open ServiceNow incidents, highest priority first. Find the employee's ServiceNow user by the email of the person asking. For each incident, show the number, short description, priority, and state. Leave out resolved and closed incidents. If they have no open incidents, say so.
```

> **Say who the plugin acts for**
>
> When the plugin should act for whoever uses it, write "the employee" or "the person asking", not "my". ToolSmith can read "my" as you, the builder. In one build, "Find my ServiceNow user by my email address" produced a plugin with the builder's email hard-coded, so it would have shown the builder's incidents to everyone who used it. To check what a plugin does, [ask ToolSmith how it works](/tool-studio/toolsmith/modify-a-plugin#ask-about-a-plugin).

# Configure credentials securely

When a new connector needs credentials, ToolSmith pauses and shows a **Credentials needed** card. Select **Configure…** to open the **Complete Configuration** form, check the connector details ToolSmith filled in, enter the secret values, and select **Save & Resume**.

Enter credentials in this form, not in the chat. ToolSmith asks for each new connector's credentials in turn, and does not ask when it reuses a connector you already have.

# Limitations and considerations

## Limitations

* **ToolSmith cannot delete assets.** Delete assets directly in Tool Studio when needed.
* **ToolSmith conversations cannot be shared with other users.**

## Considerations

* **Results vary by system and workflow complexity.** ToolSmith's output depends on the available API documentation, your existing assets, and your prompt, and the same prompt can produce a different plan. If a plan does not meet your requirements, add rules, inputs, outputs, examples, or constraints, as described in [Write effective prompts](#write-effective-prompts). You might still need to finish part of the work by hand.
* **A finished build can still fail.** Test every plugin with representative requests. If it fails, ask ToolSmith to [debug it](/tool-studio/toolsmith/debug-a-plugin).
* **Tests can affect connected systems.** Approving a plan also approves the external actions it lists. Use a test or non-production environment, and review the expected side effects before you approve.

You remain responsible for reviewing and testing the result. Confirm that the plugin behaves as expected across representative scenarios and edge cases, and that it matches the approved plan, before you publish it more widely or use it in production.

# FAQs

## Do I still need to configure connectors and access control?

Yes. ToolSmith builds the plugin; you own the connection credentials, permissions, and testing, exactly as with a hand-built plugin.

## Can I paste credentials into the ToolSmith conversation?

You can, but we strongly advise against it. Enter credentials, API keys, tokens, and other secrets in the secure configuration form instead.

## Which systems can ToolSmith build actions for?

Any system with an API. If the system's API documentation is not public, give ToolSmith the API schema in the chat. Systems in the [Action Catalog](/tool-studio/toolsmith/action-catalog) are faster and more reliable because ToolSmith already has their documentation. To check coverage, select **ToolSmith optimized** under the **ToolSmith** filter on the AI Agent Marketplace Explore page.

## Can ToolSmith change or debug plugins it did not build?

Yes. ToolSmith can change and debug any plugin, including plugins built by hand in Tool Studio. See [Modify a plugin](/tool-studio/toolsmith/modify-a-plugin) and [Debug a plugin](/tool-studio/toolsmith/debug-a-plugin).

## Does ToolSmith install Marketplace templates?

No. ToolSmith builds from scratch and reuses your existing assets where it can. To install a template, use the AI Agent Marketplace.

## Where do I use ToolSmith?

In Tool Studio, once ToolSmith is enabled for your organization. ToolSmith is in controlled availability; register interest on the [Marketplace ToolSmith page](https://marketplace.moveworks.com/toolsmith).

# Related documentation

#### [Action Catalog](/tool-studio/toolsmith/action-catalog)

Learn which API documentation ToolSmith can use when building HTTP actions.

#### [Testing and error handling](/tool-studio/guides/getting-started/testing-and-error-handling)

Plan tests and handle failures in plugin workflows.

#### [Plugin management](/tool-studio/development-and-testing/managing-plugins)

Edit, publish, version, and manage plugins.

#### [Launch Configuration](/platform-management/access-control/end-user-access-control/launch-configuration)

Control who can use a plugin.