PlugWiki
phoenix logo

Arize Phoenix MCP Server: Setup for Claude, Cursor and Other Apps

OfficialLocal
Getnpm@arizeai/phoenix-mcparize-ai/phoenix

Lets your assistant read your Arize Phoenix traces, sessions, datasets and experiments, and manage your prompts.

This is Arize's own server for Phoenix, the open source tool for tracing and testing AI apps. It runs on your computer and talks to your Phoenix server, either one you host or Phoenix Cloud. You can find failing traces, check scores on spans, save new prompt versions and add examples to datasets. One tool, phoenix-support, sends your question to a hosted RunLLM support service, so leave it out if you do not want that.

Good for

  • LLM engineers who debug agents by reading traces and spans
  • Prompt engineers who save, tag and compare prompt versions
  • Teams building evaluation datasets and checking experiment results

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install phoenix MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the phoenix MCP server to Claude Code. Run this command:
    
    claude mcp add phoenix -e PHOENIX_ENDPOINT=<PHOENIX_ENDPOINT> -- npx -y @arizeai/phoenix-mcp
    
    Ask me for PHOENIX_ENDPOINT and only put the values in that config, nowhere else.
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Built from the package data we hold. Not yet tested by us.

Tools

  • Lists the projects in your Phoenix

    Returns the projects that organize your traces and other data.

    Try: “What projects do I have in Phoenix?”

    Network · list-projects

  • Shows one project

    Returns details for a single project.

    Try: “Show me the details of project 'checkout-agent'.”

    Network · get-project

  • Lists recent traces in a project

    Lists traces for a project so you can find slow or failing runs.

    Try: “Which traces in 'checkout-agent' failed today?”

    Network · list-traces

  • Shows one trace with its spans

    Returns a single trace so the assistant can walk through what happened.

    Try: “Walk me through trace 4f2a and tell me where it went wrong.”

    Network · get-trace

  • Fetches spans from a project

    Returns spans from a project, optionally narrowed by your filters.

    Try: “Show LLM spans from the last hour that took over 10 seconds.”

    Network · get-spans

  • Shows the scores and notes on spans

    Returns annotations attached to spans, such as evaluation scores and human feedback.

    Try: “What annotations are on these spans?”

    Network · get-span-annotations

  • Lists conversation sessions in a project

    Lists the sessions in a project, which group the traces of one conversation.

    Try: “List the latest sessions in 'support-bot'.”

    Network · list-sessions

  • Shows one session

    Returns a session with its conversation flow and session-level annotations.

    Try: “Show me session 9c1 from start to finish.”

    Network · get-session

  • Lists the annotation types you have set up

    Lists the annotation configs, which define the scores and labels you can attach.

    Try: “What annotation types does my Phoenix use?”

    Network · list-annotation-configs

  • Lists the prompts you manage in Phoenix

    Returns your saved prompts.

    Try: “List my Phoenix prompts.”

    Network · list-prompts

  • Shows one prompt

    Returns a prompt by name.

    Try: “Show me the 'support-reply' prompt.”

    Network · get-prompt

  • Shows the newest version of a prompt

    Returns the most recent version of a prompt.

    Try: “What is the latest version of 'support-reply'?”

    Network · get-latest-prompt

Read from the source code

Permissions

medium risk · 3 things to watch

Medium risk

The server reads your traces and can save prompt versions and dataset examples, with no read-only mode. Traces can contain private user data, and the support tool sends your question to an outside service.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • It can change prompts and datasets

    Three tools save prompt versions, tag them and add dataset examples. There is no read-only switch, so use a key that suits that. github.com

  • The support tool sends your question to a third party

    phoenix-support forwards the question to a RunLLM service. Do not put private data in questions to it. github.com

  • Traces may hold sensitive prompts and outputs

    Trace and span tools pass whatever your app logged to the assistant. Check what your traces contain first. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Talks toYour Phoenix server or Phoenix Cloud. mcp.runllm.com, for the phoenix-support tool
Sign-in and keysA Phoenix API key, when your Phoenix needs one, set in the client's env settings or as a command-line option.

Questions

Is the Phoenix MCP server official?

Yes. Arize publishes it as the @arizeai/phoenix-mcp package inside the Phoenix repository. The package declares the Apache-2.0 license, while the Phoenix repository itself is under the Elastic License 2.0.

Do I need an API key?

Only if your Phoenix needs one. Phoenix Cloud and secured servers do, and a Phoenix without authentication does not. You also set the address of your Phoenix server.

Can it change my Phoenix data?

Yes, in a small way. It can save prompt versions, tag them and add dataset examples. The other tools read. It has no delete tools in its list, and there is no read-only switch.

Does it search the Phoenix docs?

Not with a docs search. The README points to a separate Phoenix Docs MCP server for that. The phoenix-support tool answers product questions through a hosted support service.

Does it work with open-source Phoenix running locally?

Yes. Point the endpoint setting at your Phoenix address, for example the local one, and leave the key out if it has none.

How do I set a default project?

Set the project in the install box settings. Trace, span and session tools then use it unless you name another project.

Information

updated Nov 2, 2026

Publisher
Official
Package
@arizeai/phoenix-mcp
Registry
npm
Transport
stdio
Auth
API key
Version
4.3.19
License
Apache-2.0
Last commit
Oct 31, 2026
Open issues
1,019

WebsiteGitHubnpmChangelogIssues

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 4
  1. github.com · github.com
  2. github.com · github.com
  3. github.com · github.com
  4. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.