> ## Documentation Index
> Fetch the complete documentation index at: https://mulerouter.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# mulerouter list

> List available model endpoints with optional filtering

Browse the model catalog. With no flags, every registered endpoint is printed,
grouped by provider.

## Synopsis

```bash theme={null}
mulerouter list [options]
```

## Options

| Option                 | Description                                                                                              |
| ---------------------- | -------------------------------------------------------------------------------------------------------- |
| `--provider <name>`    | Filter by provider (e.g. `alibaba`, `google`, `klingai`, `midjourney`, `minimax`, `openai`, `bytedance`) |
| `--output-type <type>` | Filter by output type (`image`, `video`, `audio`, `text`)                                                |
| `--tag <tag>`          | Filter by tag, e.g. `SOTA`                                                                               |
| `--site <site>`        | Filter to models available on a given site                                                               |
| `--providers`          | List provider names only — skip the model listing                                                        |
| `--json`               | Output as JSON                                                                                           |

Unknown values for `--provider`, `--output-type`, or `--site` produce a yellow
warning but the command still runs (the result is just an empty match).

## Examples

```bash theme={null}
# Everything
mulerouter list

# All Google models
mulerouter list --provider google

# Every video endpoint
mulerouter list --output-type video

# Only SOTA-tagged endpoints
mulerouter list --tag SOTA

# Just the provider names
mulerouter list --providers

# Machine-readable
mulerouter list --json | jq '.models[] | .model_id + "/" + .action'
```

## Text output

Endpoints are grouped by provider and printed with their description, output
type, and tags. Each entry shows the canonical `provider/model/action` identifier
you can pass to [`params`](/docs/cli/commands/params) and [`run`](/docs/cli/commands/run).

```
[ALIBABA]
----------------------------------------

  alibaba/wan2.6-t2v/generation [SOTA]
    Wan2.6 Text-to-Video: ...
    Output: video

  alibaba/wan2.6-i2v/generation [SOTA]
    Wan2.6 Image-to-Video: ...
    Output: video
```

The footer shows the total endpoint count after filtering.

## JSON output

```json theme={null}
{
  "models": [
    {
      "model_id": "alibaba/wan2.6-t2v",
      "action": "generation",
      "provider": "alibaba",
      "model_name": "wan2.6-t2v",
      "description": "Wan2.6 Text-to-Video: ...",
      "input_types": ["text"],
      "output_type": "video",
      "api_path": "/vendors/alibaba/v1/wan2.6-t2v/generation",
      "available_on": ["mulerouter", "mulerun"],
      "result_key": "videos",
      "tags": ["SOTA"]
    }
  ],
  "site": null
}
```

The `site` field reflects the `--site` filter you passed (or `null` when
unfiltered).

## See also

* [`mulerouter params`](/docs/cli/commands/params) — inspect the inputs a model accepts
* [Model cheatsheet](/docs/cli/models) — curated overview of which model to pick