---
title: "9apes MCP Server - Ask AI Assistants About Your CI"
description: "Connect Claude, Claude Code, Codex, or any MCP client to the 9apes MCP server for read-only GitHub Actions run, job, and step analytics."
url: https://9apes.com/docs/mcp-server/
---

# 9apes MCP Server - Ask AI Assistants About Your CI

The 9apes MCP server lets an AI assistant read the GitHub Actions data 9apes already collects for your organization: runs, jobs, steps, and their durations. Ask it why a build got slower, which jobs take the longest, or how this week compares with last week.

It is read-only. It cannot start, cancel, or change jobs, runners, billing, or account settings.

## Server URL

```text
https://api.9apes.com/mcp
```

The server speaks Streamable HTTP and signs you in with OAuth in the browser. There is no API key to copy and no local process to run.

## What you need

- A 9apes account with GitHub runs flowing through it. See [Quick Start](https://9apes.com/docs/quick-start/) if you have not moved a job yet.
- Membership in the 9apes organization whose CI you want to analyze.
- An MCP client that supports remote servers over HTTP with OAuth: Claude, Claude Code, Codex, or another compatible client.

## Connect your client

### Claude Code

```sh
claude mcp add --transport http 9apes https://api.9apes.com/mcp
```

Then open `/mcp` in Claude Code, select **9apes**, and complete the browser sign-in.

### Claude (web and desktop)

1. Open **Settings → Connectors** and choose **Add custom connector**.
2. Name it `9apes` and enter `https://api.9apes.com/mcp` as the URL.
3. Select **Connect** and complete the browser sign-in.

On Team and Enterprise plans, an owner may need to allow custom connectors first.

### Codex

```sh
codex mcp add 9apes --url https://api.9apes.com/mcp
codex mcp login 9apes
```

Complete the browser sign-in, then check `/mcp` in the Codex terminal UI.

### Other clients

Point any client that supports remote MCP servers with OAuth at `https://api.9apes.com/mcp`. The server publishes standard OAuth discovery metadata at `https://api.9apes.com/.well-known/oauth-protected-resource`, so clients register themselves and start the sign-in for you.

Clients and registries that support [MCP Server Cards](https://github.com/modelcontextprotocol/ext-server-card) can read the endpoint and supported protocol versions from the [9apes server card](https://9apes.com/docs/mcp-server/server-card.json). It is also listed in the site's [AI catalog](https://9apes.com/.well-known/ai-catalog.json).

## Sign in and choose an organization

The first time a client connects, your browser opens a 9apes page:

1. Sign in to 9apes, using GitHub sign-in if you are not already signed in.
2. Check the address the page says it will send access to. It should be the client you just connected, for example `claude.ai`, or `127.0.0.1` for a client on your computer.
3. Pick one organization and select **Allow read access**.

The connection grants two read scopes:

| Scope | Allows |
| --- | --- |
| `runners:read` | The connected organization, your identity, and the GitHub App connection status |
| `analytics:read` | Run, job, and step analytics |

> **One organization per connection:** A connection is bound to the organization you picked, and every call rechecks that you are still a member. To analyze a different organization, add a second connection and pick that organization during sign-in.

To disconnect, remove the server or connector in your client. Removing your membership in the organization also stops access on the next call.

## Check the connection

Ask your assistant:

> Use 9apes to show which organization I'm connected to.

It should call `9apes_get_context` and name your organization. If it doesn't, see [Troubleshooting](#troubleshooting).

## Things to ask

- "Which five jobs had the highest P95 duration on `main` over the last 7 days?"
- "Compare run durations for the `backend` repository this week against last week."
- "Why was run 1234567890 slow? Break it down by job and step."
- "Write a CI performance summary for my engineering lead covering the last 30 days."

The [agent skill](https://9apes.com/docs/mcp-server/skill/) teaches an assistant how to turn these into precise tool calls and well-sourced reports.

## Troubleshooting

- **The browser page says "Authorization expired".** Restart the connection from your client; each sign-in link is valid for 10 minutes.
- **You see the wrong organization, or none.** You may have picked a different organization during sign-in, or you may not be a member of an active organization. Reconnect and pick again.
- **Tools return empty results.** Check the time window and filters first. The server only sees runs 9apes received from GitHub; it cannot see jobs that ran on other runners.
- **Claude web cannot connect.** Custom connectors may be disabled for your Claude organization; ask an owner to allow them.

For anything else, email [support@9apes.com](mailto:support@9apes.com).

## Next

- [Tools reference](https://9apes.com/docs/mcp-server/tools/): Every tool, its inputs, limits, and how to read the results.
- [Agent skill](https://9apes.com/docs/mcp-server/skill/): Install the 9apes-ci skill so assistants use the tools well.