Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Observability - official Arize server

Phoenix MCP server

Local npm-distributed MCP server for Arize Phoenix that connects to a Phoenix instance with a base URL and API key. Covers projects, traces, spans, sessions, annotation configs, prompts, datasets and experiments. It runs locally from @arizeai/phoenix-mcp (npm) with API key auth.

Last verified 15 tools5 sources

Install

Generic

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

Tools

list-projects
List Phoenix projects
get-project
Get a single project
list-traces
List traces
get-trace
Get a single trace
get-spans
Retrieve spans
get-span-annotations
Retrieve annotations on spans
list-sessions
List sessions
get-session
Get a single session
list-annotation-configs
List annotation configs
list-prompts
List prompts
upsert-prompt
Create or update a prompt
list-datasets
List datasets
get-dataset-examples
Get examples from a dataset
add-dataset-examples
Add examples to a dataset
get-experiment-by-id
Get experiment results by ID

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Separate from the remote MCP server built into Phoenix 19.0.0+.
  • Arize's docs mark this stdio package as being in maintenance mode: it still gets bug fixes, but new capabilities land in the built-in Remote MCP Server, and Arize says to use this package with Phoenix versions that don't serve the /mcp endpoint.
  • Latest npm version 4.3.16 (2026-10-09).
  • Documented as a generic mcpServers config for Claude Desktop, Cursor and others; the README also offers a Cursor one-click deeplink.
  • The package does not include docs search; Arize points to the separate Phoenix Docs MCP for that.

More MCP servers for observability

Related reading

FAQ

What does the Phoenix MCP server do?

Local npm-distributed MCP server for Arize Phoenix that connects to a Phoenix instance with a base URL and API key. Covers projects, traces, spans, sessions, annotation configs, prompts, datasets and experiments. The vendor documents 15 tools, including list-projects, get-project, list-traces and get-trace.

How do I add the Phoenix MCP server to an MCP client?

Arize documents a Generic config; copy it from the Generic section of this page.

Does the Phoenix MCP server need authentication?

Yes, API key. Transport: stdio. Status: GA, last checked October 17, 2026.

Sources

Last verified against 5 Arize pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.