Tools

View as Markdown

These guides write tools, give them secrets and per-project values, and use an HTTP API or an MCP server's tools without code.

A tool is a function with a typed input and a typed output. Agents call tools, and so do flow steps. Kindgi checks the input before your code runs and the output after it returns, so neither side gets malformed data.

Write a tool: a function in TypeScript or Python, tried from a flow, tested, and wired onto an agent.
Call an HTTP API without code: a tool that is one HTTP request, made by Kindgi.
Give a tool a secret: declare the secret, read it from the call's context, keep it out of your code.
Give a tool per-project values: env values set for a tenant, an org or a project, read from the call's context.
Mark a tool read-only: what mutating: false changes for dry runs and approval gates.
Use an MCP server's tools: register an MCP server, and its tools become tools your agents and flows call.

The examples use the pack from the quickstarts, my-pack, with kindgi dev running: see the TypeScript and Python quickstarts.