Skip to content

Integrations

Merchant API and MCP for PPWR order data

Push shipped orders, maintain SKU packaging rules, and read report status from your OMS, integration platform, or coding agent.

Get started

Create a key in the PPWR cabinet

  1. Open Connections in your producer workspace and create an API key with the scopes you need.
  2. Call https://ppwr.smbf.me/api/v1/whoami or connect an MCP client to https://ppwr.smbf.me/api/mcp with Authorization: Bearer ….
  3. Upsert orders by external_ref (idempotent). Attach packaging per line item or define SKU rules once.

Full references live in the cabinet repo: REST API and MCP.

Clients

MCP configuration examples

{
  "mcpServers": {
    "smbf-ppwr": {
      "url": "https://ppwr.smbf.me/api/mcp",
      "headers": { "Authorization": "Bearer YOUR_KEY" }
    }
  }
}

Works with Cursor, Claude Desktop/Code, OpenAI Codex, and any Streamable HTTP MCP client. Webhooks use HMAC-SHA256 over timestamp + "." + rawBody, include X-SMBF-Delivery, reject timestamps outside ±300s, and dedupe on delivery id.