Braintrust

Overview

Braintrust MCP exposes Braintrust projects, experiments, datasets, prompts, logs, and documentation to MCP clients.

Endpoints

• US: https://api.braintrust.dev/mcp
• EU: https://api-eu.braintrust.dev/mcp
• Self-hosted: point your client at your own Braintrust API URL at /mcp

Authentication

• API-key auth: send Authorization: Bearer ... with your Braintrust API key.
• OAuth 2.0: supported by OAuth-capable MCP clients when no bearer header is supplied.

Transport

• Streamable HTTP only.
• SSE-only MCP clients will not work with the Braintrust server.

Available tools

• search_docs
• resolve_object
• list_recent_objects
• infer_schema
• sql_query
• summarize_experiment
• generate_permalink

Available resources

• docs://sdk-install
• docs://sql
• docs://url-formats
• docs://experiments

Setup examples

• Claude Code: claude mcp add --transport http braintrust https://api.braintrust.dev/mcp --header "Authorization: Bearer $BRAINTRUST_API_KEY"
• Claude Desktop, VS Code, Cursor, Devin Desktop, Zed, and other MCP-capable clients can connect to the hosted URL and authenticate with OAuth or a bearer header, depending on client support.
• Codex: set BRAINTRUST_API_KEY and configure ~/.codex/config.toml to point at the Braintrust MCP URL.

Prerequisites

A Braintrust account, either a Braintrust API key or an OAuth-capable MCP client, outbound network access to Braintrust domains, and an MCP client that supports Streamable HTTP.

Self-hosted

For self-hosted Braintrust, point the client at your own /mcp endpoint and set MCP_SERVER_URL for OAuth discovery. Terraform deployments handle this automatically.

Troubleshooting

• Verify the URL has no trailing slash.
• Allowlist api.braintrust.dev and *.braintrust.dev.
• Check that your MCP client supports remote Streamable HTTP servers.
• Restart the client after changing the configuration.

Limitations

The Braintrust MCP server is documented as a hosted service. No public source repository for the hosted server was linked in the Braintrust docs reviewed.