Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Observability - official Braintrust server

Braintrust MCP server

Hosted MCP server that lets AI tools read and write Braintrust data: query logs, experiments and datasets with SQL, author prompts and scorers, configure dashboards, alerts and Topics, and run evals. Write tools act with the permissions of the authenticated account. Braintrust hosts it at https://api.braintrust.dev/mcp with OAuth or API key auth.

Last verified 15 tools2 sources

Install

Cursor

About Cursor
JSON
{
  "mcpServers": {
    "braintrust": {
      "url": "https://api.braintrust.dev/mcp"
    }
  }
}

Tools

sql_query
Query experiments, datasets, and logs using SQL.
infer_schema
Discover available fields, data types, and most common values in experiments, datasets, or logs.
summarize_experiment
Get aggregated performance metrics for an experiment, optionally compared to a baseline.
list_recent_objects
List recently created projects, experiments, datasets, prompts, or functions you have access to.
resolve_object
Convert names to IDs or vice versa, and parse Braintrust URLs.
generate_permalink
Generate a direct web link to a Braintrust object for sharing or bookmarking.
get_trace_work_items
Return meaningful LLM, tool, function, and task spans of a trace in chronological order.
search_patterns
Search existing project patterns by text, semantic similarity, ID, status, or quality.
generate_monitor_chart
Preview a monitor chart for project logs without modifying a saved view.
create_monitoring_view
Create a project-scoped monitor view, optionally containing previewed charts.
create_threshold_alert
Create an alert for an aggregate over a recent window of project data, evaluated on a schedule.
create_prompt
Create a versioned prompt from a completion-style prompt or chat messages.
create_evaluator
Create a versioned LLM or inline code evaluator.
run_eval
Run an experiment with a hosted dataset, inline rows, or a prior experiment as input, plus saved or inline scorers.
search_docs
Search Braintrust documentation for guides, API references, and code examples.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Remote only, nothing to install.
  • EU data-plane endpoint is https://api-eu.braintrust.dev/mcp; self-hosted deployments use the MCP URL shown in Settings > Data plane.
  • Streamable HTTP only; SSE-only clients cannot connect.
  • OAuth uses dynamic client registration; API keys are sent as a bearer token.
  • The earlier braintrust plugins for Claude Code and Codex are retired in favour of native MCP configuration.
  • Braintrust docs give no verbatim config for Claude Code, Codex or VS Code; they link to each client's own MCP guide and give only the endpoint and auth header.
  • The Cursor snippet is the docs' OAuth manual config for ~/.cursor/mcp.json (sign in by asking the agent, or agent mcp login braintrust in the Cursor CLI); the docs' API-key variant adds "headers": { "Authorization": "Bearer ${env:BRAINTRUST_API_KEY}" }.
  • A Braintrust plugin for Cursor (US data plane, API key) can also add the server.
  • Docs list 40+ tools (15 shown). run_eval and Topics rewinds incur compute/model usage.
  • Docs carry no beta or preview label and no GA statement.

More MCP servers for observability

Related reading

FAQ

What does the Braintrust MCP server do?

Hosted MCP server that lets AI tools read and write Braintrust data: query logs, experiments and datasets with SQL, author prompts and scorers, configure dashboards, alerts and Topics, and run evals. Write tools act with the permissions of the authenticated account. The vendor documents 15 tools, including sql_query, infer_schema, summarize_experiment and list_recent_objects.

How do I add the Braintrust MCP server to Cursor?

Braintrust documents a Cursor config; copy it from the Cursor section of this page.

Does the Braintrust MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP. Status: Unlabelled, last checked October 17, 2026.

Sources

Last verified against 2 Braintrust pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.