\n\nPhoenix MCP Server is an implementation of the Model Context Protocol for the Arize Phoenix platform. It provides a unified interface to Phoenix's capabilities.\n\nYou can use Phoenix MCP Server for:\n\n- **Projects Management**: List and explore projects that organize your observability data\n- **Traces, Spans & Annotations**: Retrieve traces, spans, and annotation configs for analysis and debugging\n- **Sessions**: Explore conversation flows and session-level annotations\n- **Prompts Management**: Create, list, update, and iterate on prompts\n- **Datasets**: Explore datasets and synthesize new examples\n- **Experiments**: Pull experiment results and visualize them with the help of an LLM\n\nDon't see a use-case covered? `@arizeai/phoenix-mcp` is [open-source](https://github.com/Arize-ai/phoenix)! Issues and PRs welcome.\n\n## Installation\n\nThis MCP server can be used with `npx` and can be directly integrated with clients like Claude Desktop, Cursor, and more.\n\n```json\n{\n \"mcpServers\": {\n \"phoenix\": {\n \"command\": \"npx\",\n \"args\": [\n \"-y\",\n \"@arizeai/phoenix-mcp@latest\",\n \"--baseUrl\",\n \"https://my-phoenix.com\",\n \"--apiKey\",\n \"your-api-key\"\n ]\n }\n }\n}\n```\n\n## Development\n\n## Install\n\nThis package is managed via a pnpm workspace.\n\n```sh\n// From the /js/ directory\npnpm install\npnpm build\n```\n\nThis only needs to be repeated if dependencies change or there is a change to the phoenix-client.\n\n### Building\n\nTo build the project:\n\n```sh\npnpm build\n```\n\n### Development Mode\n\nTo run in development mode:\n\n```bash\npnpm dev\n```\n\n### Debugging\n\nYou can build and run the MCP inspector using the following:\n\n```bash\npnpm inspect\n```\n\n## Environment Variables\n\nWhen developing, the server requires the following environment variables:\n\n- `PHOENIX_API_KEY`: Your Phoenix API key\n- `PHOENIX_ENDPOINT`: The base URL for Phoenix\n- `PHOENIX_PROJECT`: Optional default project for project-scoped tools (alias: `PHOENIX_PROJECT_NAME`)\n- `PHOENIX_CLIENT_HEADERS`: Optional JSON-encoded request headers\n\nMake sure to set these in a `.env` file. See `.env.example`.\n\nAt runtime the server also discovers the nearest `.env.phoenix` file at or\nabove the working directory. Process environment variables and command-line\noptions take precedence. If a higher-priority API key is paired with an\nendpoint from the file, the server warns once and continues. Set\n`PHOENIX_DISCOVER_CONFIG=false` to disable discovery.\n\n## Tool Coverage\n\nThe MCP server covers the main operational Phoenix workflows:\n\n**Prompts** — `list-prompts`, `get-prompt`, `get-latest-prompt`, `get-prompt-by-identifier`, `get-prompt-version`, `list-prompt-versions`, `get-prompt-version-by-tag`, `list-prompt-version-tags`, `add-prompt-version-tag`, `upsert-prompt`\n\n**Projects** — `list-projects`, `get-project`\n\n**Traces** — `list-traces`, `get-trace`\n\n**Spans** — `get-spans`, `get-span-annotations`\n\n**Sessions** — `list-sessions`, `get-session`\n\n**Annotation Configs** — `list-annotation-configs`\n\n**Datasets** — `list-datasets`, `get-dataset`, `get-dataset-examples`, `get-dataset-experiments`, `add-dataset-examples`\n\n**Experiments** — `list-experiments-for-dataset`, `get-experiment-by-id`\n\nFor Phoenix documentation search, use the separate Phoenix Docs MCP server instead of this package.\n\n## Community\n\nJoin our community to connect with thousands of AI builders:\n\n- 🌍 Join our [Slack community](https://join.slack.com/t/arize-ai/shared_invite/zt-3r07iavnk-ammtATWSlF0pSrd1DsMW7g).\n- 📚 Read the [Phoenix documentation](https://arize.com/docs/phoenix).\n- 💡 Ask questions and provide feedback in the _#phoenix-support_ channel.\n- 🌟 Leave a star on our [GitHub](https://github.com/Arize-ai/phoenix).\n- 🐞 Report bugs with [GitHub Issues](https://github.com/Arize-ai/phoenix/issues).\n- 𝕏 Follow us on [𝕏](https://twitter.com/ArizePhoenix).\n- 💼 Follow us on [LinkedIn](https://www.linkedin.com/showcase/113218220).\n- 🗺️ Check out our [roadmap](https://github.com/orgs/Arize-ai/projects/45) to see where we're heading next.\n\n## License\n\nApache 2.0\n","readmeFilename":""}
![\"Arize](\"https://raw.githubusercontent.com/Arize-ai/phoenix-assets/refs/heads/main/logos/Phoenix/phoenix.svg\")
\n ![\"NPM](\"https://img.shields.io/npm/v/%40arizeai%2Fphoenix-mcp\")
\n ![\"License\"](\"https://img.shields.io/badge/License-Apache_2.0-blue.svg\"){kind=icon}
\n ![\"Add](\"https://cursor.com/deeplink/mcp-install-dark.svg\"){kind=small}
\n ![](\"https://static.scarf.sh/a.png?x-pxid=8e8e8b34-7900-43fa-a38f-1f070bd48c64&page=js/packages/phoenix-mcp/README.md\")
\n