> 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-list/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 list

Gateway 5.5+

List tools available from an MCP server.

The `iagctl mcp tool list` command connects to a registered MCP server and displays all tools it exposes. For each tool, the output includes its name and description. Use the `--raw` flag to return full tool schema information, including input and output parameters.

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

## Syntax

```bash
iagctl mcp tool list <mcp_server> [flags]
```

## Available tools

The following tables list the tools available from two commonly used MCP servers. The tools available on any given MCP server depend on its implementation.

### Filesystem server tools

Tools provided by the filesystem MCP server (`@modelcontextprotocol/server-filesystem`). All tools operate only within the directories the server is configured to allow.

| Tool                        | Description                                                                                                                                        |
| --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create_directory`          | Create a new directory, including any intermediate parent directories, in a single operation. Succeeds silently if the directory already exists.   |
| `directory_tree`            | Return a recursive JSON tree of files and directories. Each entry includes `name`, `type` (`file` or `directory`), and `children` for directories. |
| `edit_file`                 | Make line-based edits to a text file by replacing exact line sequences with new content. Returns a git-style diff of the changes.                  |
| `get_file_info`             | Return metadata for a file or directory, including size, creation time, last modified time, permissions, and type.                                 |
| `list_allowed_directories`  | Return the list of directories the server is allowed to access, including their subdirectories.                                                    |
| `list_directory`            | Return a listing of all files and directories at a specified path. Entries are prefixed with `[FILE]` or `[DIR]`.                                  |
| `list_directory_with_sizes` | Return a listing of all files and directories at a specified path, including size information. Entries are prefixed with `[FILE]` or `[DIR]`.      |
| `move_file`                 | Move or rename a file or directory. Fails if the destination already exists. Both source and destination must be within allowed directories.       |
| `read_file`                 | Read the complete contents of a file as text. Deprecated—use `read_text_file` instead.                                                             |
| `read_media_file`           | Read an image or audio file and return its base64-encoded content and MIME type.                                                                   |
| `read_multiple_files`       | Read the contents of multiple files simultaneously. Returns each file's content with its path. Individual read failures don't stop the operation.  |
| `read_text_file`            | Read the complete contents of a text file. Supports `head` and `tail` parameters to return only the first or last N lines.                         |
| `search_files`              | Recursively search for files and directories matching a glob-style pattern. Returns full paths to all matching items.                              |
| `write_file`                | Create a new file or overwrite an existing file with the provided text content. Overwrites without warning.                                        |

### Context7 server tools

Tools provided by the Context7 MCP server (`https://mcp.context7.com/mcp`). Use these tools to retrieve up-to-date library documentation and code examples during automation development.

| Tool                 | Description                                                                                                  |
| -------------------- | ------------------------------------------------------------------------------------------------------------ |
| `resolve-library-id` | Resolve a package or product name to a Context7-compatible library ID. Returns a list of matching libraries. |
| `query-docs`         | Retrieve documentation and code examples from Context7 for a specified library or framework.                 |

## Examples

### List tools from an MCP server

```bash
iagctl mcp tool list my-server
```

### List tools with full schema in JSON format

```bash
iagctl mcp tool list my-server --raw
```

## Options

```bash
  -h, --help   Help for list
```

## 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
```