list-prompt-version-tags
Retrieve all tags associated with a specific prompt version to track deployments and manage versions effectively.
Instructions
Get a list of all tags for a specific prompt version. Returns tag objects with pagination support.
Example usage: List all tags associated with prompt version 'promptversionid1234'
Expected return: Array of tag objects with names and IDs. Example: [ { "name": "staging", "description": "The version deployed to staging", "id": "promptversionid1234" }, { "name": "development", "description": "The version deployed for development", "id": "promptversionid1234" } ]
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| prompt_version_id | Yes | ||
| limit | No |
Implementation Reference
- Handler function that executes the tool: fetches prompt version tags from PhoenixClient API using GET /v1/prompt_versions/{prompt_version_id}/tags and returns JSON stringified response.async ({ prompt_version_id, limit }) => { const response = await client.GET( "/v1/prompt_versions/{prompt_version_id}/tags", { params: { path: { prompt_version_id, }, query: { limit, }, }, } ); return { content: [ { type: "text", text: JSON.stringify(response.data, null, 2), }, ], }; }
- Zod schema for input validation: requires prompt_version_id (string), optional limit (number 1-100, default 100).export const listPromptVersionTagsSchema = z.object({ prompt_version_id: z.string(), limit: z.number().min(1).max(100).default(100), });
- js/packages/phoenix-mcp/src/promptTools.ts:505-532 (registration)Tool registration in initializePromptTools: registers 'list-prompt-version-tags' with description, schema, and handler.server.tool( "list-prompt-version-tags", LIST_PROMPT_VERSION_TAGS_DESCRIPTION, listPromptVersionTagsSchema.shape, async ({ prompt_version_id, limit }) => { const response = await client.GET( "/v1/prompt_versions/{prompt_version_id}/tags", { params: { path: { prompt_version_id, }, query: { limit, }, }, } ); return { content: [ { type: "text", text: JSON.stringify(response.data, null, 2), }, ], }; } );