> ## Documentation Index
> Fetch the complete documentation index at: https://arize-ax.mintlify.site/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Coding agent setup
> Use AI coding agents like Cursor, Claude Code, and Copilot to set up and work with Arize AX via skills, MCP servers, or a single URL.
You're using a coding agent — Cursor, Claude Code, Copilot, Windsurf, or something else — and you want it to know how to work with Arize AX. Here's how:
* **[One command](#one-command-setup)** — run `npx evals` and your agent handles the account, tooling, and instrumentation
* **[Paste-and-Go](#paste-and-go-tracing-setup)** — paste a single URL, agent does the rest
* **[Skills](/docs/ax/skills/overview)** — teach your agent the full Arize workflow: tracing, datasets, experiments, evals, prompt optimization, and more
* **[MCP Servers](#mcp-servers)** — persistent IDE integration for instrumentation help and doc lookups
* **[Copy Docs](#copy-docs-to-your-agent)** — paste any docs page as markdown into your agent for context
***
# One Command Setup
The shortest path from zero to your first traces.
```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
npx evals
```
Select your coding agent. From there your agent:
1. Installs the [AX CLI](/docs/api-clients/cli/overview) and the [Arize Skills](/docs/ax/skills/overview).
2. Creates a free Arize AX account or signs you in to an existing account.
3. Instruments what you choose: an app in the current folder, an existing app at a path you provide, a starter app it creates for you, or [the coding agent itself](/docs/ax/cookbooks/instrument/tracing-coding-agents).
4. Runs your app and confirms the first spans reached your project.
**No Node.js?** Use the installer for your OS:
```bash macOS / Linux theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
bash <(curl -fsSL https://cdn.jsdelivr.net/npm/evals/start.sh)
```
```powershell Windows theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
irm https://cdn.jsdelivr.net/npm/evals/start.ps1 | iex
```
Already have an account and credentials? Use [Paste-and-Go](#paste-and-go-tracing-setup) to instrument without the account and tooling steps, or install the [skills](/docs/ax/skills/install) directly.
***
# Paste-and-Go Tracing Setup
Instrumentation only, for when you already have an Arize AX account and credentials. Paste this into your coding agent and it handles dependency installation, instrumentation, and configuration:
**Paste this into your coding agent:**
```
Follow the instructions from https://arize.com/docs/PROMPT.md and ask me questions as needed.
```
The agent scans your codebase, detects your language and frameworks, proposes an instrumentation plan, and implements it once you approve. Supports Python, TypeScript/JavaScript, and Java across [30+ integrations](/docs/ax/integrations).
This prompt covers instrumentation only — it assumes you already have an account, credentials, and any tooling you want. If you need those too, use [one command setup](#one-command-setup). For more control, use the [arize-instrumentation skill](/docs/ax/skills/catalog) instead.
***
# Skills
[Arize Skills](/docs/ax/skills/overview) teach your agent the full Arize AX workflow — add tracing, export traces, create datasets, run experiments, set up evaluators, manage annotations, optimize prompts — all through natural language. They work with Cursor, Claude Code, Codex, Windsurf, and [40+ other agents](https://github.com/vercel-labs/skills#supported-agents).
What skills are and when to reach for them.
CLI, credentials, and the four install paths.
Every skill and what it does.
***
# MCP Servers
Two MCP servers you can plug into your IDE for persistent access to instrumentation guidance and documentation.
| Server | Best for | What it does |
| --------------------------------------------------------------------------------- | --------------- | -------------------------------------------------------------------- |
| **Tracing Assistant** ([PyPI](https://pypi.org/project/arize-tracing-assistant/)) | Instrumentation | Framework-specific examples, code analysis, direct Arize support |
| **Docs MCP Server** | Reference | Search all Arize AX docs, examples, and API references from your IDE |
## Install `uv`
The Tracing Assistant requires [uv](https://github.com/astral-sh/uv) (a fast Python package manager). The Docs Server needs no installation.
```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
pip install uv # or: brew install uv
```
```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
curl -LsSf https://astral.sh/uv/install.sh | sh
```
```powershell theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
```
## Add to Your IDE
### Cursor
Navigate to `Settings` → `MCP` → **Add new global MCP server**, then add the JSON config:
```json theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
"arize-tracing-assistant": {
"command": "uvx",
"args": ["arize-tracing-assistant@latest"]
}
```
```json theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
"arize-ax-docs": {
"url": "https://arize.com/docs/mcp"
}
```
### Claude Code
```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
claude mcp add arize-tracing-assistant uvx arize-tracing-assistant@latest
```
```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
claude mcp add arize-ax-docs --transport http https://arize.com/docs/mcp
```
Verify with `claude mcp list`.
### Gemini CLI
```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
gemini extensions install https://github.com/Arize-ai/arize-tracing-assistant
```
```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
gemini mcp add arize-ax-docs https://arize.com/docs/mcp
```
### Antigravity (Google)
Open the MCP Store panel (from the `...` dropdown in the editor's side panel), search "Arize", and click Install. Alternatively, add the Tracing Assistant JSON config manually via **Manage MCP Servers** → **View raw config**.
### Claude Desktop / Manual Config
Add to your `mcpServers` JSON config (`Settings` → `Developer` → `Edit Config` in Claude Desktop):
```json theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
"arize-tracing-assistant": {
"command": "uvx",
"args": ["arize-tracing-assistant@latest"]
}
```
```json theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
"arize-ax-docs": {
"url": "https://arize.com/docs/mcp"
}
```
**Troubleshooting:** Run `uv cache clean` to reset cached versions, or start the server manually with `uvx arize-tracing-assistant@latest` to see errors. Debug with `npx @modelcontextprotocol/inspector uvx arize-tracing-assistant@latest`.
***
# Copy Docs to Your Agent
Every page in these docs has a **copy as markdown** button — paste it directly into ChatGPT, Claude, or any coding agent for accurate, up-to-date context.
