How do I check if my Braintrust API key is valid?

The skill provides a specific curl command to test the Braintrust API self/me endpoint; a valid key returns user and organization JSON data.

Where can I get a Braintrust API key?

You can create and manage your API keys within the Braintrust app settings at https://www.braintrust.dev/app/settings?subroute=api-keys.

What environment variable does this skill require?

This skill requires the BRAINTRUST_API_KEY environment variable to be set to establish the MCP connection.

What does a connection timeout to the MCP server mean?

A timeout or 'connection refused' error typically indicates that the Braintrust MCP server may be temporarily down or unreachable from your network.

Braintrust MCP Troubleshooter

Name: Braintrust MCP Troubleshooter
Author: braintrustdata

bybraintrustdata

•

Developer Tools

Diagnoses and resolves configuration issues for the Braintrust Model Context Protocol connection in Claude Code.

This skill streamlines the setup and debugging of the Braintrust MCP server within your Claude environment. It automatically attempts to configure the connection using your BRAINTRUST_API_KEY and provides a structured troubleshooting workflow to verify environment variables, validate API credentials, and check the reachability of Braintrust’s MCP endpoints. It is an essential tool for developers experiencing connectivity issues or those setting up Braintrust with Claude for the first time to ensure their AI has full access to Braintrust's evaluation and data tools.

Key Features

01Environment variable verification for BRAINTRUST_API_KEY

02MCP server reachability and HTTP status checks

03Automatic configuration of the Braintrust MCP server

04API credential validation via direct endpoint testing

0510 GitHub stars

06Direct links to official Discord and email support channels

Use Cases

01Debugging connection timeouts or authentication errors during development

02Verifying the validity and organization permissions of a Braintrust API key

03Initial setup and configuration of the Braintrust MCP integration

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add braintrustdata/braintrust-claude-plugin troubleshoot-braintrust-mcp

For use in Claude.ai and ChatGPT

Download Skill