Zenventory MCP by usefulapi

Look up items, stock, orders and transfers; create items and orders in Zenventory.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
95%
Qualität der Benennung
71%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (6)

  • LOWTool 'zenventory_list_customer_orders' name length outside 3-30 rangein zenventory_list_customer_orders
  • LOWTool 'zenventory_list_purchase_orders' name length outside 3-30 rangein zenventory_list_purchase_orders
  • LOWTool 'zenventory_list_transfer_orders' name length outside 3-30 rangein zenventory_list_transfer_orders
  • LOWTool 'zenventory_create_customer_order' name length outside 3-30 rangein zenventory_create_customer_order
  • LOWTool 'zenventory_cancel_customer_order' name length outside 3-30 rangein zenventory_cancel_customer_order
  • LOWTool 'zenventory_create_purchase_order' name length outside 3-30 rangein zenventory_create_purchase_order

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~3,909Tokens (Tool-Definitionen)
~2.7 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (3.05% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "zenventory": {
      "url": "https://zenventory.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://zenventory.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (14)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢zenventory_list_items(searchFor, clientId, clientName, category, active, ...)

Lists inventory items (products) with optional search and filters. Read-only. Zenventory API: GET /items.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "searchFor": {
      "description": "Matches item SKU, UPC or description (exact or partial).",
      "type": "string"
    },
    "clientId": {
      "description": "Only items of this client id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "clientName": {
      "description": "Only items of the client with this name.",
      "type": "string"
    },
    "category": {
      "description": "Only items in this category.",
      "type": "string"
    },
    "active": {
      "description": "true = active items only, false = inactive items only.",
      "type": "boolean"
    },
    "orderBy": {
      "description": "Field to sort by.",
      "type": "string",
      "enum": [
        "id",
        "sku",
        "upc",
        "category",
        "unitCost",
        "price"
      ]
    },
    "orderDir": {
      "description": "Sort direction. Used only when orderBy is set (default asc).",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number of the results (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "perPage": {
      "description": "Records per page, 20 to 100 (default 20).",
      "type": "integer",
      "minimum": 20,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zenventory_get_item(id, includeUnits, includeBom)

Gets one inventory item by id, optionally with its units and bill of materials. Read-only. Zenventory API: GET /items/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The numeric Zenventory id."
    },
    "includeUnits": {
      "description": "Include the item's units of measure.",
      "type": "boolean"
    },
    "includeBom": {
      "description": "Include the bill of materials for kits and assemblies.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zenventory_list_inventory(searchFor, warehouseId, warehouseName, category, inStock, ...)

Lists stock levels per item and warehouse, with optional filters for stock and low stock. Read-only. Zenventory API: GET /inventory.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "searchFor": {
      "description": "Matches item SKU, UPC or description.",
      "type": "string"
    },
    "warehouseId": {
      "description": "Only stock in this warehouse id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "warehouseName": {
      "description": "Only stock in the warehouse with this name.",
      "type": "string"
    },
    "category": {
      "description": "Only items in this category.",
      "type": "string"
    },
    "inStock": {
      "description": "true = items with stock on hand.",
      "type": "boolean"
    },
    "lowStock": {
      "description": "true = items at or below their reorder level.",
      "type": "boolean"
    },
    "orderBy": {
      "description": "Field to sort by.",
      "type": "string",
      "enum": [
        "id",
        "sku",
        "upc",
        "category",
        "inStock",
        "allocated"
      ]
    },
    "orderDir": {
      "description": "Sort direction. Used only when orderBy is set (default asc).",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number of the results (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "perPage": {
      "description": "Records per page, 20 to 100 (default 20).",
      "type": "integer",
      "minimum": 20,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zenventory_list_customer_orders(open, completed, draft, cancelled, page, ...)

Lists customer orders, optionally only open, completed, draft or cancelled ones. Read-only. Zenventory API: GET /customer-orders.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "open": {
      "description": "true = open orders only.",
      "type": "boolean"
    },
    "completed": {
      "description": "true = completed orders only.",
      "type": "boolean"
    },
    "draft": {
      "description": "true = draft orders only.",
      "type": "boolean"
    },
    "cancelled": {
      "description": "true = cancelled orders only.",
      "type": "boolean"
    },
    "page": {
      "description": "Page number of the results (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "perPage": {
      "description": "Records per page, 20 to 100 (default 20).",
      "type": "integer",
      "minimum": 20,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zenventory_get_customer_order(id, includePickedItemMetadata)

Gets one customer order by id, with its items and addresses. Read-only. Zenventory API: GET /customer-orders/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The numeric Zenventory id."
    },
    "includePickedItemMetadata": {
      "description": "Include picking details for each item.",
      "type": "boolean"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zenventory_list_purchase_orders(orderNumber, supplierId, supplierName, open, completed, ...)

Lists purchase orders to suppliers, optionally filtered by supplier, order number or status. Read-only. Zenventory API: GET /purchase-orders.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "orderNumber": {
      "description": "Purchase order number.",
      "type": "string"
    },
    "supplierId": {
      "description": "Only orders for this supplier id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "supplierName": {
      "description": "Only orders for the supplier with this name.",
      "type": "string"
    },
    "open": {
      "description": "true = open orders only.",
      "type": "boolean"
    },
    "completed": {
      "description": "true = completed orders only.",
      "type": "boolean"
    },
    "draft": {
      "description": "true = draft orders only.",
      "type": "boolean"
    },
    "orderBy": {
      "description": "Field to sort by.",
      "type": "string",
      "enum": [
        "id",
        "orderNumber",
        "createdDate",
        "preparedDate",
        "requiredByDate"
      ]
    },
    "orderDir": {
      "description": "Sort direction. Used only when orderBy is set (default asc).",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number of the results (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "perPage": {
      "description": "Records per page, 20 to 100 (default 20).",
      "type": "integer",
      "minimum": 20,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zenventory_get_purchase_order(id)

Gets one purchase order by id, with its items. Read-only. Zenventory API: GET /purchase-orders/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The numeric Zenventory id."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zenventory_list_transfer_orders(open, completed, draft, cancelled, originWarehouseId, ...)

Lists stock transfer orders between warehouses, optionally filtered by warehouse or status. Read-only. Zenventory API: GET /transfer-orders.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "open": {
      "description": "true = open transfers only.",
      "type": "boolean"
    },
    "completed": {
      "description": "true = completed transfers only.",
      "type": "boolean"
    },
    "draft": {
      "description": "true = draft transfers only.",
      "type": "boolean"
    },
    "cancelled": {
      "description": "true = cancelled transfers only.",
      "type": "boolean"
    },
    "originWarehouseId": {
      "description": "Only transfers from this warehouse id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "destinationWarehouseId": {
      "description": "Only transfers to this warehouse id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "orderBy": {
      "description": "Field to sort by.",
      "type": "string",
      "enum": [
        "id",
        "originWarehouse",
        "destinationWarehouse",
        "createdDate",
        "requiredByDate"
      ]
    },
    "orderDir": {
      "description": "Sort direction. Used only when orderBy is set (default asc).",
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ]
    },
    "page": {
      "description": "Page number of the results (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "perPage": {
      "description": "Records per page, 20 to 100 (default 20).",
      "type": "integer",
      "minimum": 20,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zenventory_get_transfer_order(id)

Gets one transfer order by id, with its items. Read-only. Zenventory API: GET /transfer-orders/{id}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The numeric Zenventory id."
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zenventory_list_cycle_counts(type, inProgress, completed, approved, warehouseId, ...)

Lists stock counts (cycle counts), optionally filtered by type, warehouse or status. Read-only. Zenventory API: GET /cycle-counts.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "type": {
      "description": "Count type.",
      "type": "string",
      "enum": [
        "normal",
        "adjustment"
      ]
    },
    "inProgress": {
      "description": "true = counts still in progress.",
      "type": "boolean"
    },
    "completed": {
      "description": "true = completed counts only.",
      "type": "boolean"
    },
    "approved": {
      "description": "true = approved counts only.",
      "type": "boolean"
    },
    "warehouseId": {
      "description": "Only counts in this warehouse id.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "orderBy": {
      "description": "Field to sort by.",
      "type": "string",
      "enum": [
        "id",
        "createdDate"
      ]
    },
    "page": {
      "description": "Page number of the results (default 1).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "perPage": {
      "description": "Records per page, 20 to 100 (default 20).",
      "type": "integer",
      "minimum": 20,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴zenventory_create_item(sku, description, upc, category, baseUom, ...)

CREATES a new inventory item (a new SKU) in the company's Zenventory account. It stays in the account until someone edits or deletes it in Zenventory. Zenventory API: POST /items.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "sku": {
      "type": "string",
      "minLength": 1,
      "description": "New item SKU. Must be unique in the account."
    },
    "description": {
      "description": "Item description.",
      "type": "string"
    },
    "upc": {
      "description": "UPC or barcode.",
      "type": "string"
    },
    "category": {
      "description": "Item category.",
      "type": "string"
    },
    "baseUom": {
      "description": "Base unit of measure, for example each.",
      "type": "string"
    },
    "unitCost": {
      "description": "Unit cost.",
      "type": "number"
    },
    "price": {
      "description": "Selling price.",
      "type": "number"
    },
    "rrp": {
      "description": "Recommended retail price.",
      "type": "number"
    },
    "active": {
      "description": "Whether the item is active (default set by Zenventory).",
      "type": "boolean"
    },
    "perishable": {
      "type": "boolean"
    },
    "trackLot": {
      "description": "Track lot numbers.",
      "type": "boolean"
    },
    "serialized": {
      "description": "Track serial numbers.",
      "type": "boolean"
    },
    "nonInventory": {
      "description": "Non-inventory item, not stocked.",
      "type": "boolean"
    },
    "warehouseId": {
      "description": "Warehouse id to assign the item to.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "reorderLevel": {
      "description": "Stock level that triggers a reorder.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "notes": {
      "type": "string"
    }
  },
  "required": [
    "sku"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴zenventory_create_customer_order(customer, shippingAddress, billingAddress, items, orderNumber, ...)

CREATES a customer order. It is saved as a DRAFT unless saveAsDraft is false; a non-draft order can trigger fulfilment and customer notices, so set saveAsDraft false only on purpose. Zenventory API: POST /customer-orders.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "customer": {
      "type": "object",
      "properties": {
        "id": {
          "description": "Existing customer id. Leave out to create a new customer.",
          "type": "integer",
          "minimum": -9007199254740991,
          "maximum": 9007199254740991
        },
        "name": {
          "type": "string"
        },
        "company": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "accountNumber": {
          "type": "string"
        }
      },
      "description": "Customer the order is for."
    },
    "shippingAddress": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "company": {
          "type": "string"
        },
        "line1": {
          "type": "string"
        },
        "line2": {
          "type": "string"
        },
        "line3": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "zip": {
          "type": "string"
        },
        "countryCode": {
          "description": "Country code, for example US.",
          "type": "string"
        },
        "phone": {
          "type": "string"
        }
      },
      "description": "Postal address."
    },
    "billingAddress": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "company": {
          "type": "string"
        },
        "line1": {
          "type": "string"
        },
        "line2": {
          "type": "string"
        },
        "line3": {
          "type": "string"
        },
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "zip": {
          "type": "string"
        },
        "countryCode": {
          "description": "Country code, for example US.",
          "type": "string"
        },
        "phone": {
          "type": "string"
        }
      },
      "description": "Postal address."
    },
    "items": {
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "itemId": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Item id."
          },
          "sku": {
            "type": "string",
            "description": "Item SKU."
          },
          "quantity": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "Quantity to order."
          },
          "uom": {
            "description": "Unit of measure.",
            "type": "string"
          },
          "price": {
            "description": "Unit price.",
            "type": "number"
          },
          "discountPercentage": {
            "description": "Line discount, in percent.",
            "type": "number"
          }
        },
        "required": [
          "itemId",
          "sku",
          "quantity"
        ]
      },
      "description": "Order lines."
    },
    "orderNumber": {
      "description": "Your own order number.",
      "type": "string"
    },
    "clientName": {
      "description": "Client (customer account) name, when the account has several.",
      "type": "string"
    },
    "shipFromWarehouseId": {
      "description": "Warehouse id to ship from.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "shipVia": {
      "description": "Carrier or shipping method.",
      "type": "string"
    },
    "orderReference": {
      "description": "Customer reference.",
      "type": "string"
    },
    "noteToCustomer": {
      "description": "Note shown to the customer.",
      "type": "string"
    },
    "internalNote": {
      "description": "Internal note, not shown to the customer.",
      "type": "string"
    },
    "notificationEmail": {
      "description": "Email address for order notices.",
      "type": "string"
    },
    "saveAsDraft": {
      "description": "true = save as a draft (default true).",
      "type": "boolean"
    }
  },
  "required": [
    "customer",
    "shippingAddress",
    "billingAddress",
    "items"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴zenventory_cancel_customer_order(id, cancelReason)

CANCELS a customer order. This changes the order's status in Zenventory and cannot be undone from this tool. Zenventory API: PUT /customer-orders/{id}/cancel.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991,
      "description": "The numeric Zenventory id."
    },
    "cancelReason": {
      "description": "Reason recorded with the cancellation.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴zenventory_create_purchase_order(supplierId, supplierName, warehouseId, warehouseName, orderNumber, ...)

CREATES a purchase order to a supplier. It is saved as a DRAFT unless draft is false; a sent order commits the company to the supplier, so set draft false only on purpose. Zenventory API: POST /purchase-orders.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "supplierId": {
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991,
      "description": "Supplier id."
    },
    "supplierName": {
      "type": "string",
      "minLength": 1,
      "description": "Supplier name, as it appears in Zenventory."
    },
    "warehouseId": {
      "description": "Warehouse id that receives the goods.",
      "type": "integer",
      "minimum": -9007199254740991,
      "maximum": 9007199254740991
    },
    "warehouseName": {
      "description": "Warehouse name that receives the goods.",
      "type": "string"
    },
    "orderNumber": {
      "description": "Your own purchase order number.",
      "type": "string"
    },
    "requiredByDate": {
      "description": "Date the goods are needed, as the Zenventory API accepts it.",
      "type": "string"
    },
    "notes": {
      "type": "string"
    },
    "items": {
      "description": "Order lines. Leave out to create an order without lines.",
      "minItems": 1,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "itemId": {
            "type": "integer",
            "minimum": -9007199254740991,
            "maximum": 9007199254740991,
            "description": "Item id."
          },
          "sku": {
            "type": "string",
            "description": "Item SKU."
          },
          "description": {
            "type": "string",
            "description": "Item description."
          },
          "quantity": {
            "type": "integer",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "description": "Quantity to order."
          },
          "uom": {
            "description": "Unit of measure.",
            "type": "string"
          },
          "unitCost": {
            "description": "Unit cost from the supplier.",
            "type": "number"
          }
        },
        "required": [
          "itemId",
          "sku",
          "description",
          "quantity"
        ]
      }
    },
    "draft": {
      "description": "true = save as a draft (default true).",
      "type": "boolean"
    }
  },
  "required": [
    "supplierId",
    "supplierName"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet14 Tools