aspire mcp tools command

Name

aspire mcp tools - List MCP tools exposed by running resources.

Synopsis

Aspire CLI

aspire mcp tools [options]

Description

The aspire mcp tools command lists the MCP tools exposed by resources in a running AppHost. Use it to discover which resources expose tools and which tool names you can pass to aspire mcp call.

When executed without the --apphost option, the command:

1. Scans for all running AppHost processes.
2. If multiple AppHosts are running within the current directory scope, prompts you to select which one to target.
3. If only one AppHost is running in scope, connects to it directly.
4. If no in-scope AppHosts are found but out-of-scope AppHosts exist, displays all running AppHosts for selection.

Options

The following options are available:

• --apphost <apphost>

  The path to the Aspire AppHost project file.

• --format <Json|Table>

  Output format. Use Json for machine-readable output suitable for scripting and automation. Defaults to Table.

• -?, -h, --help

  Prints help and usage documentation for the available commands and options.

• -l, --log-level <Critical|Debug|Error|Information|None|Trace|Warning>

  Set the minimum log level for console output. Use this option to increase diagnostics while troubleshooting or reduce output in scripted runs.

• --non-interactive

  Run the command in non-interactive mode, disabling all interactive prompts and spinners.

• --nologo

  Suppress the startup banner and telemetry notice.

• --banner

  Display the animated Aspire CLI welcome banner.

• --wait-for-debugger

  Wait for a debugger to attach before running a command.

Examples

• List MCP tools for the current AppHost:

  Aspire CLI

  aspire mcp tools

• Output the tool list as JSON:

  Aspire CLI

  aspire mcp tools --format Json

• Target a specific AppHost project:

  Aspire CLI

  aspire mcp tools --apphost './src/MyApp.AppHost/MyApp.AppHost.csproj'

See also

• aspire mcp
• aspire mcp call