Shopwaive integration
Shopwaive is a store-credit, cash-back and loyalty app for Shopify stores. Look up a customer's credit balance with its activity, orders and offers, set or increment balances (one customer or up to 1,000 in a bulk job), search and edit the credit actions behind a balance, list orders that redeemed credit, and create a checkout link with credit applied. Only Shopify stores are supported. Authentication is a Shopwaive API key (swak_...) created in the Shopwaive app under Settings > Develop, sent raw in the X-Shopwaive-Access-Token header.
Say what should happen.
The workflow builds itself.
What you can do with Shopwaive
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Action, 4 operations
delete_actionDelete actionDELETEDelete a credit action. Deleting a deposit debits its amount from the balance (never below 0); remaining=true debits only the unredeemed part. An order id deletes every action of that order.get_actionGet actionGETGet one credit action by id (as returned by set_customer_balance, adjust_customer_balance or the activity of get_customer); an order id returns the actions that order created.list_actionsList actionsGETSearch credit actions by customer email and creation window; at most 250 records per call. Each record holds the customer email and the action.update_actionUpdate actionPOSTUpdate a credit deposit's note, media or expiration (amount cannot change: delete_action then re-credit). Send note or media alone, or expires and expirationdate together. Leave out a field to keep it.
Customer, 3 operations
adjust_customer_balanceAdjust customer balancePUTAdd credit to (positive amount) or debit (negative amount) a customer's balance; creates the customer if needed. Returns the action id, previous balance, change and new balance.get_customerGet customerGETGet a customer's Shopwaive credit: balance, currency and expiration. Set activity, orders or offers to true to also get the credit actions (ids for get_action), orders and eligible offers.set_customer_balanceSet customer balancePOSTSet a customer's credit balance to an exact value (replaces the current balance). To add or subtract instead, use adjust_customer_balance. Returns the action id with previous and new balance.
Order, 2 operations
create_checkout_orderCreate checkout orderPOSTCreate a Shopify checkout link for a customer with Shopwaive credit applied, line items and optional per-item discounts. Returns checkout_url to send to the customer for payment.list_ordersList ordersGETSearch orders that redeemed Shopwaive credit, by order id, customer email or creation window; at most 250 records per call. Each record has the order id, name, email and amount redeemed.
Bulk, 1 operation
bulk_adjust_customer_balancesBulk adjust customer balancesPUTIncrement or debit many balances in one job (up to 1,000 transactions), now or at a scheduled date. Bulk must first be enabled for the store by Shopwaive support. Returns the bulk job id and the scheduled count.
Use Shopwaive from Claude Code, Cursor or Codex
Connect Shopwaive in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Shopwaive operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Shopwaive
- Create your workspace
Sign up free. Nothing to install.
- Connect Shopwaive once
Add your Shopwaive connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Shopwaive integration FAQ
What can you do with the Shopwaive integration?
LiveContext exposes 10 operations on Shopwaive, covering action, customer, order and bulk.
