ReplenishRadar

@replenishradar/mcp-server

将 AI Agent 连接到实时的 ReplenishRadar 库存数据。可与 Claude Desktop、OpenClaw 及任何兼容 MCP 的客户端配合使用。

设置

1. 在 ReplenishRadar > Settings > API Keys 中获取 API 密钥。
2. 将此服务添加到 MCP 客户端配置中。在 Claude Desktop 中，打开 Settings > Developer > Edit Config：

{
  "mcpServers": {
    "replenishradar": {
      "command": "npx",
      "args": ["-y", "@replenishradar/mcp-server"],
      "env": {
        "REPLENISHRADAR_API_KEY": "rr_sk_your_key_here"
      }
    }
  }
}

3. 重启 Claude Desktop 并询问：“我的主要缺货风险有哪些？”

还没有 ReplenishRadar 账户？配置服务前，可使用公开的 Agent 接入端点申请一个短期、只读的沙盒密钥：

POST https://api.replenishradar.com/api/public/agent-intake

可用工具

读取

Standard 套餐包含有限的读取 API 访问权限。Growth 套餐还提供诊断和状态读取工具。

工具	描述
rr_get_stockout_risk	SKU 缺货风险等级
rr_get_inventory_position	商品按地点划分的库存量
rr_get_demand_forecast	需求预测统计数据
rr_get_suggested_purchase_orders	建议的采购订单
rr_get_replenishment_actions	标准买方补货操作
rr_get_replenishment_action	单项补货操作及其事件历史
rr_get_alerts	活跃警报
rr_list_items	列出库存商品
rr_get_sync_status	最近的同步历史
rr_list_suppliers	列出供应商
rr_list_purchase_orders	列出采购订单
rr_get_purchase_order	单个采购订单及其行项目
rr_get_po_pdf	采购订单 PDF 信息
rr_get_po_documents	附加到采购订单的文档
rr_get_po_notes	采购订单的备注
rr_get_sales_history	销售历史
rr_get_top_sellers	畅销 SKU
rr_get_slow_movers	滞销 SKU
rr_get_inventory_value	库存价值明细
rr_get_sku_health	SKU 级健康状况摘要
rr_get_lost_sales	由缺货造成的预估销售损失
rr_get_store_health	门店连接和同步健康状况
rr_get_data_freshness	按数据维度划分的数据新鲜度状态
rr_get_setup_status	设置里程碑和下一步
rr_get_recent_activity	最近的警报、采购订单和同步汇总
search_knowledge	搜索 ReplenishRadar 产品知识
rr_evaluate_fit	确定性的 ICP + 套餐适配判定（不使用组织数据）

基础写入（Standard 套餐及以上）

安全、影响范围小的写入——不会变更资金或库存。

工具	描述
rr_acknowledge_alert	确认警报
rr_add_po_note	为采购订单添加备注
rr_request_approval	为采购订单请求人工审批
rr_add_replenishment_action_note	为补货操作添加备注
rr_dismiss_replenishment_action	忽略补货操作
rr_prepare_replenishment_action	预览操作，并在执行前获取其当前的 updated_at
rr_execute_replenishment_action	执行操作。mode="draft"（默认）会创建草稿采购订单和/或调拨；mode="autonomous" 在密钥具备 sensitive_write、对应操作工具组和启用的预算，且所有防护措施均通过时，也会发送采购订单/提交调拨（否则回退为草稿或直接拒绝）。具备幂等性，并可防止基于过期状态执行
rr_resolve_replenishment_action	将操作标记为无需操作，并说明原因；具备幂等性，并可防止基于过期状态执行
rr_retry_replenishment_action	通过草稿执行路径重试被阻止或失败的操作；具备幂等性，并可防止基于过期状态执行
rr_get_document_upload_url	获取采购订单文档的上传 URL
rr_record_pi_review	记录形式发票详情

敏感写入（Growth tier 及以上）

钱款／库存变更。

工具	描述
rr_trigger_sync	触发库存同步
rr_create_purchase_order	创建采购订单草稿
rr_update_purchase_order	更新采购订单草稿
rr_send_purchase_order	发送已批准的采购订单
rr_cancel_purchase_order	取消采购订单
rr_create_location	创建手动库存位置
rr_set_stock_at_location	设置手动位置的库存

创建采购订单时始终会先生成草稿。rr_send_purchase_order 只会发送已由人工批准的采购订单。

操作执行有两种模式。使用 mode="draft"（默认值）调用 rr_execute_replenishment_action，会为某项操作中的商品创建采购订单草稿和／或调拨草稿，绝不会自动向供应商发送订单或提交库存。使用 mode="autonomous" 时，还会发送采购订单或提交调拨，但前提是密钥拥有 sensitive_write、对应操作的工具组，以及已启用的每密钥预算（autonomous_enabled=true），并且所有护栏检查均通过；否则会保留草稿并返回 rr_request_approval 提示（draft_fallback），或者拒绝执行且不进行任何变更（hard_refuse）。请先调用 rr_prepare_replenishment_action 获取该操作当前的 updated_at，再将其作为 expected_updated_at 传入，以便在任何写入发生之前拒绝过期操作。请传入稳定的 idempotency_key，这样重试调用会返回原始结果，而不会重复创建对象或重复发送。

Agent 上下文存储

一个小型、按组织划分且可审计的键值记忆，用于让 Agent 记住有界的工作流状态。rr_get_agent_context／rr_list_agent_context 具有读取能力；rr_set_agent_context／rr_delete_agent_context 具有基本写入能力。四者均属于 agent_context 工具组。

工具	描述
rr_get_agent_context	通过 namespace + key 获取一个条目；已过期的条目会被省略
rr_set_agent_context	在 namespace + key 下存储有界 JSON 对象（可选 scope_ref、ttl_seconds）
rr_list_agent_context	列出一个 namespace（必填）中的有效条目，limit 有界（最大值为 200）
rr_delete_agent_context	通过 namespace + key 删除一个条目；记录操作者来源

规则和限制：

• 命名空间由代码管理，并按密钥列入允许列表。 人工管理员必须在 Settings > API Keys 中授予你的 API 密钥对每个命名空间的读取／写入／删除权限。仅属于同一组织并不足够。
• 不得包含机密或原始 PII。 看起来像令牌、密码、私钥、凭据或原始电子邮件／电话号码／地址的写入内容会被拒绝。
• value 必须是一个JSON 对象（不能是标量或数组），序列化后上限为 16 KiB。
• ttl_seconds 为可选项，上限为 90 天；未设置 TTL 时，只要组织存在，该条目就会一直保留。
• rr_list_agent_context 必须指定 namespace，且绝不会跨命名空间列出条目。
• scope_ref 仅为描述性元数据，不参与唯一性判定——请将每个作用域的条目编码到 key 中（例如 supplier_rules/sku:ABC123）。
• 敏感命名空间（例如 sourcing_economics）还要求密钥具有敏感经济数据读取能力和相应工具组。

支出预算（由管理员管理，不提供 MCP 工具）

每个 API 密钥的支出预算包括单张采购订单金额上限、滚动 24 小时支出上限、最大调拨数量变化、autonomous_enabled 标志，以及供应商／目的地／调拨来源（或路线对）允许列表，用于限制自主密钥可以采购或调拨的内容。这些预算只能由人工管理员在 Settings > API Keys 中管理（通过 JWT 管理员 Settings API）；没有 MCP 工具可以读取或更改预算，API 密钥也无法访问预算路由，即使是读取自己的上限也不行。只有自主发送／提交操作才会消耗预算；自主模式默认关闭。自主操作被拒绝时，只会返回简短的判定原因——绝不会透露上限金额、允许列表或其他密钥的账本。

Rate Limits

• Standard ($99/mo): 10 calls/hour, read + basic-write tools
• Growth ($199/mo): 100 calls/hour, read + basic + sensitive read/write + diagnosis/status tools
• Scale ($499/mo): 1,000 calls/hour, full read + write capability set

Learn More

• MCP Setup Guide
• ReplenishRadar