Uoink 3.12.0 / tool reference

query_by_facets

List saved items matching all supplied facet and tag filters, newest first.

Inputs

formatOptional

text

performance_tierOptional

text

hook_typeOptional

text

topicOptional

text

length_bucketOptional

text

tagOptional

text

limitOptional

whole number (default: 50)

Full input schema
{
  "type": "object",
  "properties": {
    "format": {
      "type": "string"
    },
    "performance_tier": {
      "type": "string"
    },
    "hook_type": {
      "type": "string"
    },
    "topic": {
      "type": "string"
    },
    "length_bucket": {
      "type": "string"
    },
    "tag": {
      "type": "string"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500,
      "default": 50
    }
  },
  "additionalProperties": false,
  "required": []
}

Outputs and behavior

List saved items matching all supplied facet and tag filters, newest first. Use for exact stored-label selection; use search_uoinks for text relevance, classify_facets to write labels, or get_facet_taxonomy to discover supported axes. Returns yoinks and count from local storage. Filters are AND-combined; omitted filters leave that axis unrestricted.

The registry does not publish an output schema for this tool. The description above is its documented behavior; response fields beyond it are not specified here.

Example call

Example tool name and arguments, generated from the input schema. Replace placeholder strings and sample numbers with your own values. This is a request template, not a recorded call or response.

{
  "name": "query_by_facets",
  "arguments": {
    "limit": 50
  }
}

Clients

This tool is available to MCP clients using stdio or http.

The registry records transport support, not individual client test results. See the MCP setup reference for named clients, configuration, and tool-list limits.

Source

Uoink 3.12.0 tool registry. Synced .

Synced tool manifest / Registry at source commit 318fd0c