Braintrust MCP server

Deprecation Notice: This package is deprecated. Braintrust now maintains a hosted MCP server at:

https://api.braintrust.dev/mcp

See the current setup guide: https://www.braintrust.dev/docs/integrations/developer-tools/mcp

Stdio compatibility shim

Use this package only for MCP clients that still require a local stdio command. The command forwards MCP JSON-RPC requests to the hosted Braintrust MCP server and exposes exactly the hosted server's tools and resources.

{
  "mcpServers": {
    "braintrust": {
      "command": "npx",
      "args": ["-y", "@braintrust/mcp-server@latest"],
      "env": {
        "BRAINTRUST_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

You can also pass the API key as a command argument:

{
  "mcpServers": {
    "braintrust": {
      "command": "npx",
      "args": [
        "-y",
        "@braintrust/mcp-server@latest",
        "--api-key",
        "YOUR_API_KEY"
      ]
    }
  }
}

Configuration

The shim supports:

• BRAINTRUST_API_KEY or --api-key: Braintrust API key used as a bearer token.
• BRAINTRUST_MCP_URL or --url: MCP endpoint to forward to.

The default URL is https://api.braintrust.dev/mcp.

For the EU data plane, use:

https://api-eu.braintrust.dev/mcp

For self-hosted Braintrust, set BRAINTRUST_MCP_URL or --url to your own /mcp endpoint.

OAuth is not implemented in this compatibility shim. If your MCP client supports OAuth or remote MCP servers, configure it to connect directly to the hosted Braintrust MCP endpoint.