add-prompt-version-tag

Tag specific prompt versions in Phoenix MCP Server to organize and identify them for tracking and deployment purposes.

Instructions

Add a tag to a specific prompt version. The operation returns no content on success (204 status code).

Example usage: Tag prompt version 'promptversionid1234' with the name 'production'

Expected return: Confirmation message of successful tag addition

Input Schema

TableJSON Schema

Name	Required	Description	Default
`prompt_version_id`	Yes
`name`	Yes
`description`	No

Implementation Reference

js/packages/phoenix-mcp/src/promptTools.ts:538-557 (handler)

The handler function that implements the tool logic by sending a POST request to add a tag to a specific prompt version using the PhoenixClient.

async ({ prompt_version_id, name, description }) => {
  await client.POST("/v1/prompt_versions/{prompt_version_id}/tags", {
    params: {
      path: {
        prompt_version_id,
      },
    },
    body: {
      name,
      description,
    },
  });
  return {
    content: [
      {
        type: "text",
        text: `Successfully added tag "${name}" to prompt version ${prompt_version_id}`,
      },
    ],
  };

js/packages/phoenix-mcp/src/promptSchemas.ts:69-73 (schema)
Zod schema for input validation of the tool parameters: prompt_version_id, name, and optional description.
```
export const addPromptVersionTagSchema = z.object({
  prompt_version_id: z.string(),
  name: z.string(),
  description: z.string().optional(),
});
```

js/packages/phoenix-mcp/src/promptTools.ts:534-559 (registration)

Registers the 'add-prompt-version-tag' tool with the MCP server using server.tool(), including name, description, input schema, and handler function.

server.tool(
  "add-prompt-version-tag",
  ADD_PROMPT_VERSION_TAG_DESCRIPTION,
  addPromptVersionTagSchema.shape,
  async ({ prompt_version_id, name, description }) => {
    await client.POST("/v1/prompt_versions/{prompt_version_id}/tags", {
      params: {
        path: {
          prompt_version_id,
        },
      },
      body: {
        name,
        description,
      },
    });
    return {
      content: [
        {
          type: "text",
          text: `Successfully added tag "${name}" to prompt version ${prompt_version_id}`,
        },
      ],
    };
  }
);

@arizeai/phoenix-mcp