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 rangezettle_list_account_transactions 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~3,265トークン数（ツール定義）
~1.4 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 2.55%）

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `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 件