> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sphynx.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Sphynx MCP

> Start and read evals from an MCP client

Connect to the hosted server:

<CodeGroup>
  ```json Claude Desktop theme={null}
  {
    "mcpServers": {
      "sphynx": { "url": "https://mcp.sphynx.sh/mcp" }
    }
  }
  ```

  ```bash Claude Code theme={null}
  claude mcp add --transport http sphynx https://mcp.sphynx.sh/mcp
  ```
</CodeGroup>

The server uses OAuth 2.1. Your browser opens to sign in and approve access, so the MCP configuration holds no API key. Reading evals needs `evals:read`. Starting a batch needs `evals:write`.

## Eval tools

| Tool | Purpose |
| - | - |
| `start_suite_batch` | Start a batch: every case of a suite on every variant |
| `start_case_batch` | Start a batch that runs a stored case's newest version on the variant ids named, or on every variant it has run on |
| `get_batch` | Read a batch with its runs and their trials |
| `list_batches` | List batches, newest first |
| `list_cases` | List cases, optionally in one suite or with one tag |
| `get_case` | Read a case, its versions and the variants it has run on, with their ids |
| `list_runs` | List a case's runs, newest first, optionally on one variant |
| `get_run` | Read one run and its trials |
| `list_models` | List the models a harness can use |

`start_suite_batch` and `start_case_batch` return the batch ID and one run ID per case per variant right away. Poll `get_batch` until its `status` is no longer `running`. `start_case_batch` runs 1 trial unless you pass `trials`.

`list_batches` and `list_cases` return `next`. Pass it as `cursor` to read the following page.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.