list-prompt-versions

Retrieve all versions of a specific prompt with pagination support to track changes and configurations over time.

Instructions

Get a list of all versions for a specific prompt. Returns versions with pagination support.

Example usage: List all versions of a prompt named 'article-summarizer'

Expected return: Array of prompt version objects with IDs and configuration. Example: [ { "description": "Initial version", "model_provider": "OPENAI", "model_name": "gpt-3.5-turbo", "template": { "type": "chat", "messages": [ { "role": "system", "content": "You are an expert summarizer. Create clear, concise bullet points highlighting the key information." }, { "role": "user", "content": "Please summarize the following {{topic}} article:

{{article}}" } ] }, "template_type": "CHAT", "template_format": "MUSTACHE", "invocation_parameters": { "type": "openai", "openai": {} }, "id": "promptversionid1234" } ]

Input Schema

TableJSON Schema

Name	Required	Description	Default
`prompt_identifier`	Yes
`limit`	No

Implementation Reference

js/packages/phoenix-mcp/src/promptTools.ts:453-475 (handler)

The handler function for 'list-prompt-versions' tool. It makes a GET request to the Phoenix API endpoint /v1/prompts/{prompt_identifier}/versions with optional limit query param and returns the JSON response as text content.

async ({ prompt_identifier, limit }) => {
  const response = await client.GET(
    "/v1/prompts/{prompt_identifier}/versions",
    {
      params: {
        path: {
          prompt_identifier,
        },
        query: {
          limit,
        },
      },
    }
  );
  return {
    content: [
      {
        type: "text",
        text: JSON.stringify(response.data, null, 2),
      },
    ],
  };
}

js/packages/phoenix-mcp/src/promptTools.ts:449-476 (registration)

Registration of the 'list-prompt-versions' tool using server.tool(), including name, description, schema, and inline handler.

server.tool(
  "list-prompt-versions",
  LIST_PROMPT_VERSIONS_DESCRIPTION,
  listPromptVersionsSchema.shape,
  async ({ prompt_identifier, limit }) => {
    const response = await client.GET(
      "/v1/prompts/{prompt_identifier}/versions",
      {
        params: {
          path: {
            prompt_identifier,
          },
          query: {
            limit,
          },
        },
      }
    );
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(response.data, null, 2),
        },
      ],
    };
  }
);

js/packages/phoenix-mcp/src/promptSchemas.ts:54-57 (schema)
Zod schema for the tool's input parameters: prompt_identifier (required string) and limit (optional number between 1-100, default 100).
```
export const listPromptVersionsSchema = z.object({
  prompt_identifier: z.string(),
  limit: z.number().min(1).max(100).default(100),
});
```

js/packages/phoenix-mcp/src/promptTools.ts:146-179 (helper)

Detailed description string for the 'list-prompt-versions' tool, used during registration.

const LIST_PROMPT_VERSIONS_DESCRIPTION = `Get a list of all versions for a specific prompt. Returns versions with pagination support.

Example usage: 
  List all versions of a prompt named 'article-summarizer'

Expected return: 
  Array of prompt version objects with IDs and configuration. 
  Example: [
    {
      "description": "Initial version",
      "model_provider": "OPENAI",
      "model_name": "gpt-3.5-turbo",
      "template": {
        "type": "chat",
        "messages": [
          {
            "role": "system",
            "content": "You are an expert summarizer. Create clear, concise bullet points highlighting the key information."
          },
          {
            "role": "user",
            "content": "Please summarize the following {{topic}} article:\n\n{{article}}"
          }
        ]
      },
      "template_type": "CHAT",
      "template_format": "MUSTACHE",
      "invocation_parameters": {
        "type": "openai",
        "openai": {}
      },
      "id": "promptversionid1234"
    }
  ]`;

js/packages/phoenix-mcp/src/index.ts:40-40 (registration)
Top-level call to initializePromptTools, which registers the 'list-prompt-versions' tool among others.
```
initializePromptTools({ client, server });
```

@arizeai/phoenix-mcp