← All help topics

Parameters

Parameters are what the AI fills in when it uses your tool, like the city for a weather tool. Each one has a name, and you write {{ name }} wherever its value goes.

Add a parameter

In the tool editor, under Parameters, click Add a parameter, then fill in:

  • The name, like city. Letters, numbers and _.
  • The type:
TypeUse it for
TextWords, names, anything typed.
Whole numberCounts and limits, like 10.
NumberNumbers with decimals, like 1.5.
Yes or noSomething on or off.
File or folderA path on your computer. It's checked against your allowed folders.
ListSeveral values, like a list of tags.
Object (JSON)Structured data, for advanced tools.
  • What it is, for the AI: a short description, like "City name, e.g. Denver".
  • Required: the AI must always fill it in.
  • Default: the value used when the AI leaves it out. A parameter with a default is never required.
  • Allowed values, for text: a list of choices separated by commas, like metric, imperial. The AI can only pick one of them.

For a File or folder parameter, turn on The tool writes here if the tool creates or changes that file. Then it's checked as a place to write, not just to read.

Good to know

  • Always use File or folder for paths. SolutionMCP then expands ~, follows shortcuts to where they really lead, and refuses anything outside your allowed folders. The tool gets the full path.
  • The AI may send "42" for a number or "yes" for yes-or-no. SolutionMCP converts these when it's clear what was meant, and otherwise tells the AI what's wrong.
  • A parameter the AI leaves out, without a default, is empty.

See also Templates and quoting.