List the registered capabilities (G3-5)

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://docs.thankly.ai/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
"Thankly MCP server": {
  "url": "https://docs.thankly.ai/mcp"
}
Close
GET /v1/admin/capabilities
Http bearer

Return the runtime-supported capability registry.

By default returns runtime_supported && status == "GA"; capabilities entitled to the request's org_id are unioned in regardless of status. ?include_all=true returns every registered capability (for the docs page).

The response shape includes runtime_supported, status, cost_class, and the requires_* flags so the portal can decide what to show in the Sections editor vs the docs page, plus a top-level entitlements list when org_id resolves any override rows.

Query parameters

  • org_id string | null

    Optional org id. When set, the response applies any capability_entitlements Beta overrides for that org and unions promoted Beta capabilities into the list.

  • include_all boolean

    Skip the runtime_supported && status==GA filter and return every registered capability. Used by the docs page to render the full roadmap, including 'coming soon'.

    Default value is false.

Responses

  • 200 application/json

    Successful Response

    Hide response attributes Show response attributes object
    • capabilities array[object] Required
      Hide capabilities attributes Show capabilities attributes object

      Public-shape metadata for a single capability.

      • type string Required

        Capability identifier (e.g. 'catalog_recommendations').

      • description string Required
      • runtime_supported boolean Required

        Whether the capability is selectable in the Sections editor / wired to a working runtime path (stateless invoke OR stateful handler). The stateless/stateful distinction is carried by stateful.

      • stateful boolean

        False only for capabilities with a stateless one-shot invoker path (search_products). All AI/session handlers are stateful.

        Default value is true.

      • view_kind string

        Values are product_grid or list.

      • status string Required

        Values are GA, BETA, or COMING_SOON.

      • cost_class string Required

        Values are low, medium, or high.

      • requires_catalog boolean Required
      • requires_cart boolean Required
      • requires_uploads boolean Required
      • context_type string Required

        Values are cart, trip, topic, or any.

      • supported_layouts array[string] Required
      • default_layout string Required
      • sponsored_ranking_surface string Required

        Values are primary, embedded, or none.

      • input_schema object | null

        Additional properties are allowed.

    • entitlements array[object]

      Default value is [] (empty).

      Hide entitlements attributes Show entitlements attributes object

      Inline shape for ops-managed Beta promotions.

      Surfaced alongside :class:CapabilityMetadata when the request specifies an org_id and the org has a row in capability_entitlements. Lets the portal render a "Beta" badge without making a separate API call to enumerate which capabilities were promoted (vs which are GA-default).

      • capability_type string Required
      • status_override string Required

        Values are GA, BETA, or COMING_SOON.

      • granted_at string | null
  • 422 application/json

    Validation Error

    Hide response attribute Show response attribute object
    • detail array[object]
      Hide detail attributes Show detail attributes object
      • loc array[string | integer] Required
      • msg string Required
      • type string Required
      • input
      • ctx object
GET /v1/admin/capabilities 
curl \
 --request GET 'http://api.example.com/v1/admin/capabilities' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "capabilities": [
    {
      "type": "string",
      "description": "string",
      "runtime_supported": true,
      "stateful": true,
      "view_kind": "product_grid",
      "status": "GA",
      "cost_class": "low",
      "requires_catalog": true,
      "requires_cart": true,
      "requires_uploads": true,
      "context_type": "cart",
      "supported_layouts": [
        "string"
      ],
      "default_layout": "string",
      "sponsored_ranking_surface": "primary",
      "input_schema": {}
    }
  ],
  "entitlements": [
    {
      "capability_type": "string",
      "status_override": "GA",
      "granted_at": "string"
    }
  ]
}
Response examples (422) 
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "ctx": {}
    }
  ]
}