Read measured queries

Read the actual questions included in a run. MCP tool: list_queries. 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.
`run_id`	string	Yes	`Required`	Run ID from list_runs for this project. Use the exact returned value and check readiness before reading measurements.
`prompt_type`	string or null	No	`null`	Select an exact Category facet label returned for the project.
`intent`	string or null	No	`null`	Select an exact Customer Intent facet label returned for the project.
`topic`	string or null	No	`null`	Select an exact measured topic label. A broader phrase does not select every topic containing that phrase.
`entity`	string or null	No	`null`	Exact entity name for checking whether it was mentioned in a query’s responses.
`limit`	integer	No	`50`	Maximum query rows to return. Check n_returned, n_available, and truncated; this operation has no cursor. Minimum 1. Maximum 200.

Example call

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

{
  "name": "list_queries",
  "arguments": {
    "project_id": "PROJECT_ID",
    "run_id": "RUN_ID",
    "entity": "Colorescience",
    "limit": 50
  }
}

Read the response

data.rows contains query text and labels. data.n_total_run is the full run total; subject_summary describes the selected and returned counts. With a measured entity, rows can include mentioned.

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
`data.rows[].topic`	Measured topic assigned to the query.
`data.rows[].prompt_type`	Category facet label assigned to the query.
`data.rows[].intent`	Customer Intent label assigned to the query.
`data.rows[].mentioned`	When checking a measured entity, whether its mentions were found for this query. Inspect unindexed-name warnings first.
`data.n_returned`	Rows returned after the request limit.
`data.n_available`	Query rows matching the selection before the limit.
`data.n_total_run`	Query rows across the full run, before the selection.
`data.truncated`	Whether the response omitted matching rows because of its limit.

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.

{
  "data_ready": true,
  "data": {
    "rows": [
      {
        "topic": "Tinted Mineral Face SPF",
        "prompt_type": "what to look for",
        "intent": "commercial",
        "mentioned": false
      }
    ],
    "n_returned": 50,
    "n_available": 240,
    "n_total_run": 240,
    "truncated": true,
    "limit": 50
  }
}

Text and record identifiers are omitted from this excerpt. Retrieve those fields from your own response when preparing an evidence review.

Important behavior

This is a qualitative query lookup with no scores. limit caps the result and there is no pagination cursor. An unindexed entity does not receive a measured presence claim. Check tool and payload errors before using the result. Response handling explains estimates and empty results; errors and recovery covers invalid requests and temporary failures. HTTP equivalent: Read measured queries. HTTP parameters and defaults can differ.

Get started

Connect securely

Read measurements

Build dependable integrations

Build reports

Report recipes

Reference

Session and discovery

Visibility measurements

Sources and evidence

Changes and trends

Google data

Pages and report planning

HTTP operations

Read measured queries

Parameters

Example call

Read the response

Fields to use

Response example

Important behavior

​Parameters

​Example call

​Read the response

​Fields to use

​Response example

​Important behavior

Parameters

Example call

Read the response

Fields to use

Response example

Important behavior