This documentation is available as Markdown for AI agents and LLMs. See the full Markdown index or append .md to any documentation URL.

Analyze EAS Observe data with AI

Edit page

Let an AI agent query and interpret EAS Observe metrics, events, errors, and sessions through the Expo MCP Server or the EAS CLI.


The EAS Observe dashboard and the eas observe commands show the metrics, events, errors, and sessions your app sends. An AI agent can read the same data and do the analysis for you: compare releases, find the slowest sessions, and explain what the slow ones have in common.

There are two ways to give an agent access to your data:

  • Expo MCP Server: the agent calls the Expo Model Context Protocol (MCP) Server directly. It works in Claude, Claude Code, Codex, Cursor, and VS Code. The agent does not need terminal access.
  • EAS CLI: the agent runs eas observe commands in your terminal. It covers everything the CLI covers, including errors, and the eas-observe skill teaches the agent how to use it.

You can set up both. An agent with both reads metrics through the server and falls back to the CLI for errors and scripts.

Either way, your app must already send data. Follow Get started first if it does not.

Option 1: Expo MCP Server

The Expo MCP Server exposes read-only tools for app versions, metric summaries, metric samples, routes, user-defined events, and session timelines. The agent signs in with your Expo account, so it needs no access token. Each tool call counts toward your account's Expo MCP Server usage. Plan limits are the same as in the dashboard and the EAS CLI. See Tools for the current list.

Add the Expo connector to your Claude account. It works on the web, desktop, and mobile apps, with no installation on your machine.

To verify the setup, open the agent in your project directory and ask:

Example prompt
Which versions of my app has EAS Observe seen in the last 7 days?

The agent replies with the app versions and their event counts. When the agent does not run inside the project directory, name the project in the prompt, such as @owner/my-app.

The server has no tool that lists errors yet. Use the EAS CLI to find them. A session timeline from the server still includes the errors from that session.

Option 2: EAS CLI

An agent that can run terminal commands, such as Claude Code, Codex, or Cursor, can use the eas observe commands directly. Install the EAS CLI and log in:

Terminal
- npm install --global eas-cli

- eas login
- yarn global add eas-cli

- eas login
- pnpm add --global eas-cli

- eas login
- bun add --global eas-cli

- eas login

Then install the eas-observe skill. It teaches the agent the commands, their flags, and what each metric means. It also shows the agent how to tell a slow launch caused by code from one caused by device or network conditions:

eas-observe

Set up expo-observe, query metrics and errors with the EAS CLI, and interpret startup and navigation performance data.

The Claude Code and Codex plugins from Option 1 include the skill. For other agents, install it with the skills CLI:

Terminal
- npx skills add expo/skills
- yarn dlx skills add expo/skills
- pnpm dlx skills add expo/skills
- bunx skills add expo/skills

With --json, each command returns machine-readable output and fails instead of waiting for a prompt. The skill describes the JSON output of the commands.

Example prompts

Ask questions the way you would ask a colleague. The agent picks the tools or commands, fills in the project, platform, and time range, and chains several calls when one answer depends on another.

  • "Did startup get slower in the latest iOS release?"
  • "Find the five slowest cold launches this week and tell me what those devices have in common."
  • "Which routes have the worst time to interactive on Android?"
  • "How many users completed onboarding since the last update?"
  • "How long do over-the-air updates take to download on cellular?"

Give the agent a version, a platform, and a time range when you have them, and say what a useful answer looks like:

Investigate a slow launch
TTI on iOS got slower in 2.4.0. Find the slowest samples, tell me whether the cause looks like code or conditions, and show me one session that explains it.
Compare two releases
Compare cold launch, warm launch, and TTI between versions 2.3.0 and 2.4.0 on Android over the last 3 days. Flag any metric where p90 got worse by more than 10%.
Triage errors (EAS CLI)
List the fatal errors from the last 7 days, then show me the stack trace of the most common one and suggest where in the code it comes from.

You can also start from the dashboard. The Handoff to AI button copies the current page state, including filters, as a prompt. Paste it into the agent and ask follow-up questions. See Handoff to AI.

Next steps

Expo MCP Server

Install the server, authenticate, and see the complete list of tools.

Expo Skills

Browse every Expo skill and the install options for each agent.

Querying with EAS CLI

The eas observe commands, their flags, and common workflows.

Metrics reference

What each startup and navigation metric measures.