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

# List dimension options

> Discover the filter labels available for the project.

Discover the filter labels available for the project.

**MCP tool:** `list_dimension_options`. **Operation:** read. Uses the authorized connection; no project or content changes are made by this tool.

## Parameters

| Name | Type | Required | Default | Meaning and accepted values |
| - | - | - | - | - |
| `project_id` | string | Yes | `Required` | Project ID from list\_projects. Select the project in the intended workspace and environment. |

## Example call

Replace ID placeholders and example selections with values from your account. This is the `params` object for MCP `tools/call`.

```json theme={null}
{
  "name": "list_dimension_options",
  "arguments": {
    "project_id": "PROJECT_ID"
  }
}
```

## Read the response

Top-level `dimensions` contains option arrays for `platform`, `topic`, `prompt_type`, `intent`, and `user_profile`.

### Fields to use

These selected fields explain the example and the result to preserve. Field presence depends on the response; this is not a complete response schema.

| Field | Meaning and use |
| - | - |
| `dimensions.platform` | Platform labels available from the latest run. |
| `dimensions.topic` | Measured topic labels available from the latest run. |
| `dimensions.prompt_type` | Category facet labels for query and measurement selection. |
| `dimensions.intent` | Customer Intent labels for selection. |
| `dimensions.user_profile` | Measured profile labels when present. An empty list does not establish a persona filter. |

## Response example

Selected fields from an observed IQRush Dev response. Lists are shortened and project/run IDs are placeholders. Omitted fields remain available in the actual response.

```json theme={null}
{
  "project_id": "PROJECT_ID",
  "dimensions": {
    "platform": [
      "ChatGPT Search",
      "Gemini"
    ],
    "topic": [
      "Reapplication and Active Mineral SPF",
      "Tinted Mineral Face SPF"
    ],
    "prompt_type": [
      "common complaints",
      "expert recommendations",
      "feature comparisons",
      "how to choose",
      "popular options",
      "reliability and quality",
      "reputation and credibility",
      "reviews and ratings",
      "strengths and weaknesses",
      "user recommendations",
      "value for money",
      "what to look for"
    ],
    "intent": [
      "commercial",
      "informational",
      "transactional"
    ],
    "user_profile": []
  }
}
```

Read the actual returned scope, counts, and interval levels before interpreting these fields.

## Important behavior

The options describe the latest run. Historical runs can differ. Use exact labels and inspect warnings on the actual measurement response.

Check tool and payload errors before using the result. [Response handling](/developers/guides/09-responses-and-metrics) explains estimates and empty results; [errors and recovery](/developers/guides/13-errors) covers invalid requests and temporary failures.

HTTP equivalent: [List dimension options](/developers/http/http-list-dimension-options). HTTP parameters and defaults can differ.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.