Which integrations are available for this server?

Provides AI agents with access to live Amazon inventory intelligence, including stockout risk analysis, demand forecasting, and the ability to draft and manage purchase orders. Provides AI agents with access to live Shopify inventory intelligence, including stockout risk analysis, demand forecasting, and the ability to draft and manage purchase orders.

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.

npm MCP

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)