HUD · OpenAPI Overlay 1.0.0

HUD Platform API - API Evangelist enhancements

14 actions 14 updates security extends ../openapi/_original/hud-ai-openapi.yml

Generated by API Evangelist Written by API Evangelist tooling for HUD's API. It is a proposal applied on top of the contract, not a document HUD publishes.

View Overlay File View on GitHub Overlay Specification

What the actions change

x-mcp-toolx-apis-iosecuritySchemessecurity

Targets 13

$.info

$.components

$.paths['/v2/registry'].get

$.paths['/v2/registry/{registry_id}'].get

$.paths['/v2/tasksets'].get

$.paths['/v2/tasksets/{taskset_id}/tasks'].get

$.paths['/v2/jobs'].get

$.paths['/v2/jobs/{job_id}'].get

$.paths['/v2/jobs/{job_id}/traces'].get

$.paths['/v2/trace/{trace_id}/info'].get

$.paths['/v2/trace/{trace_id}'].get

$.paths['/v2/trace/{trace_id}/events'].get

OpenAPI Overlay

overlay: 1.0.0
info:
  title: HUD Platform API - API Evangelist enhancements
  version: 1.0.0
  x-generated: '2026-10-27'
  x-method: generated
  x-source: openapi/hud-ai-openapi.yml, mcp/hud-ai-tool-crosswalk.yml, https://docs.hud.ai/platform/rest-api.md
extends: ../openapi/_original/hud-ai-openapi.yml
actions:
- target: $.info
  description: Point at the docs, MCP server and llms.txt.
  update:
    x-apis-io:
      documentation: https://docs.hud.ai/platform/rest-api
      llms_txt: https://docs.hud.ai/llms.txt
      mcp_server: https://api.beta.hud.ai/v2/mcp/
- target: $.components
  description: The source document declares no securitySchemes; docs.hud.ai/platform/rest-api documents a team HUD_API_KEY sent as a bearer token.
  update:
    securitySchemes:
      HudApiKey:
        type: http
        scheme: bearer
        description: 'Team HUD_API_KEY (Settings -> API keys at https://hud.ai/settings/api-keys), sent as Authorization: Bearer <key>.'
- target: $
  description: Apply the documented bearer key globally.
  update:
    security:
    - HudApiKey: []
- target: $.paths['/v2/registry'].get
  description: Bind to HUD Platform MCP tool list_environments (high confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: list_environments
      confidence: high
- target: $.paths['/v2/registry/{registry_id}'].get
  description: Bind to HUD Platform MCP tool get_environment (medium confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: get_environment
      confidence: medium
- target: $.paths['/v2/tasksets'].get
  description: Bind to HUD Platform MCP tool get_environment (medium confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: get_environment
      confidence: medium
- target: $.paths['/v2/tasksets'].get
  description: Bind to HUD Platform MCP tool list_tasksets (high confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: list_tasksets
      confidence: high
- target: $.paths['/v2/tasksets/{taskset_id}/tasks'].get
  description: Bind to HUD Platform MCP tool get_taskset_tasks (high confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: get_taskset_tasks
      confidence: high
- target: $.paths['/v2/jobs'].get
  description: Bind to HUD Platform MCP tool list_jobs (high confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: list_jobs
      confidence: high
- target: $.paths['/v2/jobs/{job_id}'].get
  description: Bind to HUD Platform MCP tool get_job_traces (medium confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: get_job_traces
      confidence: medium
- target: $.paths['/v2/jobs/{job_id}/traces'].get
  description: Bind to HUD Platform MCP tool get_job_traces (medium confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: get_job_traces
      confidence: medium
- target: $.paths['/v2/trace/{trace_id}/info'].get
  description: Bind to HUD Platform MCP tool get_trace (medium confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: get_trace
      confidence: medium
- target: $.paths['/v2/trace/{trace_id}'].get
  description: Bind to HUD Platform MCP tool get_trace (medium confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: get_trace
      confidence: medium
- target: $.paths['/v2/trace/{trace_id}/events'].get
  description: Bind to HUD Platform MCP tool get_trace_events (high confidence).
  update:
    x-mcp-tool:
      server: https://api.beta.hud.ai/v2/mcp/
      tool: get_trace_events
      confidence: high

Work with this as data

Every overlay here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for openapi overlays

4 MCP tools reach this

find_overlaysBrowse and filter every overlay in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This overlay

curl "https://apis.io/api/v1/overlays/hud-ai-openapi-overlay"

All openapi overlays

curl "https://apis.io/api/v1/overlays?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.