← All help topics

Secrets in your tools

Never type an API key or password into a tool. Save it as a secret, and use it by name.

  1. On the Secrets page, save the key under a name, like WEATHER_KEY.
  2. In your tool, write {{ secret.WEATHER_KEY }} where the key goes. For example, as a header of a web request: Authorization: Bearer {{ secret.WEATHER_KEY }}.

SolutionMCP fills in the value only when the tool runs. The AI never sees it, and it's hidden as *** in approval questions and on the Activity page.

If a tool uses a secret you haven't saved yet, the Secrets page lists it under Missing secrets, and the Overview page mentions it.

Tip: Need something from your environment instead, like your user name? Use {{ env.USER }}.