@replenishradar/mcp-server

Connect AI agents to live ReplenishRadar inventory data. Works with Claude Desktop, OpenClaw, and any MCP-compatible client.

Setup

1. Get your API key from ReplenishRadar > Settings > API Keys.
2. Add this server to your MCP client config. In Claude Desktop, open Settings > Developer > Edit Config:

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

3. Restart Claude Desktop and ask: "What are my top stockout risks?"

No ReplenishRadar account yet? Use the public agent intake endpoint to request a short-lived, read-only sandbox key before configuring the server:

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

Available Tools

Read

Standard includes limited read API access. Growth adds diagnosis/status read tools.

Tool	Description
rr_get_stockout_risk	Stockout risk levels for SKUs
rr_get_inventory_position	Stock-by-location for an item
rr_get_demand_forecast	Demand forecast stats
rr_get_suggested_purchase_orders	Suggested POs
rr_get_replenishment_actions	Canonical buyer replenishment actions
rr_get_replenishment_action	One replenishment action with event history
rr_get_alerts	Active alerts
rr_list_items	List inventory items
rr_get_sync_status	Recent sync history
rr_list_suppliers	List vendors/suppliers
rr_list_purchase_orders	List purchase orders
rr_get_purchase_order	Single PO with line items
rr_get_po_pdf	PO PDF info
rr_get_po_documents	Documents attached to a PO
rr_get_po_notes	Notes attached to a PO
rr_get_sales_history	Sales history
rr_get_top_sellers	Top-selling SKUs
rr_get_slow_movers	Slow-moving SKUs
rr_get_inventory_value	Inventory value breakdown
rr_get_sku_health	SKU-level health summary
rr_get_lost_sales	Estimated lost sales from stockouts
rr_get_store_health	Store connection and sync health
rr_get_data_freshness	Freshness status by data dimension
rr_get_setup_status	Setup milestones and next step
rr_get_recent_activity	Recent alerts, POs, and sync rollup
search_knowledge	ReplenishRadar product knowledge search
rr_evaluate_fit	Deterministic ICP + tier fit verdict (no org data)

Basic write (Standard tier and up)

Safe, low-blast-radius writes - no money or stock mutation.

Tool	Description
rr_acknowledge_alert	Acknowledge an alert
rr_add_po_note	Add a note to a PO
rr_request_approval	Request human approval for a PO
rr_add_replenishment_action_note	Add a note to a replenishment action
rr_dismiss_replenishment_action	Dismiss a replenishment action
rr_prepare_replenishment_action	Preview an action and get its current updated_at before execute
rr_execute_replenishment_action	Execute an action. mode="draft" (default) creates a draft PO and/or transfer; mode="autonomous" also sends the PO / commits the transfer when the key has sensitive_write + the operation tool group + an enabled budget and all guardrails pass (else draft-fallback or hard-refuse). Idempotent, stale-state protected
rr_resolve_replenishment_action	Resolve an action as no-action with a reason; idempotent, stale-state protected
rr_retry_replenishment_action	Retry a blocked or failed action via the draft execution path; idempotent, stale-state protected
rr_get_document_upload_url	Get upload URL for a PO document
rr_record_pi_review	Record proforma invoice details

Sensitive write (Growth tier and up)

... View full README on GitHub