Zettle MCP by usefulapi

Read sales, products, stock, balance and payouts; create products in Zettle.

Sollte ich dies verwenden

Qualität der Beschreibung

97%

Vollständigkeit des Schemas

81%

Qualität der Benennung

79%

Risiko der Vergiftung

100%

Übereinstimmung der Berechtigungen

100%

Einhaltung des Protokolls

100%

Befunde (1)

LOWTool 'zettle_list_account_transactions' name length outside 3-30 rangein zettle_list_account_transactions

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

Kontextkosten

~3,265Tokens (Tool-Definitionen)

~1.4 KBTypische Antwortgröße

Erhebliche Auswirkung auf die Aufmerksamkeit (2.55% 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": {
    "zettle": {
      "url": "https://zettle.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

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

Was es kann

Tool-Inventar

The Zettle user and organization this API key belongs to (uuid, organizationUuid). GET oauth.zettle.com/users/self.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List POS purchases (sales and refunds) with amount, currency, timestamp, products, discounts, payments, refund info and the cashier. Needs READ:PURCHASE. Amounts are in the smallest currency unit. Default window is the last 3 years. Page with next_page_hash (pass it back as last_purchase_hash with the same other arguments). GET /purchases/v2.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Only purchases from this UTC date or date-time on (inclusive), e.g. 2026-10-01."
    },
    "end_date": {
      "type": "string",
      "description": "Only purchases before this UTC date or date-time (exclusive), e.g. 2026-10-08."
    },
    "limit": {
      "description": "Purchases per page, 1-1000 (default 25).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "descending": {
      "description": "true = most recent first (default false: oldest first).",
      "type": "boolean"
    },
    "last_purchase_hash": {
      "description": "next_page_hash of the previous reply, for the next page.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,100}$"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One purchase (sale or refund) in full by its purchase UUID (the purchaseUUID1 field of zettle_list_purchases; the older short purchaseUUID is deprecated and not accepted): line items, VAT, payments, refund links. Needs READ:PURCHASE. GET /purchase/v2/{purchaseUuid}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "purchase_uuid": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Purchase UUID: the purchaseUUID1 field (a UUID such as 589c2de6-3ee4-11eb-9e70-a2ac075b17fd)."
    }
  },
  "required": [
    "purchase_uuid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the products in the POS product library with variants (SKU, barcode, price, cost price, VAT), category, online status and ETag. Zettle returns the whole library at once; this tool slices it with limit/offset and filters by name. Needs READ:PRODUCT. Prices are in the smallest currency unit. GET /organizations/self/products/v2.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "name_contains": {
      "description": "Only products whose name contains this text (case-insensitive).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "limit": {
      "description": "Products to return, 1-200 (default 50).",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "offset": {
      "description": "Products to skip (default 0). Use next_offset of the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

One product by UUID with all variants, prices, VAT, category, images and online-store data. Needs READ:PRODUCT. GET /organizations/self/products/{productUuid}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "product_uuid": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "Product UUID."
    }
  },
  "required": [
    "product_uuid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the product categories (uuid, name). Needs READ:PRODUCT. GET /organizations/self/categories/v2.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The product library together with its discounts (name, amount or percentage), paginated. Returns products, discounts and next_offset (pass it back as offset). Needs READ:PRODUCT. GET /organizations/self/library.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Items per page, 1-500 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    },
    "offset": {
      "description": "Position to start from (default 0); use next_offset of the previous reply.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

WRITE: add a new product to the Zettle product library (it appears in the POS and, if enabled, the online store). Not idempotent: calling twice creates two products. Needs READ:PRODUCT and WRITE:PRODUCT. vat_percentage must be one of the VAT rates enabled in the merchant's Zettle settings. Prices are in the smallest currency unit. POST /organizations/self/products.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "Product name."
    },
    "description": {
      "description": "Product description.",
      "type": "string",
      "maxLength": 1024
    },
    "vat_percentage": {
      "type": "number",
      "minimum": 0,
      "maximum": 100,
      "description": "VAT percent, e.g. 25. Must match a rate set in the merchant's Zettle account."
    },
    "variants": {
      "minItems": 1,
      "maxItems": 99,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "description": "Variant name (e.g. Small).",
            "type": "string",
            "minLength": 1,
            "maxLength": 255
          },
          "description": {
            "type": "string",
            "maxLength": 1024
          },
          "sku": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "barcode": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100
          },
          "price": {
            "description": "Selling price in the smallest currency unit (omit for a product priced at the till).",
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          },
          "cost_price": {
            "description": "Cost price in the smallest currency unit.",
            "type": "integer",
            "minimum": 0,
            "maximum": 1000000000
          },
          "currency": {
            "description": "Currency of price and cost_price; required when either is set (e.g. SEK, GBP, EUR).",
            "type": "string",
            "pattern": "^[A-Z]{3}$"
          }
        }
      },
      "description": "1-99 variants (a product without options has one)."
    }
  },
  "required": [
    "name",
    "vat_percentage",
    "variants"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the stock locations (inventories): inventoryUuid, name, type (STORE, SOLD, SUPPLIER, BIN) and which is the default. Use the STORE inventoryUuid with zettle_get_stock. Needs READ:PRODUCT. GET /v3/inventories.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Stock balances per product variant (balance, low-stock level and alert, last update). With inventory_uuid: that STORE inventory only; without: all stores. Only products with inventory tracking enabled appear. Needs READ:PRODUCT. Page with next_cursor. GET /v3/stock or /v3/stock/{inventoryUuid}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "inventory_uuid": {
      "description": "Limit to this inventory (see zettle_list_inventories).",
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
    },
    "cursor": {
      "description": "next_cursor of the previous reply, for the next page.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:-]{1,200}$"
    },
    "limit": {
      "description": "Balances per page, 1-1000 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Stock balances of a few specific products in one inventory (read-only lookup, nothing is changed). Needs READ:PRODUCT. Page with next_cursor (send the same product_uuids again). POST /v3/stock/{inventoryUuid}/products with the product UUIDs.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "inventory_uuid": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$",
      "description": "The inventory (see zettle_list_inventories)."
    },
    "product_uuids": {
      "minItems": 1,
      "maxItems": 100,
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$"
      },
      "description": "1-100 product UUIDs."
    },
    "cursor": {
      "description": "next_cursor of the previous reply, for the next page.",
      "type": "string",
      "pattern": "^[A-Za-z0-9_.:-]{1,200}$"
    },
    "limit": {
      "description": "Balances per page, 1-1000 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    }
  },
  "required": [
    "inventory_uuid",
    "product_uuids"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

The merchant's Zettle account balance (totalBalance in the smallest currency unit, currencyId). LIQUID = money available for payout; PRELIMINARY = payments not yet settled. Optional point in time. Needs READ:FINANCE. GET /v2/accounts/{LIQUID|PRELIMINARY}/balance.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string",
      "enum": [
        "LIQUID",
        "PRELIMINARY"
      ],
      "description": "LIQUID (available for payout) or PRELIMINARY (not yet settled)."
    },
    "at": {
      "type": "string",
      "description": "Balance as of this UTC date-time (default now)."
    }
  },
  "required": [
    "account"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Transactions (payments, fees, payouts, adjustments) in the LIQUID or PRELIMINARY account between start and end (end exclusive), with timestamp, amount (smallest currency unit, can be negative), type and originating transaction UUID. Needs READ:FINANCE. Page with next_offset. GET /v2/accounts/{account}/transactions.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "account": {
      "type": "string",
      "enum": [
        "LIQUID",
        "PRELIMINARY"
      ],
      "description": "LIQUID or PRELIMINARY."
    },
    "start": {
      "type": "string",
      "description": "Start, UTC date or date-time (inclusive), e.g. 2026-10-01."
    },
    "end": {
      "type": "string",
      "description": "End, UTC date or date-time (exclusive), e.g. 2026-11-01."
    },
    "types": {
      "description": "Only these transaction types (default all).",
      "maxItems": 13,
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "ADJUSTMENT",
          "ADVANCE",
          "ADVANCE_DOWNPAYMENT",
          "ADVANCE_FEE_DOWNPAYMENT",
          "CASHBACK",
          "FAILED_PAYOUT",
          "FROZEN_FUNDS",
          "INVOICE_PAYMENT",
          "INVOICE_PAYMENT_FEE",
          "PAYMENT",
          "PAYMENT_FEE",
          "PAYMENT_PAYOUT",
          "PAYOUT"
        ]
      }
    },
    "limit": {
      "description": "Transactions per page, 1-1000 (default 100).",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "offset": {
      "description": "Transactions to skip (default 0); use next_offset.",
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000
    }
  },
  "required": [
    "account",
    "start",
    "end"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Payout information of the LIQUID account: totalBalance, currencyId, nextPayoutAmount, discountRemaining and payout periodicity. Needs READ:FINANCE. GET /v2/payout-info.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "at": {
      "type": "string",
      "description": "As of this UTC date-time (default now)."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

01.11.2026, 02:32 UTCverifiziertVersion nicht aufgezeichnet14 Tools

Zettle MCP by usefulapi

Qualität und Sicherheit

Befunde (1)

Kontextkosten

Installation mit einem Klick

Remote-Endpunkte

Tool-Inventar

Tools (14)

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Eingabe-Schema

Diesen Server bewerten

Aktuelle Beobachtungen