Skip to main content
Connect your AI agent to the HUD platform via MCP. Your agent can query traces from the Home dashboard, check environment build status, explore your tasksets—all through natural conversation. When you’re reviewing jobs and spot failure patterns, ask your agent to analyze them and suggest new tasks.

​
Setup

Click the 🔍 button in the platform header to get the config, or add manually: 
{
  "hud": {
    "url": "https://api.hud.ai/v3/mcp/",
    "headers": {
      "Authorization": "Bearer YOUR_HUD_API_KEY"
    }
  }
}
Get your API key from Settings → API Keys.

​
Analyze Traces

From the Home dashboard, you see your recent jobs and traces. With MCP, your agent can dig deeper: 
"Get the traces from my last failed job and explain what the agent did wrong."

"Show me traces where the reward was 0. What patterns do you see in how the agent failed?"
Your agent retrieves the trace data—every action, tool call, and response—and helps you understand what happened.

​
Debug Environments

When an environment build fails or behaves unexpectedly, ask your agent to investigate: 
"Check the status of my remote-browser environment."

"List my environments and tell me which ones are ready vs still building."
This surfaces the same info you see on the Environments page, but lets you query it conversationally while you’re working.

​
Explore Tasksets

Browse your tasksets and see what’s in each one: 
"What tasksets do I have? How many tasks are in SheetBench-50?"

"Show me the tasks in my latest evalset and describe what they test."

​
Write New Tasks from Failures

The real power: after analyzing failed traces, have your agent suggest new tasks that target those weaknesses. 
"Based on the failures you found, write 3 new tasks that would test 
those specific edge cases."
This closes the loop—run evals → analyze failures → create targeted tasks → run again.

​
Available Tools

ToolWhat it queries
list_jobsYour jobs from Home (status, metrics)
get_jobJob details and summary
get_job_tracesTraces in a job
get_traceFull trace with trajectory and logs
list_environmentsYour environments from Environments page
get_environmentEnvironment details and build status
list_evalsetsYour tasksets from Tasksets page
get_evalset_tasksTasks in a specific evalset
list_scenariosScenarios for an environment
All read-only—your agent can query but not modify platform data.

Environments

Deploy and manage agent environments

Tasksets

Organize tasks for evaluation