Docs/MCP Tools/list_library
MCP Toollist_libraryScope: library:read

List User Library

Inspect all digital assets, commercial licenses, and packages owned by the authenticated user in their permanent Krafto library.

Description

List User Library inspects the authenticated user's permanent asset collection. When a user purchases an asset through the store, acquires an item with wallet credits, or claims a resource included under their Pro / VIP plan, the license grant is permanently registered in their Krafto library. This tool returns a paginated list of all owned items along with acquired timestamps, license tiers (Standard Commercial, Extended, Broadcast), lifetime download counts, and direct asset references. Coding agents invoke this tool at the start of a coding or design session to discover which fonts, 3D meshes, and UI templates are already available in the user's inventory, preventing duplicate purchases and reusing existing licensed assets.

AI Agent Guidance & Best Practices

Always query list_library before recommending that a user purchase a new asset. If an owned asset matches the user's requirements, proceed directly to checking entitlement and generating a download URL.

Input Arguments

2 parameters
ParameterTypeRequiredDefaultDescription
pagenumberOptional1Pagination page number (1-based index) to navigate library pages.
limitnumberOptional25Maximum number of owned library items to return per page (min: 1, max: 50).

Request Example

{
  "jsonrpc": "2.0",
  "id": "call_05",
  "method": "tools/call",
  "params": {
    "name": "list_library",
    "arguments": {
      "limit": 10
    }
  }
}

Response Schema Example

application/json
{
  "totalOwned": 18,
  "items": [
    {
      "assetId": "ast_neon_matrix",
      "title": "Neon Matrix Display Typeface",
      "acquiredAt": "2026-03-05T14:22:10Z",
      "licenseType": "Commercial",
      "downloadCount": 3
    }
  ]
}