@openhands/extensions 0.0.1-alpha

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 OpenHands
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MIGRATION.md

@@ -0,0 +1,62 @@
+# Migration Guide
+
+## MCP catalog to integration catalog
+
+This package version is still `0.0.0`, and the MCP catalog was an experimental
+pre-release API. This migration intentionally removes the old MCP-only export
+paths and names instead of keeping deprecated aliases.
+
+### Import paths and symbols
+
+Before:
+
+```js
+import { MCP_CATALOG } from "@openhands/extensions/mcps";
+import { MCP_LOGOS } from "@openhands/extensions/mcps/logos";
+```
+
+After:
+
+```js
+import { INTEGRATION_CATALOG } from "@openhands/extensions/integrations";
+import { INTEGRATION_LOGOS } from "@openhands/extensions/integrations/logos";
+```
+
+TypeScript consumers should replace `McpCatalogEntry` with
+`IntegrationCatalogEntry`.
+
+### Catalog entries
+
+Before, MCP entries exposed a single `template`:
+
+```js
+const template = entry.template;
+```
+
+After, integrations expose one or more `connectionOptions`:
+
+```js
+const option =
+  entry.connectionOptions.find(
+    (candidate) => candidate.id === entry.defaultConnectionOptionId,
+  ) ?? entry.connectionOptions[0];
+```
+
+MCP-backed options use `provider: "mcp"` and include their transport details.
+Other integration types can use the same catalog entry shape without pretending
+to be MCP servers.
+
+### Automation entries
+
+Automation templates now refer to integrations, not MCP-only records:
+
+```diff
+- requiredMcpIds
++ requiredIntegrationIds
+```
+
+### Deprecation timeline
+
+There is no deprecation window for the old `mcps` exports. They were removed in
+this PR because downstream consumers are being updated in the same coordinated
+change and the API had not been treated as stable.

package/README.md

@@ -0,0 +1,160 @@
+# OpenHands Extensions
+
+This repository is the **public extensions registry** for [OpenHands](https://github.com/OpenHands/OpenHands).
+It contains reusable, shareable skills and plugins that customize agent behavior.
+
+- Skills overview docs: https://docs.openhands.dev/overview/skills
+- SDK skill guide: https://docs.openhands.dev/sdk/guides/skill
+
+## Repository Layout
+
+### Skills
+
+Skills are Markdown-based guidelines that provide domain-specific knowledge and instructions.
+They live under `skills/`, **one directory per skill**:
+
+- `skills/<skill-name>/SKILL.md` — the skill definition (AgentSkills-style progressive disclosure)
+- `skills/<skill-name>/README.md` — optional human-facing notes/examples
+
+Browse the catalog in [`skills/`](skills/).
+
+### Plugins
+
+Plugins are extensions with executable code components (hooks, scripts).
+They live under `plugins/`, **one directory per plugin**:
+
+- `plugins/<plugin-name>/SKILL.md` — the plugin definition
+- `plugins/<plugin-name>/hooks/` — lifecycle hooks
+- `plugins/<plugin-name>/scripts/` — utility scripts
+
+Browse available plugins in [`plugins/`](plugins/).
+
+### NPM Package
+
+This repository also publishes catalog data through the `@openhands/extensions` package. It requires Node.js 18.20.0 or newer because the catalog entry points import JSON modules with import attributes.
+
+```js
+import { AUTOMATION_CATALOG, INTEGRATION_CATALOG } from "@openhands/extensions";
+import { INTEGRATION_CATALOG as MCP_MARKETPLACE } from "@openhands/extensions/integrations";
+import { AUTOMATION_CATALOG as RECOMMENDED_AUTOMATIONS } from "@openhands/extensions/automations";
+```
+
+React logo components are isolated behind a separate export so data-only consumers do not need React peer dependencies:
+
+```js
+import { INTEGRATION_LOGOS } from "@openhands/extensions/integrations/logos";
+```
+
+See [`integrations/README.md`](integrations/README.md), [`automations/README.md`](automations/README.md), and [`MIGRATION.md`](MIGRATION.md) for catalog-specific details.
+
+## Extensions Catalog
+
+<!-- BEGIN AUTO-GENERATED CATALOG -->
+This repository contains **2 marketplace(s)** with **56 extensions** (46 skills, 10 plugins).
+
+### large-codebase
+
+OpenHands skills for interacting, improving, and refactoring large codebases
+
+**4 extensions** (2 skills, 2 plugins)
+
+| Name | Type | Description | Commands |
+|------|------|-------------|----------|
+| add-javadoc | skill | Add comprehensive JavaDoc documentation to Java classes and methods. Use when documenting Java code, adding API docum... | — |
+| cobol-modernization | plugin | End-to-end COBOL to Java migration workflow. Handles build setup, mainframe dependency removal, and code migration wi... | — |
+| migration-scoring | plugin | Evaluate code migration quality with coverage, correctness, and style scoring. Generates executive reports with actio... | — |
+| spark-version-upgrade | skill | Upgrade Apache Spark applications between major versions (2.x→3.x, 3.x→4.x). Covers build files, deprecated APIs, con... | — |
+
+### openhands-extensions
+
+Official skills and plugins for OpenHands — the open-source AI software engineer.
+
+**52 extensions** (44 skills, 8 plugins)
+
+| Name | Type | Description | Commands |
+|------|------|-------------|----------|
+| add-skill | skill | Add (import) an OpenHands skill from a GitHub repository into the current workspace. | — |
+| agent-creator | skill | Create file-based sub-agents as Markdown files — no Python code required. Guides the user through a structured interv... | `/agent-creator` |
+| agent-memory | skill | Persist and retrieve repository-specific knowledge using AGENTS.md files. Use when you want to save important informa... | `/remember` |
+| agent-sdk-builder | skill | Guided workflow for building custom AI agents using the OpenHands Software Agent SDK. Use when you want to create a n... | `/agent-builder` |
+| azure-devops | skill | Interact with Azure DevOps repositories, pull requests, and APIs using the AZURE_DEVOPS_TOKEN environment variable. U... | — |
+| bitbucket | skill | Interact with Bitbucket repositories and pull requests using the BITBUCKET_TOKEN environment variable. Use when worki... | — |
+| city-weather | plugin | Get current weather, time, and precipitation forecast for any city using the free Open-Meteo API. Provides slash comm... | — |
+| code-review | skill | Rigorous code review focusing on data structures, simplicity, security, pragmatism, and risk/safety evaluation. Provi... | `/codereview`, `/codereview-roasted` |
+| code-simplifier | skill | Simplifies and refines code across three dimensions - code reuse, code quality, and efficiency - while preserving all... | `/simplify` |
+| datadog | skill | Query and analyze Datadog logs, metrics, APM traces, and monitors using the Datadog API. Use when debugging productio... | — |
+| deno | skill | Common project operations using Deno (tasks, run/test/lint/fmt, and dependency management). | — |
+| discord | skill | Build and automate Discord integrations (bots, webhooks, slash commands, and REST API workflows). Use when the user m... | — |
+| docker | skill | Run Docker commands within a container environment, including starting the Docker daemon and managing containers. Use... | — |
+| evidence-based-citations | skill | Back factual claims and field values with official, verifiable sources. Use when the user asks to fill fields, answer... | — |
+| flarglebargle | skill | A test skill that responds to the magic word 'flarglebargle' with a compliment. Use for testing skill activation and ... | — |
+| frontend-design | skill | Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks ... | — |
+| github | skill | Interact with GitHub repositories, pull requests, issues, and workflows using the GITHUB_TOKEN environment variable a... | — |
+| github-pr-review | skill | Post structured PR reviews to GitHub with inline comments/suggestions in a single API call. | `/github-pr-review` |
+| github-pr-reviewer | skill | Create an automation that reviews GitHub pull requests when they are opened or updated. Inspects the diff, changed fi... | `/pr-reviewer:setup` |
+| github-repo-monitor | skill | Create a cron automation that polls a GitHub repository for issue and PR comments containing a configurable trigger p... | `/github-monitor:poll` |
+| gitlab | skill | Interact with GitLab repositories, merge requests, and APIs using the GITLAB_TOKEN environment variable. Use when wor... | — |
+| incident-retrospective | skill | Create an automation that drafts incident retrospectives by gathering incident-channel messages from Slack, collectin... | `/incident-retro:setup` |
+| iterate | skill | Iterate on a GitHub pull request — drive it through CI, code review, and QA until merge-ready. Monitors state, fixes ... | `/iterate`, `/verify`, `/babysit` |
+| jupyter | skill | Read, modify, execute, and convert Jupyter notebooks programmatically. Use when working with .ipynb files for data sc... | — |
+| kubernetes | skill | Set up and manage local Kubernetes clusters using KIND (Kubernetes IN Docker). Use when testing Kubernetes applicatio... | — |
+| learn-from-code-review | skill | Distill code review feedback from GitHub PRs into reusable skills and guidelines. Use when users ask to learn from co... | `/learn-from-reviews` |
+| linear | skill | Interact with Linear project management - query issues, update status, create tickets using the Linear GraphQL API. | — |
+| linear-triage | skill | Create an automation that triages new Linear issues by inspecting title, description, team, and recent related issues... | `/linear-triage:setup` |
+| magic-test | plugin | A simple test plugin for verifying plugin loading. Triggers on magic words (alakazam, abracadabra) and returns a spec... | — |
+| notion | skill | Create, search, and update Notion pages/databases using the Notion API. Use for documenting work, generating runbooks... | — |
+| npm | skill | Handle npm package installation in non-interactive environments by piping confirmations. Use when installing Node.js ... | — |
+| onboarding | plugin | Assess repository agent-readiness across five pillars, propose high-impact fixes, and generate repo-specific AGENTS.m... | — |
+| openhands | plugin | Unified OpenHands plugin — bundles Cloud CLI, REST API (openhands-api), and Automations (openhands-automation) into a... | `/openhands-cloud` |
+| openhands-api | skill | Use the OpenHands Cloud REST API (V1) to create and manage app conversations, including multi-conversation delegation... | — |
+| openhands-automation | skill | Create and manage OpenHands automations - scheduled tasks that run in sandboxes. Use the prompt preset to create auto... | `/automation:create` |
+| openhands-sdk | skill | Reference skill for the OpenHands Software Agent SDK - build AI agents with custom tools, LLM configuration, conversa... | `/sdk` |
+| pdflatex | skill | Install and use pdflatex to compile LaTeX documents into PDFs on Linux. Use when generating academic papers, research... | — |
+| pr-review | plugin | Automated PR code review — analyzes diffs and posts inline review comments via the GitHub API. | — |
+| prd | skill | Generate a Product Requirements Document (PRD) for a new feature through an interactive clarifying-question workflow.... | `/prd` |
+| qa-changes | plugin | Validate pull request changes by actually running the code — setting up the environment, exercising changed behavior,... | — |
+| release-notes | plugin | Generate consistent, well-structured release notes from git history. Produces categorized changelog with breaking cha... | `/release-notes` |
+| research-brief | skill | Create a recurring automation that researches a topic using Tavily web search and publishes a structured brief to Not... | `/research-brief:setup` |
+| security | skill | Security best practices for secure coding, authentication, authorization, and data protection. Use when developing fe... | — |
+| skill-creator | skill | Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an ex... | — |
+| slack-channel-monitor | skill | Create a cron automation that polls up to 10 Slack channels every minute and starts an OpenHands conversation when a ... | `/slack-monitor:poll` |
+| slack-standup-digest | skill | Create an automation that generates an async standup digest from Slack. Searches selected channels for messages since... | `/standup-digest:setup` |
+| ssh | skill | Establish and manage SSH connections to remote machines, including key generation, configuration, and file transfers.... | — |
+| swift-linux | skill | Install and configure Swift programming language on Debian Linux for server-side development. Use when building Swift... | — |
+| theme-factory | skill | Toolkit for styling artifacts with a theme. These artifacts can be slides, docs, reportings, HTML landing pages, etc.... | — |
+| uv | skill | Common project, dependency, and environment operations using uv. | — |
+| vercel | skill | Deploy and manage applications on Vercel, including preview deployments and deployment protection. | — |
+| vulnerability-remediation | plugin | Automated security vulnerability scanning and AI-powered remediation. Scans repositories, skips when no issues found,... | — |
+<!-- END AUTO-GENERATED CATALOG -->
+
+## Contributing
+
+### Adding a Skill
+
+1. Fork this repository
+2. Create a new directory: `skills/<your-skill-name>/`
+3. Add `skills/<your-skill-name>/SKILL.md`
+4. (Optional) Add `README.md`, `references/`, `scripts/`, etc.
+5. Submit a pull request
+
+### Adding a Plugin
+
+1. Fork this repository
+2. Create a new directory: `plugins/<your-plugin-name>/`
+3. Add `plugins/<your-plugin-name>/SKILL.md`
+4. Add `hooks/` and/or `scripts/` directories with your executable code
+5. Submit a pull request
+
+## Agent Instructions
+
+See [`AGENTS.md`](AGENTS.md) for the rules agents should follow when editing/adding skills and plugins.
+
+<hr>
+
+### Thank You to Our Contributors
+
+<p align="center">
+  <a href="https://github.com/OpenHands/extensions/graphs/contributors">
+    <img src="https://assets.openhands.dev/readme/openhands-extensions-contributors.svg" />
+  </a>
+</p>

package/automations/README.md

@@ -0,0 +1,15 @@
+# Automation catalog
+
+This directory contains recommended OpenHands automation templates.
+
+- `catalog/*.json` contains one source file per recommended automation.
+- `index.js` assembles and exports the catalog for Node.js and bundlers.
+- `index.d.ts` contains the public TypeScript shape.
+
+Consumers can import the package export:
+
+```js
+import { AUTOMATION_CATALOG } from "@openhands/extensions/automations";
+```
+
+Each automation references required integrations by ID. Those IDs should match entries in `integrations/catalog/*.json`.

package/automations/catalog/github-pr-reviewer.json

@@ -0,0 +1,13 @@
+{
+  "id": "github-pr-reviewer",
+  "name": "GitHub PR review copilot",
+  "category": "Code review",
+  "description": "Watch pull requests, inspect the diff, and leave a concise review with risks and suggested follow-ups.",
+  "requiredIntegrationIds": [
+    "github"
+  ],
+  "popularityRank": 100,
+  "estimatedSetupMinutes": 4,
+  "prompt": "/pr-reviewer:setup",
+  "exampleImplementation": "Trigger: github.pull_request.opened and github.pull_request.synchronize\nRequired MCP: GitHub\n\n1. Read repository, pull_request, and sender from the event payload.\n2. Fetch the PR diff and related comments through the GitHub MCP.\n3. Run a review rubric focused on bugs, security, tests, and maintainability.\n4. TODO: decide whether to publish inline comments, a summary comment, or a draft artifact.\n5. Post or save the review with links back to the exact files and lines."
+}

package/automations/catalog/github-repo-monitor.json

@@ -0,0 +1,11 @@
+{
+  "id": "github-repo-monitor",
+  "name": "GitHub repository monitor",
+  "category": "Developer tools",
+  "description": "Watch a repository for @OpenHands mentions in issues and PR comments, start a conversation, and post the agent's reply back to GitHub.",
+  "requiredIntegrationIds": ["github"],
+  "popularityRank": 98,
+  "estimatedSetupMinutes": 5,
+  "prompt": "/github-monitor:poll",
+  "exampleImplementation": "Trigger: cron, every minute (configurable)\nRequired secret: GITHUB_TOKEN\n\n1. Poll GitHub for new issue and PR comments since the last run.\n2. Match comments containing the trigger phrase (case-insensitive, default: @OpenHands).\n3. Post an acknowledgment comment with a link to the new OpenHands conversation.\n4. Forward follow-up replies in the same thread to the running conversation.\n5. Post the agent's final response back to GitHub when the conversation completes."
+}

package/automations/catalog/incident-retrospective-drafter.json

@@ -0,0 +1,15 @@
+{
+  "id": "incident-retrospective-drafter",
+  "name": "Incident retrospective drafter",
+  "category": "Reliability",
+  "description": "Collect incident chatter and issue updates, then draft a timeline and follow-up checklist.",
+  "requiredIntegrationIds": [
+    "slack",
+    "linear",
+    "notion"
+  ],
+  "popularityRank": 78,
+  "estimatedSetupMinutes": 8,
+  "prompt": "/incident-retro:setup",
+  "exampleImplementation": "Trigger: manual, cron, or incident label added\nRequired MCPs: Slack, Linear, Notion\n\n1. Gather incident messages, timestamps, and linked issue references.\n2. Pull Linear follow-up tickets, owners, and status.\n3. TODO: define the incident identifier format and approved Notion template.\n4. Build a timeline, impact summary, root-cause hypotheses, and action items.\n5. Publish a draft retrospective and notify the incident owner."
+}

package/automations/catalog/linear-triage-assistant.json

@@ -0,0 +1,13 @@
+{
+  "id": "linear-triage-assistant",
+  "name": "Linear issue triage assistant",
+  "category": "Project management",
+  "description": "Classify new Linear issues, suggest labels, find duplicates, and ask clarifying questions.",
+  "requiredIntegrationIds": [
+    "linear"
+  ],
+  "popularityRank": 90,
+  "estimatedSetupMinutes": 3,
+  "prompt": "/linear-triage:setup",
+  "exampleImplementation": "Trigger: linear Issue create\nRequired MCP: Linear\n\n1. Load the new issue, team context, project, labels, and recent similar issues.\n2. Score priority and classify the request as bug, feature, support, or chore.\n3. TODO: map local team labels and priority conventions.\n4. Add a triage comment with rationale and suggested next actions.\n5. Optionally update labels, priority, and assignee."
+}

package/automations/catalog/research-brief-writer.json

@@ -0,0 +1,14 @@
+{
+  "id": "research-brief-writer",
+  "name": "Research brief writer",
+  "category": "Research",
+  "description": "Monitor a topic, gather sources from the web, and publish a short brief for your team.",
+  "requiredIntegrationIds": [
+    "tavily",
+    "notion"
+  ],
+  "popularityRank": 84,
+  "estimatedSetupMinutes": 7,
+  "prompt": "/research-brief:setup",
+  "exampleImplementation": "Trigger: cron, weekly or daily\nRequired MCPs: Tavily, Notion\n\n1. Run focused Tavily searches for configured topics and competitors.\n2. Deduplicate sources and rank them by freshness and authority.\n3. TODO: confirm citation format and destination Notion database schema.\n4. Write an executive summary, implications, and recommended actions.\n5. Create or update a Notion page with citations and source links."
+}

package/automations/catalog/slack-channel-monitor.json

@@ -0,0 +1,11 @@
+{
+  "id": "slack-channel-monitor",
+  "name": "Slack channel monitor",
+  "category": "Team communication",
+  "description": "Watch Slack channels for @openhands mentions, open a conversation with the message context, and reply in the thread when the agent finishes.",
+  "requiredIntegrationIds": ["slack"],
+  "popularityRank": 92,
+  "estimatedSetupMinutes": 7,
+  "prompt": "/slack-monitor:poll",
+  "exampleImplementation": "Trigger: cron, every minute\nRequired secret: SLACK_BOT_TOKEN or SLACK_USER_TOKEN\n\n1. Poll up to 10 configured Slack channels for new messages since the last run.\n2. Match messages containing the trigger phrase (default: @openhands).\n3. React with 👀 and start an OpenHands conversation with the message and recent channel context.\n4. Post a thread reply with a link to the conversation.\n5. Forward subsequent thread replies to the running conversation and post the agent's response when done."
+}

package/automations/catalog/slack-standup-digest.json

@@ -0,0 +1,13 @@
+{
+  "id": "slack-standup-digest",
+  "name": "Slack standup digest",
+  "category": "Team updates",
+  "description": "Summarize yesterday\u2019s Slack activity into an async standup note with blockers, decisions, and owners.",
+  "requiredIntegrationIds": [
+    "slack"
+  ],
+  "popularityRank": 94,
+  "estimatedSetupMinutes": 5,
+  "prompt": "/standup-digest:setup",
+  "exampleImplementation": "Trigger: cron, weekday mornings\nRequired MCP: Slack\n\n1. Search configured channels for messages since the last digest window.\n2. Cluster updates into shipped work, active work, blockers, and decisions.\n3. TODO: choose a safe allowlist for channels and whether DMs are excluded.\n4. Draft a Slack message with owners, links, and unanswered questions.\n5. Optionally post to the configured standup channel."
+}

package/automations/index.d.ts

@@ -0,0 +1,14 @@
+export interface RecommendedAutomation {
+  id: string;
+  name: string;
+  category: string;
+  description: string;
+  prompt: string;
+  exampleImplementation: string;
+  requiredIntegrationIds: string[];
+  popularityRank: number;
+  estimatedSetupMinutes: number;
+}
+
+export const AUTOMATION_CATALOG: RecommendedAutomation[];
+export default AUTOMATION_CATALOG;

package/automations/index.js

@@ -0,0 +1,18 @@
+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" };
+
+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,
+];
+export default AUTOMATION_CATALOG;

package/index.d.ts

@@ -0,0 +1,17 @@
+export {
+  INTEGRATION_CATALOG,
+  type IntegrationAuthConfig,
+  type IntegrationAuthStrategy,
+  type IntegrationCatalogEntry,
+  type IntegrationConnectionOption,
+  type IntegrationHttpConfig,
+  type IntegrationOAuthConfig,
+  type IntegrationProvider,
+  type IntegrationTransport,
+  type MarketplaceField,
+  type MarketplaceFieldType,
+  type OAuthProviderCatalogOption,
+  type OAuthProviderRegistrationDefaults,
+} from "./integrations/index.js";
+export { AUTOMATION_CATALOG } from "./automations/index.js";
+export type { RecommendedAutomation } from "./automations/index.js";

package/index.js

@@ -0,0 +1,2 @@
+export { INTEGRATION_CATALOG } from "./integrations/index.js";
+export { AUTOMATION_CATALOG } from "./automations/index.js";

package/integrations/README.md

@@ -0,0 +1,39 @@
+# Integration catalog
+
+This directory contains curated integration metadata for OpenHands clients.
+Most current entries are MCP-backed, but the schema also supports HTTP/OpenAPI
+integrations so clients can consume one source of truth.
+
+- `catalog/*.json` contains one source file per direct integration entry.
+- `index.js` assembles and exports the catalog for Node.js and bundlers.
+- `index.d.ts` contains the public TypeScript shape.
+
+Consumers can import the package export:
+
+```js
+import { INTEGRATION_CATALOG } from "@openhands/extensions/integrations";
+```
+
+## Migration from the MCP catalog
+
+This catalog replaces the experimental `@openhands/extensions/mcps` export.
+The MCP-only `mcps/` directory has been renamed to `integrations/`, and the
+old package exports were removed rather than kept as aliases.
+
+- Import `INTEGRATION_CATALOG` from `@openhands/extensions/integrations`
+  instead of `MCP_CATALOG` from `@openhands/extensions/mcps`.
+- Import logo mappings from `@openhands/extensions/integrations/logos`
+  instead of `@openhands/extensions/mcps/logos`.
+- Use `IntegrationCatalogEntry` instead of `McpCatalogEntry`.
+- Read MCP configuration from `entry.connectionOptions[]`. Direct MCP entries
+  have `provider: "mcp"` and a `transport`; entries may expose multiple
+  options such as `id: "oauth"` for a hosted OAuth MCP endpoint and `id:
+"api"` for an API-key or stdio fallback.
+- Use `entry.defaultConnectionOptionId` to choose the preferred option.
+- Automation catalog entries now use `requiredIntegrationIds` instead of
+  `requiredMcpIds`.
+
+The `mcps` API was intentionally broken because it was pre-release and had not
+been adopted as a stable public surface.
+
+The catalog intentionally stores only serializable data. Client applications are responsible for mapping entries to UI-specific icons or styling.

package/integrations/catalog/airtable.json

@@ -0,0 +1,44 @@
+{
+  "id": "airtable",
+  "name": "Airtable",
+  "description": "List bases, query records, and update fields across your Airtable workspace.",
+  "docsUrl": "https://github.com/domdomegg/airtable-mcp-server",
+  "iconBg": "#FCB400",
+  "iconColor": "var(--oh-surface-deep)",
+  "keywords": [
+    "spreadsheet",
+    "database",
+    "records",
+    "bases"
+  ],
+  "kind": "mcp",
+  "defaultConnectionOptionId": "api",
+  "connectionOptions": [
+    {
+      "id": "api",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "airtable",
+        "command": "npx",
+        "args": [
+          "-y",
+          "airtable-mcp-server"
+        ],
+        "envFields": [
+          {
+            "key": "AIRTABLE_API_KEY",
+            "label": "Airtable personal access token",
+            "type": "password",
+            "required": true,
+            "helperText": "Personal access token from your Airtable account.",
+            "helperLink": "https://airtable.com/create/tokens"
+          }
+        ]
+      },
+      "auth": {
+        "strategy": "api_key"
+      }
+    }
+  ]
+}

package/integrations/catalog/apify.json

@@ -0,0 +1,43 @@
+{
+  "id": "apify",
+  "name": "Apify Actors",
+  "description": "Run any of Apify's 5,000+ Actors (scrapers, automations) from the agent.",
+  "docsUrl": "https://docs.apify.com/platform/integrations/mcp",
+  "iconBg": "#10b981",
+  "keywords": [
+    "scraping",
+    "automation",
+    "crawl",
+    "actors"
+  ],
+  "kind": "mcp",
+  "defaultConnectionOptionId": "api",
+  "connectionOptions": [
+    {
+      "id": "api",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "apify",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@apify/actors-mcp-server"
+        ],
+        "envFields": [
+          {
+            "key": "APIFY_TOKEN",
+            "label": "Apify token",
+            "type": "password",
+            "required": true,
+            "helperText": "API token from your Apify account settings.",
+            "helperLink": "https://console.apify.com/account/integrations"
+          }
+        ]
+      },
+      "auth": {
+        "strategy": "api_key"
+      }
+    }
+  ]
+}

package/integrations/catalog/atlassian.json

@@ -0,0 +1,31 @@
+{
+  "id": "atlassian",
+  "name": "Atlassian (Jira & Confluence)",
+  "description": "Search Jira issues and Confluence pages via Atlassian's hosted MCP server.",
+  "docsUrl": "https://www.atlassian.com/platform/remote-mcp-server",
+  "iconBg": "#0052CC",
+  "keywords": [
+    "jira",
+    "confluence",
+    "tickets",
+    "wiki",
+    "issues"
+  ],
+  "kind": "mcp",
+  "defaultConnectionOptionId": "none",
+  "connectionOptions": [
+    {
+      "id": "none",
+      "provider": "mcp",
+      "transport": {
+        "kind": "sse",
+        "url": "https://mcp.atlassian.com/v1/sse",
+        "apiKeyOptional": true
+      },
+      "auth": {
+        "strategy": "none",
+        "apiKeyOptional": true
+      }
+    }
+  ]
+}

package/integrations/catalog/brave-search.json

@@ -0,0 +1,43 @@
+{
+  "id": "brave-search",
+  "name": "Brave Search",
+  "description": "Privacy-first web and local search using the Brave Search API.",
+  "docsUrl": "https://github.com/brave/brave-search-mcp-server",
+  "iconBg": "#FB542B",
+  "keywords": [
+    "search",
+    "web"
+  ],
+  "kind": "mcp",
+  "defaultConnectionOptionId": "api",
+  "connectionOptions": [
+    {
+      "id": "api",
+      "provider": "mcp",
+      "transport": {
+        "kind": "stdio",
+        "serverName": "brave_search",
+        "command": "npx",
+        "args": [
+          "-y",
+          "@brave/brave-search-mcp-server",
+          "--transport",
+          "stdio"
+        ],
+        "envFields": [
+          {
+            "key": "BRAVE_API_KEY",
+            "label": "Brave API key",
+            "type": "password",
+            "required": true,
+            "helperText": "API key from the Brave Search API portal.",
+            "helperLink": "https://api-dashboard.search.brave.com/app/keys"
+          }
+        ]
+      },
+      "auth": {
+        "strategy": "api_key"
+      }
+    }
+  ]
+}