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

# iagctl mcp tool call

Gateway 5.5+

Call a tool on an MCP server.

The `iagctl mcp tool call` command executes a specific tool exposed by a registered MCP server and returns the result. Use `iagctl mcp tool list` to see the tools available on a server and their expected input parameters.

For more information, see [Register and manage MCP servers](../flowai/flowmcp-gateway/manage-mcp-servers).

## Syntax

```bash
iagctl mcp tool call <tool_name> <mcp_server> [flags]
```

## Examples

### Call a tool without parameters

```bash
iagctl mcp tool call list_directory my-server
```

### Call a tool with parameters

Parameters are provided as a JSON string using the `--params` flag. The expected structure depends on the tool — use `iagctl mcp tool list --raw` to view each tool's input schema.

```bash
iagctl mcp tool call read_file my-server \
  --params '{"path": "/private/tmp/example.txt"}'
```

### Call a tool and return raw JSON output

```bash
iagctl mcp tool call read_file my-server \
  --params '{"path": "/private/tmp/example.txt"}' \
  --raw
```

## Options

```bash
  -h, --help           Help for call
      --params string  Parameters to pass to the tool, as a JSON string
```

## Options inherited from parent commands

```bash
      --config string    Path to the configuration file
      --profile string   Specify the client profile to use (case-insensitive, defaults to [client] section)
      --raw              Display the result of the command in raw format
      --verbose          Enable verbose output
```