MCP MeasureMCP Measure

索引已觀測

Zettle MCP by usefulapi

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

我該用這個嗎

品質與安全性

A
說明品質
97%
結構描述完整度
81%
命名品質
79%
汙染風險
100%
權限相符程度
100%
協定合規性
100%

發現項目（1）

  • LOWTool 'zettle_list_account_transactions' name length outside 3-30 range在 zettle_list_account_transactions 中

根據工具定義與協定合規性的自動化分析。

上下文成本

~3,265Token（工具定義）
~1.4 KB典型回應大小
顯著的注意力影響（128k 上下文的 2.55%）

這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。

安裝

一鍵安裝

將以下內容加入你的 `claude_desktop_config.json` 檔案：

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

遠端端點

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

它能做什麼

工具清單

工具（14）

🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢zettle_get_account

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

輸入結構描述

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zettle_list_purchases(start_date, end_date, limit, descending, last_purchase_hash)

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.

輸入結構描述

{
  "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"
}
🟢zettle_get_purchase(purchase_uuid)

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}.

輸入結構描述

{
  "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"
}
🟢zettle_list_products(name_contains, limit, offset)

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.

輸入結構描述

{
  "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"
}
🟢zettle_get_product(product_uuid)

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

輸入結構描述

{
  "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"
}
🟢zettle_list_categories

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

輸入結構描述

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zettle_get_library(limit, offset)

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.

輸入結構描述

{
  "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"
}
🟡zettle_create_product(name, description, vat_percentage, variants)

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.

輸入結構描述

{
  "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"
}
🟢zettle_list_inventories

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.

輸入結構描述

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢zettle_get_stock(inventory_uuid, cursor, limit)

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}.

輸入結構描述

{
  "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"
}
🟢zettle_get_stock_for_products(inventory_uuid, product_uuids, cursor, limit)

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.

輸入結構描述

{
  "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"
}
🟢zettle_get_account_balance(account, at)

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.

輸入結構描述

{
  "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"
}
🟢zettle_list_account_transactions(account, start, end, types, limit, ...)

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.

輸入結構描述

{
  "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"
}
🟢zettle_get_payout_info(at)

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

輸入結構描述

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

社群

為此伺服器評分

證據

近期觀測

已驗證未記錄版本14 個工具