Phoenix MCP Server

Phoenix MCP Server is an implementation of the Model Context Protocol for the Arize Phoenix platform. It provides a unified interface to Phoenix's capabilites.

Phoenix MCP Server supports:

• Prompts Management: Create, list, update, and iterate on prompts

• Datasets: Explore datasets, and synthesize new examples

• Experiments: Pull experiment results and visualize them with the help of an LLM

Connecting the Phoenix MCP Server

Connect via Cursor

From the Cursor Settings page, navigate to the MCP section, and click "Add new global MCP server"

Add the following code to your MCP config file:

{
  "mcpServers": {
    "phoenix": {
      "command": "npx",
      "args": [
        "-y",
        "@arizeai/phoenix-mcp@latest",
        "--baseUrl",
        "https://my-phoenix.com",
        "--apiKey",
        "your-api-key"
      ]
    }
  }

Replacing:

• https://my-phoenix.com with your Phoenix collector endpoint
• your-api-key with your Phoenix API key

After saving your config file, you should see the Phoenix server enabled:

You can access Phoenix prompts, experiments, and datasets through Cursor!

Connect via Claude Desktop

From the Claude Desktop settings window, navigate to the Developer Section, and click "Edit Config"

Open your config file and add the following code:

{
  "mcpServers": {
    "phoenix": {
      "command": "npx",
      "args": [
        "-y",
        "@arizeai/phoenix-mcp@latest",
        "--baseUrl",
        "https://my-phoenix.com",
        "--apiKey",
        "your-api-key"
      ]
    }
  }

Replacing:

• https://my-phoenix.com with your Phoenix collector endpoint
• your-api-key with your Phoenix API key

Save your file and relaunch Claude Desktop. You should now see your new tools ready for use in Claude!

Manually Connect

Add the following code to your MCP config file:

{
  "mcpServers": {
    "phoenix": {
      "command": "npx",
      "args": [
        "-y",
        "@arizeai/phoenix-mcp@latest",
        "--baseUrl",
        "https://my-phoenix.com",
        "--apiKey",
        "your-api-key"
      ]
    }
  }

Replacing:

• https://my-phoenix.com with your Phoenix collector endpoint
• your-api-key with your Phoenix API key

Using the Phoenix MCP Server

The MCP server can be used to interact with Prompts, Experiments, and Datasets. It can be used to retrieve information about each item, and can create and update Prompts.

Some good questions to try:

1. What prompts do I have in Phoenix?

2. Create a new prompt in Phoenix that classifies user intent

3. Update my classification prompt in Phoenix with these new options

4. Summarize the Phoenix experiments run on my agent inputs dataset

5. Visualize the results of my jailbreak dataset experiments in Phoenix

Hoping to see additional functionality?

@arizeai/phoenix-mcp is open-source! Issues and PRs welcome.

https://github.com/Arize-ai/phoenix/tree/main/js/packages/phoenix-mcp