search

Search Kody capabilities, saved packages, integrations, and secret references using natural language or exact user-sc...

Search Kody capabilities, saved packages, integrations, and secret references using natural language or exact user-scoped package identity. An empty call returns the domain index. Pass "domain" to rank or list one capability domain. Use this inside package and execute runtimes when reusable code needs the same discovery surface as the public MCP search tool.

Org permission: search:read.

get/v1/search

Request

  • Base URL: https://api.kody.codes
  • URL: https://api.kody.codes/v1/search
  • Auth: HTTP bearer

Query parameters

querystring

Natural language description, or a scoped @owner/leaf name, current-origin account package URL, owner-matching hosted package URL, or an exact saved-package UUID (package_id) when the name is not known. Optional when "domain" is provided.

domainstring

Optional capability domain id (for example "email" or "mcp:linear"). With "query", ranks only that domain's capabilities; without "query", lists the domain's capabilities.

limitinteger

Max number of ranked results to return. Defaults to 15.

conversationIdstring

Optional short conversation identifier. Ties related calls together. If you already have a conversationId from an earlier response in the same conversation, pass it back unchanged. Otherwise omit this field to receive a server-generated ID, then reuse the returned conversationId on subsequent calls - this enables optimizations like reduced response size. Do not invent your own conversationId.

includeHiddenPackagesboolean

Include hidden packages in search results (hidden packages are excluded by default).

Response

Success.

conversationIdstring required
offlineboolean required
warningsstring[] required
guidancestring

Changes

No recorded changes to this operation across all 2 revisions of this API.