---
title: "Preview GitHub plugin marketplace import"
method: POST
path: "/v1/plugins/import-mcps-from-github-url/preview"
tags: ["GitHub"]
---

# Preview GitHub plugin marketplace import

`POST /v1/plugins/import-mcps-from-github-url/preview`

Reads a public GitHub plugin URL and returns skills and remote MCP servers that can be imported into an organization marketplace.

## Request body

- object
  - `githubUrl` string, uri, required

## Response `200`

GitHub plugin MCP import preview returned successfully.

- GithubPluginMcpImportPreviewResponse
  - `ok` true, required
  - `item` GithubPluginMcpImportPlan, required
    - `branch` string, required
    - `classification` 'claude_marketplace_repo' | 'claude_multi_plugin_repo' | 'claude_single_plugin_repo' | 'folder_inferred_repo' | 'unsupported', required
    - `marketplace` object, nullable, required
      - `description` string, nullable, required
      - `name` string, nullable, required
      - `owner` string, nullable, required
      - `version` string, nullable, required
    - `plugins` object[], required
      - `description` string, nullable, required
      - `key` string, required
      - `mcpCount` integer, required
      - `name` string, required
      - `skillCount` integer, required
    - `repositoryFullName` string, required
    - `rootPath` string, required
    - `servers` GithubPluginMcpImportServer[], required
      - `authType` 'oauth', nullable, required
      - `connectionId` string, nullable, required
      - `name` string, required
      - `pluginKey` string, required
      - `pluginName` string, required
      - `serverKey` string, required
      - `skippedReason` 'missing_url' | 'local_unsupported' | 'invalid_url' | 'unsupported_auth', nullable, required
      - `sourcePath` string, required
      - `supported` boolean, required
      - `url` string, nullable, required
    - `skills` object[], required
      - `description` string, nullable, required
      - `name` string, required
      - `pluginKey` string, required
      - `pluginName` string, required
      - `skillKey` string, required
      - `skippedReason` 'invalid_skill', nullable, required
      - `sourcePath` string, required
      - `supported` boolean, required
    - `sourceRevisionRef` string, required
    - `warnings` string[], required

## Other responses

- `400` — The GitHub plugin MCP import preview request was invalid.
- `401` — The caller must be signed in to preview plugin MCP imports.
- `404` — The GitHub plugin path could not be found.

---

[API](https://skmtc.net/openworklabs/apis/den-api.md) · [All operations](https://skmtc.net/openworklabs/apis/den-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openworklabs/den-api/versions/805150503452/schema)