Uoink 3.12.0 / tool reference

claim_library_work

Lease Librarian evidence packets, or renew, release or cancel your current attempts.

Inputs

Input variant 1

actionRequired: see full schema
run_idRequired: text
client_idRequired: text
max_itemsOptional: whole number (default: 12)
lease_secondsOptional: whole number (default: 900)

Input variant 2

actionRequired: see full schema
work_idRequired: text
client_idRequired: text
attempt_tokenRequired: text
lease_secondsRequired: whole number

Input variant 3

actionRequired: one of: release, cancel
work_idRequired: text
client_idRequired: text
attempt_tokenRequired: text
reasonRequired: text

Full input schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "client": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "key": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "hash": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$"
    },
    "token": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43,128}$"
    },
    "revision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647
    },
    "confidence": {
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "evidence": {
      "type": "object",
      "properties": {
        "basis": {
          "type": "string",
          "enum": [
            "packet",
            "fetched_full"
          ]
        },
        "kind": {
          "type": "string",
          "enum": [
            "timed_clip",
            "text_only"
          ]
        },
        "excerpt_id": {
          "$ref": "#/$defs/hash"
        },
        "card_hash": {
          "$ref": "#/$defs/hash"
        },
        "quote": {
          "type": "string",
          "minLength": 1,
          "maxLength": 1000
        }
      },
      "required": [
        "basis",
        "kind",
        "excerpt_id",
        "card_hash",
        "quote"
      ],
      "additionalProperties": false
    },
    "membership": {
      "type": "object",
      "properties": {
        "shelf_id": {
          "$ref": "#/$defs/id"
        },
        "shelf_path": {
          "type": "array",
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "minItems": 1,
          "maxItems": 3
        },
        "confidence": {
          "$ref": "#/$defs/confidence"
        },
        "evidence": {
          "$ref": "#/$defs/evidence"
        }
      },
      "required": [
        "shelf_id",
        "shelf_path",
        "confidence",
        "evidence"
      ],
      "additionalProperties": false
    },
    "result": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "outcome": {
              "const": "assigned"
            },
            "memberships": {
              "type": "array",
              "items": {
                "$ref": "#/$defs/membership"
              },
              "minItems": 1,
              "maxItems": 3
            }
          },
          "required": [
            "outcome",
            "memberships"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "outcome": {
              "type": "string",
              "enum": [
                "unmapped",
                "unsupported",
                "error"
              ]
            },
            "reason": {
              "type": "string",
              "minLength": 1,
              "maxLength": 500
            }
          },
          "required": [
            "outcome",
            "reason"
          ],
          "additionalProperties": false
        }
      ]
    },
    "usage": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "status": {
              "const": "reported"
            },
            "model": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "input_tokens": {
              "type": "integer",
              "minimum": 0,
              "maximum": 2147483647
            },
            "output_tokens": {
              "type": "integer",
              "minimum": 0,
              "maximum": 2147483647
            },
            "cache_read_tokens": {
              "type": "integer",
              "minimum": 0,
              "maximum": 2147483647
            },
            "cache_create_tokens": {
              "type": "integer",
              "minimum": 0,
              "maximum": 2147483647
            },
            "wall_time_ms": {
              "type": "integer",
              "minimum": 0,
              "maximum": 2147483647
            }
          },
          "required": [
            "status",
            "model",
            "input_tokens",
            "output_tokens",
            "wall_time_ms"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "status": {
              "const": "unavailable"
            },
            "model": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "reason": {
              "type": "string",
              "minLength": 1,
              "maxLength": 500
            },
            "wall_time_ms": {
              "type": "integer",
              "minimum": 0,
              "maximum": 2147483647
            }
          },
          "required": [
            "status",
            "reason"
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "oneOf": [
    {
      "type": "object",
      "properties": {
        "action": {
          "const": "claim"
        },
        "run_id": {
          "$ref": "#/$defs/id"
        },
        "client_id": {
          "$ref": "#/$defs/client"
        },
        "max_items": {
          "type": "integer",
          "minimum": 1,
          "maximum": 12,
          "default": 12
        },
        "lease_seconds": {
          "type": "integer",
          "minimum": 60,
          "maximum": 900,
          "default": 900
        }
      },
      "required": [
        "action",
        "run_id",
        "client_id"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "const": "renew"
        },
        "work_id": {
          "$ref": "#/$defs/id"
        },
        "client_id": {
          "$ref": "#/$defs/client"
        },
        "attempt_token": {
          "$ref": "#/$defs/token"
        },
        "lease_seconds": {
          "type": "integer",
          "minimum": 60,
          "maximum": 900
        }
      },
      "required": [
        "action",
        "work_id",
        "client_id",
        "attempt_token",
        "lease_seconds"
      ],
      "additionalProperties": false
    },
    {
      "type": "object",
      "properties": {
        "action": {
          "type": "string",
          "enum": [
            "release",
            "cancel"
          ]
        },
        "work_id": {
          "$ref": "#/$defs/id"
        },
        "client_id": {
          "$ref": "#/$defs/client"
        },
        "attempt_token": {
          "$ref": "#/$defs/token"
        },
        "reason": {
          "type": "string",
          "minLength": 1,
          "maxLength": 500
        }
      },
      "required": [
        "action",
        "work_id",
        "client_id",
        "attempt_token",
        "reason"
      ],
      "additionalProperties": false
    }
  ]
}

Outputs and behavior

Lease Librarian evidence packets, or renew, release or cancel your current attempts. Use after list_library_work to acquire work; use submit_library_result to store an assignment. Claim returns up to twelve packets with attempt tokens. Renew/release/cancel require the work_id and attempt_token from that claim. Leases last 60-900 seconds, never beyond one hour from first claim; three attempts exhaust a row.

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.

Input variant 1

{
  "name": "claim_library_work",
  "arguments": {
    "action": "claim",
    "run_id": "YOUR_RUN_ID",
    "client_id": "YOUR_CLIENT_ID",
    "max_items": 12,
    "lease_seconds": 900
  }
}

Input variant 2

{
  "name": "claim_library_work",
  "arguments": {
    "action": "renew",
    "work_id": "YOUR_WORK_ID",
    "client_id": "YOUR_CLIENT_ID",
    "attempt_token": "REPLACE_WITH_REAL_TOKEN____________________",
    "lease_seconds": 60
  }
}

Input variant 3

{
  "name": "claim_library_work",
  "arguments": {
    "action": "release",
    "work_id": "YOUR_WORK_ID",
    "client_id": "YOUR_CLIENT_ID",
    "attempt_token": "REPLACE_WITH_REAL_TOKEN____________________",
    "reason": "YOUR_REASON"
  }
}

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.

Set up your client All MCP tools

Source

Uoink 3.12.0 tool registry. Synced 2026-10-30.

Synced tool manifest / Registry at source commit 318fd0c