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 个工具