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

# Braintrust

> Access Braintrust docs, logs, and AI datasets

The Braintrust MCP Server gives AI agents within Caylex direct, programmatic access to both Braintrust and OpenAI documentation alongside live Braintrust project data, enabling end-to-end workflows for experimentation, observability, and debugging. Agents can search documentation, resolve and list Braintrust objects (such as experiments, datasets, and logs), infer data schemas, run SQL queries against Braintrust data, summarize experiment results, and generate shareable permalinks — all without leaving the Caylex environment. This makes it well-suited for teams that need their AI agents to autonomously analyze evaluation runs, triage production issues, or assist developers in integrating and extending Braintrust-powered pipelines. By bridging documentation lookup with live data access, the server supports both exploratory and operational use cases in a single connection.

<Warning>
  **Prerequisites:**

  * A Braintrust account with at least one project is required to access live data tools such as experiment summaries, SQL queries, and object resolution.
  * A Braintrust API key with read access to the relevant projects must be available to authenticate the server connection in Caylex.
  * Teams on a self-hosted Braintrust deployment must know their custom data plane URL to correctly configure the server.
</Warning>

<Note>
  **Important API details:**

  * A valid Braintrust API key is required to access live project data such as experiments, datasets, and logs; documentation search does not require authentication.
  * SQL queries are executed against Braintrust's internal data plane — teams using a self-hosted Braintrust data plane must configure the server to point to their custom data plane endpoint rather than the default cloud endpoint.
  * Object resolution and listing tools operate within the scope of the authenticated user's Braintrust organization and project permissions.
  * Permalink generation produces URLs tied to the authenticated user's Braintrust organization, so generated links will only be accessible to users with appropriate access to that organization.
</Note>

## Server Details

| Property        | Value                                                            |
| --------------- | ---------------------------------------------------------------- |
| **Transport**   | Streamable HTTP                                                  |
| **Server Type** | External                                                         |
| **Endpoint**    | [https://api.braintrust.dev/mcp](https://api.braintrust.dev/mcp) |
| **Categories**  | API Tools & Services, Development & DevOps                       |

## Authentication

This server supports the following authentication methods:

### OAuth

**Scopes:** `mcp`

During the server onboarding flow, you will be prompted to complete the OAuth flow to grant access. See the [Braintrust Authentication guide](/oauth-guides/braintrust) for step-by-step credential configuration.

### Header Authentication

This server authenticates via HTTP headers. During the server onboarding flow, you will be prompted to confirm the required headers. Note that you do not provide the values for the headers during the server on-boarding.
Header values are provided by the users during the [Auth Link](/auth/auth-links) flow.

## Server Configuration

The following parameters can be set in the server URL when adding this server to your Caylex project:

| Parameter | Type  | Description                                                                                                                                                                           | Example                                        |
| --------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| `api_url` | query | Override the default Braintrust API/data plane URL for organizations using a self-hosted Braintrust deployment. Without this, the server defaults to the Braintrust cloud data plane. | `https://your-braintrust-instance.example.com` |

## Getting Started

<Steps>
  <Step title="Add the server">
    Navigate to the **Server Library** and click on the **New Server** button. Find **Braintrust** in the Caylex Catalog.
  </Step>

  <Step title="Server Onboarding flow">
    Go through the server onboarding flow.
  </Step>

  <Step title="Use in a project">
    Add the server to a [project](https://app.caylex.dev/projects) by configuring project connections. Its tools are now available to any agents connected to that project.
  </Step>
</Steps>

## Related Servers

<CardGroup cols={2}>
  <Card title="Datadog" href="/server-catalog/datadog" icon="https://d338mlbnszozgc.cloudfront.net/logos/datadog.svg" />

  <Card title="Posthog" href="/server-catalog/posthog" icon="https://d338mlbnszozgc.cloudfront.net/logos/posthog.svg" />
</CardGroup>

## References

<CardGroup cols={1}>
  <Card title="https://www.braintrust.dev/docs/reference/mcp" href="https://www.braintrust.dev/docs/reference/mcp" icon="arrow-up-right-from-square" />

  <Card title="https://www.braintrust.dev/docs/kb/configure-mcp-server-with-self-hosted-data-plane" href="https://www.braintrust.dev/docs/kb/configure-mcp-server-with-self-hosted-data-plane" icon="arrow-up-right-from-square" />
</CardGroup>