@openhands/extensions 0.11.0 → 0.13.0

package/automations/index.d.ts

@@ -3,12 +3,241 @@ export interface RecommendedAutomation {
   name: string;
   category: string;
   description: string;
-  prompt: string;
-  exampleImplementation: string;
-  requiredIntegrationIds: string[];
+  requires: AutomationPrerequisites;
   popularityRank: number;
   estimatedSetupMinutes: number;
+  /**
+   * The `skills/` directory that builds this automation today. Defaults to
+   * `id`; present only where the two differ. Look the launch command up from
+   * that skill's entry in `SKILLS_CATALOG` rather than storing it here.
+   */
+  skill?: string;
+  exampleImplementation: string;
+  /** Present when this automation ships an extension-owned setup experience. */
+  setup?: AutomationSetup;
+}
+
+/**
+ * The extension-owned configuration experience for one automation.
+ *
+ * Mirrors the `setup` block in `automations/catalog.schema.json`, which is
+ * authoritative. It describes how an automation is *configured*; it never
+ * describes what the automation does at runtime.
+ *
+ * It states only what varies between automations, and states each of those
+ * things once. Everything else is the same for every automation and is the
+ * host's to generate: the slash command (`/<id>:setup`), the setup route
+ * (`/automations/new/<id>`), the capabilities check, the preflight call, the
+ * mapping from a rejected payload path back to the input at fault, the review
+ * screen, the navigation after a success, and the analytics stages.
+ */
+
+export type AutomationSetupMode = "direct" | "assisted";
+export type AutomationFieldType =
+  | "text"
+  | "textarea"
+  | "select"
+  | "cron"
+  | "timezone"
+  | "repo-picker";
+export type AutomationGitProvider = "github" | "gitlab" | "bitbucket";
+export type AutomationTriggerKind = "cron" | "event";
+
+export interface AutomationFieldOption {
+  value: string;
+  label: string;
+}
+
+export interface AutomationFieldConstraints {
+  minLength?: number;
+  maxLength?: number;
+  /** Host-implemented check, named from a closed set. Entries supply no regex. */
+  format?: "safeExpressionLiteral";
+}
+
+export interface AutomationFormField {
+  type: AutomationFieldType;
+  label: string;
+  help: string;
+  placeholder?: string;
+  default?: string;
+  required: boolean;
+  provider?: AutomationGitProvider;
+  options?: AutomationFieldOption[];
+  constraints?: AutomationFieldConstraints;
+}
+
+/** Keyed by field name, which is what `{{form.<name>}}` resolves against. */
+export type AutomationFormFields = Record<string, AutomationFormField>;
+
+export interface AutomationIntegrationRequirement {
+  /** Why this automation needs it. Omitted when there is no setup flow to show it in. */
+  message?: string;
+  /** Defaults to true. `false` lets setup continue while it is unconnected. */
+  required?: false;
+}
+
+export interface AutomationPrerequisites {
+  /** Keyed by integration catalog id. */
+  integrations: Record<string, AutomationIntegrationRequirement>;
+  /** Deployment capabilities this automation cannot run without. */
+  features?: string[];
 }
 
+/** The inputs that decide when the automation runs, keyed by trigger kind. */
+export type AutomationTriggerForm = Partial<
+  Record<AutomationTriggerKind, AutomationFormFields>
+>;
+
+export interface AutomationForm {
+  note?: string;
+  triggers?: AutomationTriggerForm;
+  /** Every other input: the arguments to the automation itself. */
+  args: AutomationFormFields;
+}
+
+export interface AutomationSetup {
+  version: "1.0";
+  mode: AutomationSetupMode;
+  form: AutomationForm;
+  /** direct only. What the automation is told to do. */
+  prompt?: string;
+  /** direct only, event trigger only. Which delivered events belong to it. */
+  filter?: string;
+  /**
+   * Setup context for the conversation that finishes setup. Required for
+   * assisted mode. Optional for direct mode, where it seeds the fallback
+   * conversation offered when the deployment cannot run the direct path.
+   */
+  message?: string;
+}
+
+/**
+ * The production Automation interface manifest.
+ *
+ * Mirrors `automations/interface.schema.json`, which is authoritative. The
+ * catalog states what varies per automation; this states the domain-level
+ * facts of the interface itself: routes, navigation, page-identity copy, the
+ * settable attributes of an automation, the import/export envelope, the
+ * service-relative endpoints, and the featured and responder id lists. The
+ * host validates it at admission and falls back to its built-in defaults when
+ * it is absent or rejected.
+ */
+
+export interface AutomationInterfaceRoutes {
+  list: string;
+  /** Carries the `:automationId` segment the host substitutes. */
+  setup: string;
+  /** Carries the `:automationId` segment the host substitutes. */
+  detail: string;
+}
+
+export interface AutomationInterfaceNavigation {
+  sidebar: { label: string };
+  commandMenu: { title: string; description: string; keywords: string };
+}
+
+export interface AutomationInterfacePages {
+  list: { title: string; subtitle: string };
+  detail: { backLabel: string };
+  edit: { title: string };
+}
+
+export type AutomationAttributeType =
+  | "text"
+  | "textarea"
+  | "number"
+  | "llm-profile"
+  | "schedule";
+
+/** The closed set of runtime-model properties a client may offer for setting. */
+export type AutomationAttributeName =
+  | "name"
+  | "prompt"
+  | "model"
+  | "timeout"
+  | "schedule";
+
+export interface AutomationAttributeConstraints {
+  min?: number;
+  max?: number;
+}
+
+/** How one settable attribute of an existing Automation is offered. */
+export interface AutomationAttribute {
+  type: AutomationAttributeType;
+  label: string;
+  help?: string;
+  required: boolean;
+  /** Only a `number` attribute carries constraints. */
+  constraints?: AutomationAttributeConstraints;
+}
+
+/**
+ * The input surface of an existing Automation, keyed by the runtime-model
+ * property the host sends. How a client offers these - Agent Canvas renders
+ * an edit dialog - is the client's choice, not stated here.
+ */
+export type AutomationInterfaceAttributes = Partial<
+  Record<AutomationAttributeName, AutomationAttribute>
+>;
+
+export interface AutomationImportDefaults {
+  /** Provider inferred for short owner/repo repository URLs on import. */
+  repoProvider: AutomationGitProvider;
+  /** Event source of the placeholder trigger that keeps an import inert. */
+  placeholderEventSource: string;
+}
+
+export interface AutomationInterfaceImportExport {
+  fileKind: string;
+  fileVersion: 1;
+  filenameSuffix: string;
+  importDefaults: AutomationImportDefaults;
+}
+
+/**
+ * Service-relative paths the host calls. Relative paths only: the base path,
+ * methods, headers, and auth remain the host's. `{id}` marks where the host
+ * substitutes the automation id.
+ */
+export interface AutomationInterfaceEndpoints {
+  list: string;
+  detail: string;
+  dispatch: string;
+  runs: string;
+  tarball: string;
+  health: string;
+  capabilities: string;
+  validate: string;
+  createPrompt: string;
+  createPlugin: string;
+}
+
+export interface AutomationInterfaceManifest {
+  version: "1.0";
+  routes: AutomationInterfaceRoutes;
+  navigation: AutomationInterfaceNavigation;
+  pages: AutomationInterfacePages;
+  docsUrl: string;
+  attributes: AutomationInterfaceAttributes;
+  importExport: AutomationInterfaceImportExport;
+  endpoints: AutomationInterfaceEndpoints;
+  featuredAutomationIds: string[];
+  responderIntegrationIds: string[];
+}
+
+export const AUTOMATION_INTERFACE: AutomationInterfaceManifest;
+
 export const AUTOMATION_CATALOG: RecommendedAutomation[];
+/**
+ * Return the full automation catalog.
+ * Reads the generated static import index over `automations/catalog/<id>/manifest.json`.
+ * Returns an independent copy.
+ */
+export function listAutomationCatalog(): RecommendedAutomation[];
+/** Return one automation catalog entry by id as an independent copy. */
+export function getAutomationCatalogEntry(
+  id: string,
+): RecommendedAutomation | undefined;
 export default AUTOMATION_CATALOG;

package/automations/index.js

@@ -1,20 +1,30 @@
-import github_pr_reviewer from "./catalog/github-pr-reviewer.json" with { type: "json" };
-import github_repo_monitor from "./catalog/github-repo-monitor.json" with { type: "json" };
-import slack_standup_digest from "./catalog/slack-standup-digest.json" with { type: "json" };
-import slack_channel_monitor from "./catalog/slack-channel-monitor.json" with { type: "json" };
-import linear_triage_assistant from "./catalog/linear-triage-assistant.json" with { type: "json" };
-import research_brief_writer from "./catalog/research-brief-writer.json" with { type: "json" };
-import incident_retrospective_drafter from "./catalog/incident-retrospective-drafter.json" with { type: "json" };
-import jira_issue_to_pr from "./catalog/jira-issue-to-pr.json" with { type: "json" };
+/**
+ * Runtime automation catalog.
+ *
+ * The source of truth is the hand-authored `automations/catalog/<id>/manifest.json`
+ * directory. `catalog-index.js` is generated from that directory so the JS
+ * package can statically import each JSON file without an aggregate JSON asset.
+ */
+import { AUTOMATION_CATALOG_ENTRIES } from "./catalog-index.js";
+import interfaceManifest from "./interface.json" with { type: "json" };
+
+const clone = (value) => JSON.parse(JSON.stringify(value));
+const AUTOMATIONS = AUTOMATION_CATALOG_ENTRIES;
+const AUTOMATION_BY_ID = new Map(AUTOMATIONS.map((entry) => [entry.id, entry]));
+
+export const listAutomationCatalog = () => clone(AUTOMATIONS);
+
+export const getAutomationCatalogEntry = (id) => {
+  const entry = AUTOMATION_BY_ID.get(id);
+  return entry ? clone(entry) : undefined;
+};
+
+export const AUTOMATION_CATALOG = clone(AUTOMATIONS);
+
+/**
+ * The production Automation interface manifest: the domain-level facts of the
+ * interface, hand-authored in `automations/interface.json`.
+ */
+export const AUTOMATION_INTERFACE = clone(interfaceManifest);
 
-export const AUTOMATION_CATALOG = [
-  github_pr_reviewer,
-  github_repo_monitor,
-  slack_standup_digest,
-  slack_channel_monitor,
-  linear_triage_assistant,
-  research_brief_writer,
-  incident_retrospective_drafter,
-  jira_issue_to_pr,
-];
 export default AUTOMATION_CATALOG;

package/automations/interface.json

@@ -0,0 +1,70 @@
+{
+  "version": "1.0",
+  "routes": {
+    "list": "/automations",
+    "setup": "/automations/new/:automationId",
+    "detail": "/automations/:automationId"
+  },
+  "navigation": {
+    "sidebar": { "label": "Automate" },
+    "commandMenu": {
+      "title": "Automations",
+      "description": "Review scheduled and webhook automations.",
+      "keywords": "automate cron schedule webhook jobs"
+    }
+  },
+  "pages": {
+    "list": {
+      "title": "Automations",
+      "subtitle": "View active and inactive automations, search by metadata, and inspect read-only details."
+    },
+    "detail": { "backLabel": "Back to Automations" },
+    "edit": { "title": "Edit automation" }
+  },
+  "docsUrl": "https://docs.openhands.dev/openhands/usage/automations/overview",
+  "attributes": {
+    "name": { "type": "text", "label": "Name", "required": true },
+    "prompt": {
+      "type": "textarea",
+      "label": "Prompt",
+      "help": "Edits apply to future runs only.",
+      "required": false
+    },
+    "model": { "type": "llm-profile", "label": "LLM profile", "required": false },
+    "timeout": {
+      "type": "number",
+      "label": "Timeout (seconds)",
+      "help": "Maximum time a single run may take. Leave empty for the default of 600 seconds (10 minutes); maximum 1800 seconds (30 minutes).",
+      "required": false,
+      "constraints": { "min": 1, "max": 1800 }
+    },
+    "schedule": { "type": "schedule", "label": "Frequency", "required": false }
+  },
+  "importExport": {
+    "fileKind": "automation",
+    "fileVersion": 1,
+    "filenameSuffix": ".automation.json",
+    "importDefaults": {
+      "repoProvider": "github",
+      "placeholderEventSource": "agent-canvas-import"
+    }
+  },
+  "endpoints": {
+    "list": "/v1",
+    "detail": "/v1/{id}",
+    "dispatch": "/v1/{id}/dispatch",
+    "runs": "/v1/{id}/runs",
+    "tarball": "/v1/{id}/tarball",
+    "health": "/health",
+    "capabilities": "/v1/capabilities",
+    "validate": "/v1/validate",
+    "createPrompt": "/v1/preset/prompt",
+    "createPlugin": "/v1/preset/plugin"
+  },
+  "featuredAutomationIds": [
+    "github-pr-reviewer",
+    "github-repo-monitor",
+    "slack-channel-monitor"
+  ],
+  "responderIntegrationIds": ["github", "slack"]
+}

package/automations/interface.schema.json

@@ -0,0 +1,243 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/OpenHands/extensions/automations/interface.schema.json",
+  "title": "AutomationInterfaceManifest",
+  "description": "Strict schema for automations/interface.json. Mirrors the AutomationInterfaceManifest types in automations/index.d.ts. The catalog states what varies per automation; this file states the domain-level facts of the production Automation interface - routes, navigation, page-identity copy, the settable attributes of an automation, the import/export envelope, the service-relative endpoints, and the featured and responder id lists. The host renders it; it is data, not code - no markup in copy, no free-form URL, no host name, method, or credential.",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "version",
+    "routes",
+    "navigation",
+    "pages",
+    "docsUrl",
+    "attributes",
+    "importExport",
+    "endpoints",
+    "featuredAutomationIds",
+    "responderIntegrationIds"
+  ],
+  "properties": {
+    "version": {
+      "const": "1.0",
+      "description": "Selects how this manifest is interpreted. A future format ships a new constant."
+    },
+    "routes": {
+      "description": "The routes of the Automation interface. The host must have a registration serving each declared shape, so admission verifies they match what it mounted; the manifest is the single source for link construction.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["list", "setup", "detail"],
+      "properties": {
+        "list": { "$ref": "#/$defs/routePath" },
+        "setup": { "$ref": "#/$defs/parameterizedRoutePath" },
+        "detail": { "$ref": "#/$defs/parameterizedRoutePath" }
+      }
+    },
+    "navigation": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["sidebar", "commandMenu"],
+      "properties": {
+        "sidebar": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["label"],
+          "properties": { "label": { "$ref": "#/$defs/copy" } }
+        },
+        "commandMenu": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["title", "description", "keywords"],
+          "properties": {
+            "title": { "$ref": "#/$defs/copy" },
+            "description": { "$ref": "#/$defs/copy" },
+            "keywords": { "$ref": "#/$defs/copy" }
+          }
+        }
+      }
+    },
+    "pages": {
+      "description": "Page-identity copy. Generic chrome - buttons, toasts, empty states, validation sentences - stays host copy, rendered through the host's translations.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["list", "detail", "edit"],
+      "properties": {
+        "list": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["title", "subtitle"],
+          "properties": {
+            "title": { "$ref": "#/$defs/copy" },
+            "subtitle": { "$ref": "#/$defs/copy" }
+          }
+        },
+        "detail": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["backLabel"],
+          "properties": { "backLabel": { "$ref": "#/$defs/copy" } }
+        },
+        "edit": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["title"],
+          "properties": { "title": { "$ref": "#/$defs/copy" } }
+        }
+      }
+    },
+    "docsUrl": {
+      "description": "The automations documentation link. Prefix-pinned so this cannot become an arbitrary link.",
+      "type": "string",
+      "pattern": "^https://docs\\.openhands\\.dev/[A-Za-z0-9/._-]*$"
+    },
+    "attributes": {
+      "description": "The input surface of an existing Automation: which attributes can be set after creation, keyed by the runtime-model property the host sends. The closed key set is the settable surface of the runtime model; how a client offers them - Agent Canvas renders an edit dialog, an agent sends them over the API - is the client's choice, not stated here. schedule is a semantic type whose frequency/weekday/time composite the host owns, like the setup form's cron type.",
+      "type": "object",
+      "additionalProperties": false,
+      "minProperties": 1,
+      "properties": {
+        "name": { "$ref": "#/$defs/attribute" },
+        "prompt": { "$ref": "#/$defs/attribute" },
+        "model": { "$ref": "#/$defs/attribute" },
+        "timeout": { "$ref": "#/$defs/attribute" },
+        "schedule": { "$ref": "#/$defs/attribute" }
+      }
+    },
+    "importExport": {
+      "description": "The export file envelope, and the two facts an import cannot derive from the file: the provider inferred for short repository URLs and the placeholder event source that keeps a half-imported automation inert until its real trigger is applied.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["fileKind", "fileVersion", "filenameSuffix", "importDefaults"],
+      "properties": {
+        "fileKind": { "type": "string", "pattern": "^[a-z][a-z-]*$" },
+        "fileVersion": { "const": 1 },
+        "filenameSuffix": { "type": "string", "pattern": "^\\.[a-z][a-z.]*json$" },
+        "importDefaults": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["repoProvider", "placeholderEventSource"],
+          "properties": {
+            "repoProvider": { "enum": ["github", "gitlab", "bitbucket"] },
+            "placeholderEventSource": {
+              "type": "string",
+              "pattern": "^[a-z0-9][a-z0-9.-]*$"
+            }
+          }
+        }
+      }
+    },
+    "endpoints": {
+      "description": "Service-relative paths the host calls. Relative paths only: the base path, methods, headers, and auth remain the host's, so this cannot express a request to anywhere the host did not choose. {id} marks where the host substitutes the automation id.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "list",
+        "detail",
+        "dispatch",
+        "runs",
+        "tarball",
+        "health",
+        "capabilities",
+        "validate",
+        "createPrompt",
+        "createPlugin"
+      ],
+      "properties": {
+        "list": { "$ref": "#/$defs/plainEndpoint" },
+        "detail": { "$ref": "#/$defs/idEndpoint" },
+        "dispatch": { "$ref": "#/$defs/idEndpoint" },
+        "runs": { "$ref": "#/$defs/idEndpoint" },
+        "tarball": { "$ref": "#/$defs/idEndpoint" },
+        "health": { "$ref": "#/$defs/plainEndpoint" },
+        "capabilities": { "$ref": "#/$defs/plainEndpoint" },
+        "validate": { "$ref": "#/$defs/plainEndpoint" },
+        "createPrompt": { "$ref": "#/$defs/plainEndpoint" },
+        "createPlugin": { "$ref": "#/$defs/plainEndpoint" }
+      }
+    },
+    "featuredAutomationIds": {
+      "description": "Catalog entries the list page surfaces as proven. Each id must resolve to an automations/catalog entry; the host's admission checks that, mirroring how requires.integrations ids are checked by the catalog tests.",
+      "$ref": "#/$defs/slugList"
+    },
+    "responderIntegrationIds": {
+      "description": "Integrations whose automations are treated as continuously-polling responders and get the deployment-choice dialog.",
+      "$ref": "#/$defs/slugList"
+    }
+  },
+  "$defs": {
+    "copy": {
+      "description": "Literal user-visible copy. Carries no markup, because this manifest must never inject HTML into the host.",
+      "type": "string",
+      "minLength": 1,
+      "not": { "pattern": "<[A-Za-z/!]" }
+    },
+    "routePath": {
+      "type": "string",
+      "pattern": "^/[A-Za-z0-9/:_-]*$",
+      "not": { "pattern": "//" }
+    },
+    "parameterizedRoutePath": {
+      "description": "A route path carrying the :automationId segment the host substitutes.",
+      "allOf": [
+        { "$ref": "#/$defs/routePath" },
+        { "pattern": ":automationId" }
+      ]
+    },
+    "endpointPath": {
+      "type": "string",
+      "pattern": "^/[A-Za-z0-9/{}_-]*$",
+      "not": { "pattern": "//" }
+    },
+    "plainEndpoint": {
+      "allOf": [
+        { "$ref": "#/$defs/endpointPath" },
+        { "not": { "pattern": "[{}]" } }
+      ]
+    },
+    "idEndpoint": {
+      "description": "An endpoint path with exactly one {id} substitution and no other braces.",
+      "allOf": [
+        { "$ref": "#/$defs/endpointPath" },
+        { "pattern": "^[^{}]*\\{id\\}[^{}]*$" }
+      ]
+    },
+    "attribute": {
+      "description": "How one settable attribute is offered: a semantic input type, user-visible copy, and value constraints. Only a number attribute carries constraints.",
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["type", "label", "required"],
+      "properties": {
+        "type": {
+          "enum": ["text", "textarea", "number", "llm-profile", "schedule"]
+        },
+        "label": { "$ref": "#/$defs/copy" },
+        "help": { "$ref": "#/$defs/copy" },
+        "required": { "type": "boolean" },
+        "constraints": {
+          "type": "object",
+          "additionalProperties": false,
+          "minProperties": 1,
+          "properties": {
+            "min": { "type": "integer", "minimum": 0 },
+            "max": { "type": "integer", "minimum": 1 }
+          }
+        }
+      },
+      "allOf": [
+        {
+          "if": {
+            "properties": { "type": { "not": { "const": "number" } } },
+            "required": ["type"]
+          },
+          "then": { "not": { "required": ["constraints"] } }
+        }
+      ]
+    },
+    "slugList": {
+      "type": "array",
+      "minItems": 1,
+      "uniqueItems": true,
+      "items": { "type": "string", "pattern": "^[a-z0-9]+(-[a-z0-9]+)*$" }
+    }
+  }
+}

package/index.d.ts

@@ -13,7 +13,34 @@ export {
   type OAuthProviderCatalogOption,
   type OAuthProviderRegistrationDefaults,
 } from "./integrations/index.js";
-export { AUTOMATION_CATALOG } from "./automations/index.js";
-export type { RecommendedAutomation } from "./automations/index.js";
+export { AUTOMATION_CATALOG, AUTOMATION_INTERFACE } from "./automations/index.js";
+export type {
+  AutomationFieldConstraints,
+  AutomationFieldOption,
+  AutomationFieldType,
+  AutomationForm,
+  AutomationFormField,
+  AutomationFormFields,
+  AutomationGitProvider,
+  AutomationIntegrationRequirement,
+  AutomationPrerequisites,
+  AutomationSetup,
+  AutomationSetupMode,
+  AutomationTriggerForm,
+  AutomationTriggerKind,
+  RecommendedAutomation,
+  AutomationAttribute,
+  AutomationAttributeConstraints,
+  AutomationAttributeName,
+  AutomationAttributeType,
+  AutomationImportDefaults,
+  AutomationInterfaceAttributes,
+  AutomationInterfaceEndpoints,
+  AutomationInterfaceImportExport,
+  AutomationInterfaceManifest,
+  AutomationInterfaceNavigation,
+  AutomationInterfacePages,
+  AutomationInterfaceRoutes,
+} from "./automations/index.js";
 export { SKILLS_CATALOG } from "./skills/index.js";
 export type { SkillCatalogEntry } from "./skills/index.js";

package/index.js

@@ -1,3 +1,3 @@
 export { INTEGRATION_CATALOG } from "./integrations/index.js";
-export { AUTOMATION_CATALOG } from "./automations/index.js";
+export { AUTOMATION_CATALOG, AUTOMATION_INTERFACE } from "./automations/index.js";
 export { SKILLS_CATALOG } from "./skills/index.js";

package/integrations/catalog/datadog.json

@@ -7,7 +7,7 @@
     "Operations"
   ],
   "appUrl": "https://www.datadoghq.com",
-  "docsUrl": "https://docs.datadoghq.com/bits_ai/mcp_server/setup/",
+  "docsUrl": "https://docs.datadoghq.com/mcp_server/setup/",
   "notes": "Uses Datadog's official hosted MCP server. The MCP endpoint host is site-specific: use https://mcp.<site>.datadoghq.com/v1/mcp for your Datadog site (e.g. mcp.us5.datadoghq.com for US5). The default URL below targets US1 and can be edited in the install dialog.",
   "popularityRank": 35,
   "installHint": "The Datadog MCP URL is site-specific. Edit the URL to https://mcp.<site>.datadoghq.com/v1/mcp for your Datadog site (for example https://mcp.us5.datadoghq.com/v1/mcp for US5, https://mcp.eu.datadoghq.com/v1/mcp for EU). Find your site at Organization Settings → Site in Datadog.",
@@ -43,7 +43,7 @@
         "urlEditable": true,
         "headerFields": [
           {
-            "key": "DD-API-KEY",
+            "key": "DD_API_KEY",
             "label": "Datadog API key",
             "type": "password",
             "required": true,
@@ -51,7 +51,7 @@
             "helperText": "Created in Datadog under Organization Settings → API Keys. Used to authenticate to the Datadog MCP server. See the [setup docs](https://docs.datadoghq.com/mcp_server/setup/?tab=other#authentication)."
           },
           {
-            "key": "DD-APPLICATION-KEY",
+            "key": "DD_APPLICATION_KEY",
             "label": "Datadog Application key",
             "type": "password",
             "required": true,