ReplenishRadar MCP Server

Agent-ready inventory intelligence for Shopify and Amazon sellers. Stockout risk, demand forecasts, purchase order recommendations, and real-time alerts — all accessible to AI agents via the Model Context Protocol.

What is it?

The ReplenishRadar MCP server lets AI agents (Claude Desktop, custom agents, n8n workflows) query live multi-channel inventory data, request purchase order recommendations, create and manage POs, and trigger inventory syncs — with full human-in-the-loop safeguards.

All write operations create drafts only. No agent can send a PO to a supplier without explicit human approval.

Quick Start (Claude Desktop)

Get an API key from ReplenishRadar > Settings > API Keys
Add to your Claude Desktop config (~/.claude/claude_desktop_config.json):

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

Restart Claude Desktop
Ask: "What are my top stockout risks?" or "Draft POs for everything critical"

Tools (28)

Read Tools (18) — Growth+ tier

Tool	Description
`rr_list_items`	Searchable SKU catalog with stock status
`rr_get_inventory_position`	On-hand, in-transit, reserved quantities by location
`rr_get_stockout_risk`	Risk levels, days of stock, recommended order quantities
`rr_get_demand_forecast`	Demand forecast stats for any period
`rr_get_suggested_purchase_orders`	AI-generated PO recommendations with costs
`rr_get_alerts`	Active inventory and operational alerts
`rr_get_sync_status`	Inventory sync history and status
`rr_list_suppliers`	Vendor/supplier catalog with lead times
`rr_list_purchase_orders`	Browse all POs with filtering
`rr_get_purchase_order`	Detailed PO with line items and history
`rr_get_po_pdf`	PO PDF document info
`rr_get_po_documents`	Documents attached to a PO
`rr_get_sales_history`	Historical sales data by SKU and channel
`rr_get_top_sellers`	Ranked by units/revenue/growth
`rr_get_slow_movers`	Dead stock and carrying cost estimates
`rr_get_inventory_value`	On-hand + in-transit value breakdown
`rr_get_sku_health`	Velocity, margin, stock score, lifecycle
`rr_get_lost_sales`	Revenue lost to stockout events

Write Tools (10) — Growth+ creation, Scale operations

Tool	Description
`rr_trigger_sync`	Manually trigger inventory sync
`rr_acknowledge_alert`	Mark alert as seen + add agent note
`rr_create_purchase_order`	Create draft PO (always draft-only, no auto-send)
`rr_update_purchase_order`	Modify draft PO details
`rr_add_po_note`	Add internal notes to PO
`rr_request_approval`	Request human approval (generates signed approval URL)
`rr_send_purchase_order`	Send approved PO to supplier
`rr_cancel_purchase_order`	Cancel draft or sent PO
`rr_get_document_upload_url`	S3 presigned URL for PI/invoice upload
`rr_record_pi_review`	Log proforma invoice details and variances

Setup Patterns

Claude Desktop (5 minutes)

See Quick Start above.

Custom Agent (Python + Claude API)

import anthropic
from replenishradar import ReplenishRadarMCPClient

rr = ReplenishRadarMCPClient(api_key="rr_sk_live_...")
client = anthropic.Anthropic()
tools = rr.get_tools()

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=4096,
    tools=tools,
    messages=[{"role": "user", "content": "Draft POs for my critical SKUs"}],
    system="You are an inventory operations agent. Create draft POs only."
)

OpenClaw + Slack/Discord

In ReplenishRadar: Settings > API Keys > Create (scope: write)
In OpenClaw: Tools > Add MCP Server > URL: https://api.replenishradar.com/mcp, Auth: Bearer rr_sk_live_...
Configure webhook: Settings > API & Webhooks > Subscribe to events
Agent receives stockout alerts and can act on them in Slack/Discord

n8n / Make (No-Code)

Call the REST API directly at https://api.replenishradar.com/api/mcp/call with your API key in the Authorization header.

For detailed setup guides and system prompt templates, see docs/SETUP.md.

Rate Limits

Tier	Price	API Calls/Hour	Read Tools	Write Tools
Growth	$199/mo	100	All 18	Draft POs only
Scale	$499/mo	1,000	All 18	Full PO lifecycle
Enterprise	Custom	Unlimited	All 18	Full + custom SLAs

Security

Org-scoped API keys — cross-org access impossible at the query layer
Draft-only enforcement — server-side, not client-side
Circuit breaker — suspends keys exceeding 200% of hourly limit
Audit logging — every tool call logged with 7-year retention
Amazon BSA compliant — identification headers, kill switch, no training on Amazon data
OWASP LLM Top 10 — controls for prompt injection, excessive agency, sensitive data exposure

For full security documentation, see docs/SECURITY.md.

Architecture

Your agent (Claude, GPT, Gemini, custom)
         |
         v
@replenishradar/mcp-server (stdio bridge)
         |
         v
POST https://api.replenishradar.com/api/mcp/call
         |
         v
ReplenishRadar backend (rate limiting, audit, org-scoping)
         |
         v
Your inventory data (Shopify + Amazon)

The MCP server is a thin stdio bridge that dispatches all tool calls to the ReplenishRadar REST API. Authentication is via REPLENISHRADAR_API_KEY environment variable.

Environment Variables

Variable	Required	Default	Description
`REPLENISHRADAR_API_KEY`	Yes	—	Your API key (`rr_sk_live_...`)
`REPLENISHRADAR_API_URL`	No	`https://api.replenishradar.com`	API base URL (for self-hosted/testing)

Documentation

License

Proprietary — see LICENSE

replenishradar