search

Same catalog search as the MCP `search` tool, including exact `entity` refs.

Same catalog search as the MCP search tool, including exact entity refs. Requires search:read. The result envelope matches the tool (content, structuredContent, isError). GET /v1/search remains the capability.

Org permission: search:read.

post/v1/search/tool

Request

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

Request body

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.

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

Number of ranked results to return. Defaults to 15.

maxResponseSizeinteger

Response size budget before trimming low-ranked results. Defaults to 4000.

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.

structuredContentobject required
isErrorboolean required

Changes

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