Skip to content

Marketplace

CompozyOS Marketplace HTTP endpoints.

For people running agent work32 pages in this section

Refresh all or one feed-backed marketplace kind

POST/api/marketplace/refresh

Query Parameters

kind?string

Optional feed-backed kind

Value in

  • "mcp"
  • "extension"
  • "skill"

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/api/marketplace/refresh"
{  "kinds": [    {      "entry_count": 0,      "error_class": "string",      "kind": "string",      "outcome": "string",      "stale": true    }  ]}

Search the grouped marketplace catalog

GET/api/marketplace/search

Query Parameters

q?string

Search query; empty returns curated idle slices

limit?integer

Maximum results per kind from 1 to 100

Formatint32
scope?string

Installed-state projection scope

Value in

  • "global"
  • "workspace"
workspace_id?string

Required for workspace installed-state projection

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/marketplace/search"
{  "kinds": [    {      "error": "string",      "error_class": "string",      "items": [        {          "author": "string",          "description": "string",          "downloads": 0,          "entry_id": "string",          "format": "string",          "install_slug": "string",          "installed": true,          "installed_name": "string",          "installed_version": "string",          "kind": "mcp",          "manage_path": "string",          "name": "string",          "published_at": "2019-08-24T14:15:22Z",          "source": "string",          "tier": "string",          "transport": "string",          "trust": {            "allow_unverified": true,            "checksum_verified": true,            "decision": "string",            "registry_tier": "string",            "warnings": [              {                "category": "string",                "code": "string",                "data_freshness": "string",                "doc_url": "string",                "evidence": {                  "property1": null,                  "property2": null                },                "id": "string",                "message": "string",                "severity": "string",                "suggested_command": "string",                "title": "string"              }            ]          },          "update_available": true,          "updated_at": "2019-08-24T14:15:22Z",          "version": "string"        }      ],      "kind": "mcp",      "next_cursor": "string",      "stale": true,      "total": 0    }  ],  "query": "string"}

Browse or search one marketplace kind

GET/api/marketplace/{kind}

Path Parameters

kind*string

Marketplace kind

Value in

  • "mcp"
  • "extension"
  • "skill"

Query Parameters

q?string

Optional kind search query

limit?integer

Maximum results from 1 to 100

Formatint32
cursor?string

Opaque next_cursor from the previous page

scope?string

Installed-state projection scope

Value in

  • "global"
  • "workspace"
workspace_id?string

Required for workspace installed-state projection

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/marketplace/mcp"
{  "error": "string",  "error_class": "string",  "items": [    {      "author": "string",      "description": "string",      "downloads": 0,      "entry_id": "string",      "format": "string",      "install_slug": "string",      "installed": true,      "installed_name": "string",      "installed_version": "string",      "kind": "mcp",      "manage_path": "string",      "name": "string",      "published_at": "2019-08-24T14:15:22Z",      "source": "string",      "tier": "string",      "transport": "string",      "trust": {        "allow_unverified": true,        "checksum_verified": true,        "decision": "string",        "registry_tier": "string",        "warnings": [          {            "category": "string",            "code": "string",            "data_freshness": "string",            "doc_url": "string",            "evidence": {              "property1": null,              "property2": null            },            "id": "string",            "message": "string",            "severity": "string",            "suggested_command": "string",            "title": "string"          }        ]      },      "update_available": true,      "updated_at": "2019-08-24T14:15:22Z",      "version": "string"    }  ],  "kind": "mcp",  "next_cursor": "string",  "stale": true,  "total": 0}

Get one marketplace entry by stable entry id

GET/api/marketplace/{kind}/{entry_id}

Path Parameters

kind*string

Marketplace kind

Value in

  • "mcp"
  • "extension"
  • "skill"
entry_id*string

Stable URL-safe marketplace entry id

Query Parameters

installed_name?string

Exact installed MCP, extension, or skill identity

scope?string

Installed-state projection scope

Value in

  • "global"
  • "workspace"
workspace_id?string

Required for workspace installed-state projection

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/marketplace/mcp/string"
{  "entry": {    "author": "string",    "description": "string",    "downloads": 0,    "entry_id": "string",    "format": "string",    "install_slug": "string",    "installed": true,    "installed_name": "string",    "installed_version": "string",    "kind": "mcp",    "manage_path": "string",    "name": "string",    "published_at": "2019-08-24T14:15:22Z",    "source": "string",    "tier": "string",    "transport": "string",    "trust": {      "allow_unverified": true,      "checksum_verified": true,      "decision": "string",      "registry_tier": "string",      "warnings": [        {          "category": "string",          "code": "string",          "data_freshness": "string",          "doc_url": "string",          "evidence": {            "property1": null,            "property2": null          },          "id": "string",          "message": "string",          "severity": "string",          "suggested_command": "string",          "title": "string"        }      ]    },    "update_available": true,    "updated_at": "2019-08-24T14:15:22Z",    "version": "string"  },  "extension": {    "artifact_url": "string",    "digest_sha256": "string",    "install_slug": "string",    "repository": "string"  },  "mcp": {    "auth": {      "method": "string",      "registration": "string",      "scopes": [        "string"      ]    },    "default_scope": "string",    "inputs": [      {        "binding": {          "name": "string",          "type": "string"        },        "default": null,        "id": "string",        "prompt": "string",        "required": true,        "type": "string"      }    ],    "launch": {      "args": [        "string"      ],      "digest": "string",      "image": "string",      "package": "string",      "type": "string",      "url": "string",      "version": "string"    }  },  "skill": {    "display_name": "string",    "install_slug": "string",    "license": "string",    "readme": "string",    "repository": "string",    "tags": [      "string"    ],    "versions": [      "string"    ]  }}

Skills

CompozyOS Skills HTTP endpoints.

Tools

CompozyOS Tools HTTP endpoints.