OpenHands · neubig · May 31, 2026 · May 29, 2026 · May 31, 2026 · May 31, 2026
diff --git a/integrations/catalog/airtable.json b/integrations/catalog/airtable.json
@@ -30,7 +30,9 @@
             "key": "AIRTABLE_API_KEY",
             "label": "Airtable personal access token",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "Personal access token from your Airtable account.",
+            "helperLink": "https://airtable.com/create/tokens"
           }
         ]
       },

diff --git a/integrations/catalog/apify.json b/integrations/catalog/apify.json
@@ -29,7 +29,9 @@
             "key": "APIFY_TOKEN",
             "label": "Apify token",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "API token from your Apify account settings.",
+            "helperLink": "https://console.apify.com/account/integrations"
           }
         ]
       },

diff --git a/integrations/catalog/brave-search.json b/integrations/catalog/brave-search.json
@@ -29,7 +29,9 @@
             "key": "BRAVE_API_KEY",
             "label": "Brave API key",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "API key from the Brave Search API portal.",
+            "helperLink": "https://api-dashboard.search.brave.com/app/keys"
           }
         ]
       },

diff --git a/integrations/catalog/clickhouse.json b/integrations/catalog/clickhouse.json
@@ -42,7 +42,9 @@
             "key": "CLICKHOUSE_PASSWORD",
             "label": "Password",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "Password for your ClickHouse user.",
+            "helperLink": "https://clickhouse.com/docs/operations/access-rights"
           }
         ]
       },

diff --git a/integrations/catalog/elevenlabs.json b/integrations/catalog/elevenlabs.json
@@ -28,7 +28,9 @@
             "key": "ELEVENLABS_API_KEY",
             "label": "ElevenLabs API key",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "API key from your ElevenLabs account settings.",
+            "helperLink": "https://elevenlabs.io/app/settings/api-keys"
           }
         ]
       },

diff --git a/integrations/catalog/exa.json b/integrations/catalog/exa.json
@@ -29,7 +29,9 @@
             "key": "EXA_API_KEY",
             "label": "Exa API key",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "API key from your Exa account.",
+            "helperLink": "https://exa.ai/docs/reference/getting-started"
           }
         ]
       },

diff --git a/integrations/catalog/figma.json b/integrations/catalog/figma.json
@@ -30,7 +30,9 @@
             "key": "FIGMA_API_KEY",
             "label": "Figma personal access token",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "Personal access token from your Figma account settings.",
+            "helperLink": "https://developers.figma.com/docs/rest-api/authentication/#personal-access-tokens"
           }
         ]
       },

diff --git a/integrations/catalog/firecrawl.json b/integrations/catalog/firecrawl.json
@@ -29,7 +29,9 @@
             "key": "FIRECRAWL_API_KEY",
             "label": "Firecrawl API key",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "API key from your Firecrawl dashboard.",
+            "helperLink": "https://www.firecrawl.dev/app/api-keys"
           }
         ]
       },

diff --git a/integrations/catalog/github.json b/integrations/catalog/github.json
@@ -37,7 +37,9 @@
             "label": "Personal access token",
             "type": "password",
             "placeholder": "github_pat_...",
-            "required": true
+            "required": true,
+            "helperText": "Classic or fine-grained personal access token from GitHub settings.",
+            "helperLink": "https://github.com/settings/tokens"
           }
         ]
       },

diff --git a/integrations/catalog/kagi.json b/integrations/catalog/kagi.json
@@ -28,7 +28,9 @@
             "key": "KAGI_API_KEY",
             "label": "Kagi API key",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "API key from your Kagi account settings.",
+            "helperLink": "https://kagi.com/settings?p=api"
           }
         ]
       },

diff --git a/integrations/catalog/mongodb.json b/integrations/catalog/mongodb.json
@@ -29,7 +29,9 @@
             "label": "MongoDB connection string",
             "type": "password",
             "placeholder": "mongodb+srv://user:pass@cluster.mongodb.net",
-            "required": true
+            "required": true,
+            "helperText": "Connection string from your MongoDB Atlas cluster.",
+            "helperLink": "https://www.mongodb.com/docs/atlas/connect-to-database-deployment/#connect-with-a-connection-string"
           }
         ]
       },

diff --git a/integrations/catalog/neon.json b/integrations/catalog/neon.json
@@ -30,7 +30,9 @@
             "key": "NEON_API_KEY",
             "label": "Neon API key",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "API key from your Neon account settings.",
+            "helperLink": "https://neon.tech/docs/manage/api-keys"
           }
         ]
       },

diff --git a/integrations/catalog/notion.json b/integrations/catalog/notion.json
@@ -32,7 +32,9 @@
             "label": "Internal integration token",
             "type": "password",
             "placeholder": "ntn_...",
-            "required": true
+            "required": true,
+            "helperText": "Internal integration token from your Notion integrations page.",
+            "helperLink": "https://www.notion.so/profile/integrations"
           }
         ]
       },

diff --git a/integrations/catalog/obsidian.json b/integrations/catalog/obsidian.json
@@ -30,7 +30,8 @@
             "label": "Local REST API key",
             "type": "password",
             "required": true,
-            "helperText": "From the Obsidian 'Local REST API' community plugin."
+            "helperText": "From the Obsidian 'Local REST API' community plugin.",
+            "helperLink": "https://github.com/coddingtonbear/obsidian-local-rest-api"
           }
         ]
       },

diff --git a/integrations/catalog/redis.json b/integrations/catalog/redis.json
@@ -33,7 +33,8 @@
             "type": "password",
             "placeholder": "redis://localhost:6379",
             "required": true,
-            "helperText": "Appended as --url <redis_url>."
+            "helperText": "Connection URL for your Redis instance. Appended as --url <redis_url>.",
+            "helperLink": "https://redis.io/docs/latest/operate/rc/databases/connect/"
           }
         ]
       },

diff --git a/integrations/catalog/resend.json b/integrations/catalog/resend.json
@@ -28,7 +28,9 @@
             "key": "RESEND_API_KEY",
             "label": "Resend API key",
             "type": "password",
-            "required": true
+            "required": true,
+            "helperText": "API key from your Resend dashboard.",
+            "helperLink": "https://resend.com/api-keys"
           },
           {
             "key": "SENDER_EMAIL_ADDRESS",

diff --git a/integrations/catalog/slack.json b/integrations/catalog/slack.json
@@ -31,7 +31,9 @@
             "label": "Bot token",
             "type": "password",
             "placeholder": "xoxb-...",
-            "required": true
+            "required": true,
+            "helperText": "Bot token from your Slack app's OAuth & Permissions page.",
+            "helperLink": "https://api.slack.com/apps"
           },
           {
             "key": "SLACK_TEAM_ID",

diff --git a/integrations/catalog/supabase.json b/integrations/catalog/supabase.json
@@ -30,7 +30,8 @@
             "label": "Supabase access token",
             "type": "password",
             "required": true,
-            "helperText": "Personal access token from your Supabase dashboard."
+            "helperText": "Personal access token from your Supabase dashboard.",
+            "helperLink": "https://supabase.com/dashboard/account/tokens"
           }
         ]
       },

diff --git a/integrations/catalog/tavily.json b/integrations/catalog/tavily.json
@@ -11,7 +11,7 @@
     "research"
   ],
   "popularityRank": 90,
-  "installHint": "Paste your Tavily API key — the official tavily-mcp package runs via npx.",
+  "installHint": "Paste your Tavily API key - the official tavily-mcp package runs via npx.",
   "kind": "mcp",
   "defaultConnectionOptionId": "api",
   "connectionOptions": [
@@ -32,7 +32,9 @@
             "label": "Tavily API key",
             "type": "password",
             "placeholder": "tvly-...",
-            "required": true
+            "required": true,
+            "helperText": "API key from your Tavily dashboard.",
+            "helperLink": "https://app.tavily.com/home?tab=keys"
           }
         ]
       },

diff --git a/integrations/index.d.ts b/integrations/index.d.ts
@@ -6,6 +6,7 @@ export interface MarketplaceField {
   type?: MarketplaceFieldType;
   placeholder?: string;
   helperText?: string;
+  helperLink?: string;
   required?: boolean;
 }
 

diff --git a/tests/test_catalogs.py b/tests/test_catalogs.py
@@ -71,6 +71,29 @@ def test_catalog_entries_have_required_fields():
         assert isinstance(entry["estimatedSetupMinutes"], int)
 
 
+def test_credential_fields_have_helper_text_and_link():
+    """All password fields must have helperText and helperLink so users know how to get credentials."""
+    for entry in load_catalog_entries("integrations/catalog"):
+        for option in entry["connectionOptions"]:
+            transport = option.get("transport", {})
+            for field_group in ("envFields", "argFields"):
+                for field in transport.get(field_group, []):
+                    if field.get("type") == "password":
+                        field_key = field.get("key", "<unknown>")
+                        assert "helperText" in field, (
+                            f"{entry['id']}: password field '{field_key}' is missing helperText"
+                        )
+                        assert "helperLink" in field, (
+                            f"{entry['id']}: password field '{field_key}' is missing helperLink"
+                        )
+                        assert field["helperText"], (
+                            f"{entry['id']}: password field '{field_key}' has empty helperText"
+                        )
+                        assert field["helperLink"].startswith("https://"), (
+                            f"{entry['id']}: password field '{field_key}' helperLink must start with https://"
+                        )
+
+
 def test_node_package_exports_catalogs():
     script = """
       import { INTEGRATION_CATALOG, AUTOMATION_CATALOG } from './index.js';