← All help topics

Your first tool

A tool is something the AI can use, like "read a file" or "check the weather". You can make your own in a few minutes with the tool editor, without writing any code beyond the command or script the tool runs.

Here you'll make a tool called hello that greets someone by name.

Make it

  1. Open the Tools page and click New tool.

  2. Under Where it goes, keep A new pack… and type a name for your pack, for example My tools. A pack is just a file that holds your tools.

  3. Under About the tool, type hello as the name, and as the description: Say hello to someone. The AI reads the description to decide when to use the tool, so say clearly what it does.

  4. Under What it runs, choose Runs a script and keep Every system. Type the script:

    echo Hello, {{ who }}!
    
  5. Under Parameters, click Add a parameter and name it who. A parameter is something the AI fills in. {{ who }} in the script is replaced with what the AI sends, safely quoted.

  6. Under What it can change, keep Only looks. This tool only shows text, so it never needs to ask first.

Try it

Under Try it, type a name next to who and click Run. You should see Hello, Sam! (or whatever name you typed). Nothing is saved yet: trying runs the tool exactly as it is in the form.

Save it

Click Save. The tool is now in your pack, and every AI app set up with SolutionMCP can use it right away. Ask yours something like "Use the hello tool to greet Sam".

Your new pack shows up on the Tools page with its own switch. Tools in it have an Edit button for changes later.

Tip: Prefer typing? Switch the editor from Form to TOML to see and edit the tool exactly as it's saved in the pack file.

Tools that change things

If your tool can change or delete something, say so under What it can change:

  • Makes changes: creates or changes things, but doesn't delete or overwrite them.
  • Can delete or overwrite: removes or replaces files, data or settings.

Tools marked this way ask you first, depending on your permission mode. See Approvals.