Agent skill
troubleshoot-braintrust-mcp
This plugin auto-configures a "braintrust" MCP server. If you can't see it or reach it, activate this skill
Install this agent skill to your Project
npx add-skill https://github.com/braintrustdata/braintrust-claude-plugin/tree/main/plugins/braintrust/skills/troubleshoot-braintrust-mcp
SKILL.md
This Claude plugin automatically sets up a Braintrust MCP connection. The connection reads the BRAINTRUST_API_KEY environment variable to establish the MCP connection.
Troubleshooting steps
1. Verify the environment variable is set
Run echo $BRAINTRUST_API_KEY to check if the variable is exported
API keys can be created at https://www.braintrust.dev/app/settings?subroute=api-keys
2. Verify the API key is valid
Test the key by calling the Braintrust API:
curl -s https://api.braintrust.dev/api/self/me -H "Authorization: Bearer $BRAINTRUST_API_KEY"
- If valid: returns JSON with user info (id, email, organizations, etc.)
- If invalid: returns an authentication error
NOTE: Even if you can curl the api via http, continue to attempt MCP setup. Http is just a troubleshooting tool, not a replacement for MCP
3. Check if the MCP server is reachable
If the key is valid but connection still fails, check if the MCP server is up:
curl -s -o /dev/null -w "%{http_code}" https://api.braintrust.dev/mcp
- Any HTTP response (even 401 or 405) means the server is reachable
- Connection timeout or "connection refused" means the server may be down
4. Contact support
If nothing else works, encourage the user to reach out:
- Discord: https://discord.com/invite/6G8s47F44X
- Email: support@braintrust.dev
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
mattpocock/skills
handoff
Compact the current conversation into a handoff document for another agent to pick up.
mattpocock/skills
obsidian-vault
Search, create, and manage notes in the Obsidian vault with wikilinks and index notes. Use when user wants to find, create, or organize notes in Obsidian.
mattpocock/skills
git-guardrails-claude-code
Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prevent destructive git operations, add git safety hooks, or block git push/reset in Claude Code.
mattpocock/skills
migrate-to-shoehorn
Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.
mattpocock/skills
scaffold-exercises
Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, create exercise stubs, or set up a new course section.
mattpocock/skills
edit-article
Edit and improve articles by restructuring sections, improving clarity, and tightening prose. Use when user wants to edit, revise, or improve an article draft.
Didn't find tool you were looking for?