get-dataset-experiments
Retrieve all experiments run on a specific dataset, including metadata such as experiment ID, dataset version, repetitions, and timestamps, to analyze and monitor performance.
Instructions
List experiments run on a dataset.
Example usage: Show me all experiments run on dataset RGF0YXNldDox
Expected return: Array of experiment objects with metadata. Example: [ { "id": "experimentid1234", "dataset_id": "datasetid1234", "dataset_version_id": "datasetversionid1234", "repetitions": 1, "metadata": {}, "project_name": "Experiment-abc123", "created_at": "YYYY-MM-DDTHH:mm:ssZ", "updated_at": "YYYY-MM-DDTHH:mm:ssZ" } ]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| datasetId | Yes |
Implementation Reference
- Registers and implements the 'get-dataset-experiments' MCP tool. The handler fetches the list of experiments for the specified datasetId using the PhoenixClient API and returns the JSON response as text content.server.tool( "get-dataset-experiments", GET_DATASET_EXPERIMENTS_DESCRIPTION, { datasetId: z.string(), }, async ({ datasetId }) => { const response = await client.GET( "/v1/datasets/{dataset_id}/experiments", { params: { path: { dataset_id: datasetId }, }, } ); return { content: [ { type: "text", text: JSON.stringify(response.data, null, 2), }, ], }; } );
- Zod schema for the 'get-dataset-experiments' tool input: requires a datasetId string.{ datasetId: z.string(), },
- js/packages/phoenix-mcp/src/datasetTools.ts:146-170 (registration)Registration of the 'get-dataset-experiments' tool on the McpServer, including name, description reference, input schema, and handler function.server.tool( "get-dataset-experiments", GET_DATASET_EXPERIMENTS_DESCRIPTION, { datasetId: z.string(), }, async ({ datasetId }) => { const response = await client.GET( "/v1/datasets/{dataset_id}/experiments", { params: { path: { dataset_id: datasetId }, }, } ); return { content: [ { type: "text", text: JSON.stringify(response.data, null, 2), }, ], }; } );