
Arize Phoenix MCP Server: Setup for Claude, Cursor and Other Apps
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.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install phoenix MCP
Claude Code
- 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
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-projectsShows one project
Returns details for a single project.
Try: “Show me the details of project 'checkout-agent'.”
Network ·
get-projectLists 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-tracesShows 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-traceFetches 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-spansShows 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-annotationsLists 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-sessionsShows one session
Returns a session with its conversation flow and session-level annotations.
Try: “Show me session 9c1 from start to finish.”
Network ·
get-sessionLists 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-configsLists the prompts you manage in Phoenix
Returns your saved prompts.
Try: “List my Phoenix prompts.”
Network ·
list-promptsShows one prompt
Returns a prompt by name.
Try: “Show me the 'support-reply' prompt.”
Network ·
get-promptShows 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-promptFinds a prompt by its identifier
Returns a prompt using its identifier.
Try: “Get the prompt with this identifier.”
Network ·
get-prompt-by-identifierShows one prompt version
Returns a specific version of a prompt.
Try: “Show version 3 of 'support-reply'.”
Network ·
get-prompt-versionLists all versions of a prompt
Returns the version history of a prompt.
Try: “How has 'support-reply' changed over time?”
Network ·
list-prompt-versionsFinds the prompt version that carries a tag
Returns the prompt version with a given tag, such as production.
Try: “Which version of 'support-reply' is tagged production?”
Network ·
get-prompt-version-by-tagLists the tags on a prompt version
Returns the tags attached to a prompt version.
Try: “What tags does this prompt version have?”
Network ·
list-prompt-version-tagsAdds a tag to a prompt version
Tags a prompt version, for example to mark it as production.
Try: “Tag version 4 of 'support-reply' as staging.”
Write ·
add-prompt-version-tagCreates a prompt or saves a new version of it
Creates a prompt, or adds a new version when it exists. You set the template, model provider, model name and temperature.
Try: “Save a new version of 'support-reply' with a friendlier tone.”
Write ·
upsert-promptLists your datasets
Returns the datasets in your Phoenix.
Try: “What datasets do I have?”
Network ·
list-datasetsShows one dataset
Returns details of a dataset.
Try: “Show me the 'refund-questions' dataset.”
Network ·
get-datasetShows the examples in a dataset
Returns the input and output examples stored in a dataset.
Try: “Show me 10 examples from 'refund-questions'.”
Network ·
get-dataset-examplesLists the experiments run on a dataset
Returns experiments linked to a dataset.
Try: “Which experiments ran on 'refund-questions'?”
Network ·
get-dataset-experimentsAdds new examples to a dataset
Adds input and output examples, with optional metadata, to a dataset in Phoenix.
Try: “Add these five tricky questions to 'refund-questions'.”
Write ·
add-dataset-examplesLists experiments for a dataset
Returns the experiments that were run against a dataset.
Try: “List the experiments for 'refund-questions'.”
Network ·
list-experiments-for-datasetShows the results of one experiment
Returns an experiment's results so the assistant can compare them.
Try: “Summarize the results of experiment 12.”
Network ·
get-experiment-by-idAnswers questions about Phoenix and OpenInference using Arize's support assistant
Sends your question to a hosted RunLLM support service at mcp.runllm.com and returns its answer. It covers tracing, datasets, experiments, prompts, evals and annotations. Your question leaves your machine and goes to that service.
Try: “How do I send traces from my LangChain app to Phoenix?”
Network ·
phoenix-support
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 to | Your Phoenix server or Phoenix Cloud. mcp.runllm.com, for the phoenix-support tool |
|---|---|
| Sign-in and keys | A 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
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 4Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com
- github.com · github.com