Skip to content
Core ConceptsCLI ReferenceAPI Reference
AGH RuntimeAPI Reference

Marketplace

AGH Marketplace HTTP endpoints.

Audience
Operators running durable agent work
Focus
API Reference guidance shaped for scanability, day-two clarity, and operator context.

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    }  ]}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}

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",          "install_slug": "string",          "installed": true,          "installed_name": "string",          "installed_version": "string",          "kind": "string",          "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": "string",      "next_cursor": "string",      "stale": true,      "total": 0    }  ],  "query": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}

Browse or search one marketplace kind

GET/api/marketplace/{kind}

Path Parameters

kind*string

Marketplace kind

Value in

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

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",      "install_slug": "string",      "installed": true,      "installed_name": "string",      "installed_version": "string",      "kind": "string",      "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": "string",  "next_cursor": "string",  "stale": true,  "total": 0}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}

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"
  • "bundle"
entry_id*string

Stable URL-safe marketplace entry id

Query Parameters

installed_name?string

Exact installed MCP, extension, or skill identity; rejected for bundles

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"
{  "bundle": {    "extension_name": "string",    "profiles": [      {        "agents": 0,        "bridges": 0,        "channels": 0,        "description": "string",        "jobs": 0,        "name": "string",        "triggers": 0      }    ]  },  "entry": {    "author": "string",    "description": "string",    "downloads": 0,    "entry_id": "string",    "install_slug": "string",    "installed": true,    "installed_name": "string",    "installed_version": "string",    "kind": "string",    "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": {    "args": [      "string"    ],    "command": "string",    "default_scope": "string",    "env": [      {        "default": "string",        "name": "string",        "prompt": "string",        "required": true,        "secret": true      }    ],    "oauth": {      "authorization_url": "string",      "client_id": "string",      "issuer_url": "string",      "scopes": [        "string"      ],      "token_url": "string"    },    "transport": "string",    "url": "string"  },  "skill": {    "display_name": "string",    "install_slug": "string",    "license": "string",    "readme": "string",    "repository": "string",    "tags": [      "string"    ],    "versions": [      "string"    ]  }}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}
{  "diagnostic": {    "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"  },  "error": "string"}

Skills

AGH Skills HTTP endpoints.

Tools

AGH Tools HTTP endpoints.