Integration

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.

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Shopwaive.Built from the 10 Shopwaive tools below, on the connection you add once.

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 Code
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"
Codex (~/.codex/config.toml)
[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"
Cursor, Claude Desktop and other JSON configs
{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Shopwaive

  1. Create your workspace

    Sign up free. Nothing to install.

  2. 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.

  3. 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.

Popular integrations

Browse the whole catalog