Stamped MCP by usefulapi

Read Stamped Loyalty 2.0 customers, products, orders, rewards and activity.

我该使用它吗

质量与安全性

A
描述质量
100%
模式完整度
93%
命名质量
78%
投毒风险
100%
权限匹配度
100%
协议合规性
100%

发现(1)

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

基于对工具定义和协议合规性的自动分析。

上下文开销

~2,610token 数(工具定义)
~1.7 KB典型响应大小
对注意力有显著影响(占 128k 上下文窗口的 2.04%)

这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高,可用于其他任务的注意力就越少。

安装

一键安装

将以下内容添加到你的 `claude_desktop_config.json` 文件中:

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

远程端点

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

它能做什么

工具清单

工具(11)

🟢 只读🟡 写入🔴 删除⚪ 未知
🟢stamped_list_customers(email, first_name, last_name, last_first, shopify_id, ...)

Filter and list customer records (email, name, tags, addresses, loyalty activity summary such as points and VIP tier). All filters are optional. V3 API: only for shops on the Stamped Loyalty 2.0 dashboard. GET /api/v3/merchant/shops/{shopId}/customers.

输入模式

{
  "type": "object",
  "properties": {
    "email": {
      "description": "Customer email.",
      "type": "string",
      "minLength": 3,
      "maxLength": 320
    },
    "first_name": {
      "description": "First name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "last_name": {
      "description": "Last name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "last_first": {
      "description": "Match the name filters as last-name-first.",
      "type": "boolean"
    },
    "shopify_id": {
      "description": "Shopify customer id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "bigcommerce_id": {
      "description": "BigCommerce customer id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "custom_customer_id": {
      "description": "Custom-platform customer id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "created_from": {
      "description": "Customer created on the store platform from this date (datePlatformCreated). Passed to Stamped as given (a date such as 2026-10-01, or a Unix timestamp as the dashboard uses).",
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "pattern": "^[\\w:+.\\- /]+$"
    },
    "created_to": {
      "description": "Customer created on the store platform up to this date (datePlatformCreatedEnd). Passed to Stamped as given (a date such as 2026-10-01, or a Unix timestamp as the dashboard uses).",
      "type": "string",
      "minLength": 1,
      "maxLength": 40,
      "pattern": "^[\\w:+.\\- /]+$"
    },
    "reviews_min": {
      "description": "Minimum number of reviews written.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "reviews_max": {
      "description": "Maximum number of reviews written.",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "points_min": {
      "description": "Minimum loyalty points balance.",
      "type": "number",
      "minimum": 0
    },
    "points_max": {
      "description": "Maximum loyalty points balance.",
      "type": "number",
      "minimum": 0
    },
    "vip_tier": {
      "description": "VIP tier name.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "tags": {
      "description": "Only records carrying these tags.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "page": {
      "description": "Zero-based page number (default 0). Use the reply's more_pages / next_page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "limit": {
      "description": "Results per page, 1-100.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_get_customer(customer_id)

One customer record by Stamped customer id (customerId from stamped_list_customers). V3 API. GET /api/v3/merchant/shops/{shopId}/customers/{customerId}.

输入模式

{
  "type": "object",
  "properties": {
    "customer_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Stamped customer id."
    }
  },
  "required": [
    "customer_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_lookup_customer(email, custom_customer_id, shopify_id, bigcommerce_id)

Find one customer by email or by a platform id (give exactly one). V3 API. GET /api/v3/merchant/shops/{shopId}/customers/lookup.

输入模式

{
  "type": "object",
  "properties": {
    "email": {
      "description": "Customer email.",
      "type": "string",
      "minLength": 3,
      "maxLength": 320
    },
    "custom_customer_id": {
      "description": "Custom-platform customer id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "shopify_id": {
      "description": "Shopify customer id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "bigcommerce_id": {
      "description": "BigCommerce customer id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_list_products(title, vendor, type, handle, status, ...)

Filter and list the product catalog Stamped holds (title, vendor, type, handle, status, tags). All filters are optional. V3 API. GET /api/v3/merchant/shops/{shopId}/products.

输入模式

{
  "type": "object",
  "properties": {
    "title": {
      "description": "Product title.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "vendor": {
      "description": "Product vendor.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "type": {
      "description": "Product type.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "handle": {
      "description": "Product handle (URL slug).",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "status": {
      "description": "Product status.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "published_scope": {
      "description": "Published scope.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "shopify_id": {
      "description": "Shopify product id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "bigcommerce_id": {
      "description": "BigCommerce product id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "custom_product_id": {
      "description": "Custom-platform product id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "tags": {
      "description": "Only records carrying these tags.",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 100
      }
    },
    "page": {
      "description": "Zero-based page number (default 0). Use the reply's more_pages / next_page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "limit": {
      "description": "Results per page, 1-100.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_get_product(product_id)

One product by Stamped product id (productId from stamped_list_products). V3 API. GET /api/v3/merchant/shops/{shopId}/products/{productId}.

输入模式

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Stamped product id."
    }
  },
  "required": [
    "product_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_lookup_product(custom_product_id, shopify_id, bigcommerce_id)

Find one product by a platform id (give exactly one). V3 API. GET /api/v3/merchant/shops/{shopId}/products/lookup.

输入模式

{
  "type": "object",
  "properties": {
    "custom_product_id": {
      "description": "Custom-platform product id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "shopify_id": {
      "description": "Shopify product id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "bigcommerce_id": {
      "description": "BigCommerce product id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_list_orders(page, limit)

List order records Stamped holds (customer id, currency, line items and cart states, discounts applied, dates). Paged; Stamped documents no filters for this list, use stamped_lookup_order for one order. V3 API. GET /api/v3/merchant/shops/{shopId}/orders.

输入模式

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Zero-based page number (default 0). Use the reply's more_pages / next_page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "limit": {
      "description": "Results per page, 1-100.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_get_order(order_id)

One order by Stamped order id (orderId from stamped_list_orders). V3 API. GET /api/v3/merchant/shops/{shopId}/orders/{orderId}.

输入模式

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 200,
      "description": "Stamped order id."
    }
  },
  "required": [
    "order_id"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_lookup_order(custom_order_id, shopify_id, bigcommerce_id)

Find one order by a platform order id (give exactly one). V3 API. GET /api/v3/merchant/shops/{shopId}/orders/lookup.

输入模式

{
  "type": "object",
  "properties": {
    "custom_order_id": {
      "description": "Custom-platform order id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "shopify_id": {
      "description": "Shopify order id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    },
    "bigcommerce_id": {
      "description": "BigCommerce order id.",
      "type": "string",
      "minLength": 1,
      "maxLength": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_list_loyalty_rewards(page, limit)

Loyalty program report: the rewards customers earned or redeemed (title, type, value, status, expiry, customer id, and the coupon code MASKED: only the last 4 characters are shown, codes shorter than 10 characters are fully hidden, and coupon_code_masked is true in the reply). Read-only audit view; nothing is redeemed or voided. V3 API (Loyalty 2.0). GET /api/v3/loyalty/shops/{shopId}/rewards.

输入模式

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Zero-based page number (default 0). Use the reply's more_pages / next_page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "limit": {
      "description": "Results per page, 1-100.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢stamped_list_loyalty_activities(page, limit)

Loyalty program report: the points ledger of activities (rule, points credited/debited, event, order id and order breakdown, customer id). Read-only audit view; no points are changed. V3 API (Loyalty 2.0). GET /api/v3/loyalty/shops/{shopId}/activities.

输入模式

{
  "type": "object",
  "properties": {
    "page": {
      "description": "Zero-based page number (default 0). Use the reply's more_pages / next_page.",
      "type": "integer",
      "minimum": 0,
      "maximum": 100000
    },
    "limit": {
      "description": "Results per page, 1-100.",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

社区

评价此服务器

证据

最近观测

已验证未记录版本11 个工具