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

# AX MCP Tool Catalog

> Every tool the Arize AX MCP server exposes, grouped by resource.

The server exposes a set of read-only tools, plus `server_info`. Each one wraps a single [REST API v2](/docs/ax/rest-reference/overview) operation and takes the same arguments as the endpoint behind it, so the [endpoint reference](/docs/ax/rest-reference/overview) is the place to look for full response schemas.

The **Stage** column shows each tool's release stage — Alpha, Beta, or Stable — inherited from the REST operation it wraps. See [API version stages](/docs/ax/rest-reference/overview#api-version-stages) for what each stage means for reliability and breaking changes.

<Note>
  Every tool listed here is currently read-only. There are no create, update, or delete tools.
</Note>

See [conventions](/docs/api-clients/mcp/conventions) for the pagination, span limit, timeout, and error rules shared across every tool below.

## Projects

Projects are the usual entry point. An agent that knows your project ID can reach traces, spans, and tasks from there.

| Tool                | Stage                                                                                                                                                                          | Description                         |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------- |
| `list_projects`     | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | List projects the caller can access |
| `get_project`       | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | Read one project by ID or name      |
| `list_project_tags` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | List tags on a project              |

## Traces and spans

| Tool          | Stage                                                                                                                                                                         | Description              |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| `list_traces` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | List traces in a project |
| `list_spans`  | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | List spans in a project  |

Point your agent at a specific trace when you are debugging. Asking it to list spans across a busy project without filters will burn through pages and tell you very little.

## Monitors

| Tool                | Stage                                                                                                                                                                          | Description              |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------ |
| `list_monitors`     | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | List monitors in a space |
| `get_monitor`       | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | Read one monitor         |
| `list_monitor_tags` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | List tags on a monitor   |

## Datasets

| Tool                    | Stage                                                                                                                                                                          | Description                              |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------- |
| `list_datasets`         | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | List datasets in a space                 |
| `get_dataset`           | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | Read one dataset, including its versions |
| `list_dataset_examples` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | Page through the examples in a dataset   |
| `list_dataset_tags`     | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | List tags on a dataset                   |

## Experiments

| Tool                   | Stage                                                                                                                                                                           | Description                       |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| `list_experiments`     | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#15803d'}}>Stable</span> | List experiments for a dataset    |
| `get_experiment`       | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#15803d'}}>Stable</span> | Read one experiment               |
| `list_experiment_runs` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#15803d'}}>Stable</span> | Page through an experiment's runs |
| `list_experiment_tags` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span>  | List tags on an experiment        |

## Evaluators

| Tool                       | Stage                                                                                                                                                                          | Description                           |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------- |
| `list_evaluators`          | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | List evaluators in a space            |
| `get_evaluator`            | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | Read one evaluator                    |
| `list_evaluator_versions`  | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | List an evaluator's versions          |
| `get_evaluator_version`    | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | Read one evaluator version            |
| `list_evaluator_templates` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | List the built-in evaluator templates |
| `list_evaluator_tags`      | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | List tags on an evaluator             |

## Annotations

| Tool                            | Stage                                                                                                                                                                           | Description                         |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------- |
| `list_annotation_configs`       | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#15803d'}}>Stable</span> | List annotation configs in a space  |
| `get_annotation_config`         | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#15803d'}}>Stable</span> | Read one annotation config          |
| `list_annotation_config_tags`   | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span>  | List tags on an annotation config   |
| `list_annotation_queues`        | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#15803d'}}>Stable</span> | List annotation queues              |
| `get_annotation_queue`          | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#15803d'}}>Stable</span> | Read one annotation queue           |
| `list_annotation_queue_records` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#15803d'}}>Stable</span> | Page through the records in a queue |
| `list_annotation_queue_tags`    | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span>  | List tags on an annotation queue    |

## Prompts

| Tool                   | Stage                                                                                                                                                                          | Description                                         |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------- |
| `list_prompts`         | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | List prompts in the Prompt Hub                      |
| `get_prompt`           | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | Read one prompt                                     |
| `list_prompt_versions` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | List a prompt's versions                            |
| `get_prompt_version`   | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | Read one prompt version                             |
| `get_prompt_label`     | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span>  | Resolve a label, such as `production`, to a version |
| `list_prompt_tags`     | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | List tags on a prompt                               |

`get_prompt_label` is the tool to reach for when you want the prompt your app is actually serving rather than the newest draft.

## Tasks

| Tool             | Stage                                                                                                                                                                         | Description                |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| `list_tasks`     | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | List tasks in a space      |
| `get_task`       | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | Read one task              |
| `list_task_runs` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | Page through a task's runs |
| `get_task_run`   | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | Read one task run          |

## Integrations

| Tool                | Stage                                                                                                                                                                          | Description                  |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------- |
| `list_integrations` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | List configured integrations |
| `get_integration`   | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#d92d20'}}>Alpha</span> | Read one integration         |

## Spaces

| Tool          | Stage                                                                                                                                                                         | Description                       |
| ------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------- |
| `list_spaces` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | List spaces the caller can access |
| `get_space`   | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | Read one space by ID or name      |

## Organizations

| Tool                 | Stage                                                                                                                                                                         | Description                              |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
| `list_organizations` | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | List organizations the caller can access |
| `get_organization`   | <span style={{display: 'inline-block', padding: '1px 8px', borderRadius: '999px', fontSize: '0.8em', fontWeight: 600, color: '#fff', backgroundColor: '#2563eb'}}>Beta</span> | Read one organization by ID or name      |

## Server info

| Tool          | Stage | Description                                                |
| ------------- | ----- | ---------------------------------------------------------- |
| `server_info` | —     | Return the server name, version, and MCP protocol revision |

Useful for confirming which deployment you reached and which protocol revision it speaks.