Integration

LoyaltyLion integration

LoyaltyLion is a loyalty and rewards platform for e-commerce stores. With its Admin API an agent can look up loyalty customers with their points, tier and available rewards, add or remove points, redeem and refund rewards, record customer activities and orders so loyalty rules award points, approve or void activities, read point transactions, sync product reviews, enable or disable rewards, manage loyalty email unsubscribes and subscribe to webhooks. Customer exports are not exposed (their result is a signed download link), nor the WebView session and Gatsby integration routes; customer referral, receipt upload and loyalty pass links, gift card and voucher codes and webhook target URLs are not returned. Authentication is a program API key (LoyaltyLion admin, Manage, API keys) sent as a Bearer token; each route needs the key scope named in its description. The rate limit is 20 requests per second.

Connect LoyaltyLion How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with LoyaltyLion

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.

Activity, 4 operations

create_activityCreate activityPOSTRecords a customer activity so the matching loyalty rule can award points (for real, visible to the customer). name is a custom rule identifier, or a built-in rule prefixed with $ such as $signup. Key scope: write_customers.
list_activitiesList activitiesGETLists loyalty activities (rule completions such as sign-ups, reviews, referrals, purchases and manual adjustments), newest first, with the customer, rule and state of each. Page with cursor.next. Key scope: read_customers.
update_activityUpdate activityPUTChanges the state of an activity by its LoyaltyLion id (from list_activities): approved awards its pending points, declined or void cancels them. Acts on the customer's real balance. Key scope: write_customers.
update_activity_by_merchant_idUpdate activity by merchant idPUTChanges the state of an activity identified by its rule name and the merchant_id you gave it in create_activity: approved, declined or void. Acts on the customer's real balance. Key scope: write_customers.

Order, 4 operations

create_orderCreate orderPOSTTracks an order from a custom store so loyalty purchase rules award the customer points (for real). Send amounts as decimal strings such as 99.99. Update it later with update_order. Key scope: write_orders.
get_orderGet orderGETGets one order by its ID in your store: totals, payment, refund and cancellation status, and the payments and refunds recorded. Key scope: read_orders.
list_ordersList ordersGETLists orders tracked by LoyaltyLion, newest first, with totals, payment, refund and cancellation status and the customer. Filter by created/updated dates; page with cursor.next. Key scope: read_orders.
update_orderUpdate orderPUTUpdates an order's payment, refund and cancellation status and paid and refunded totals. A full update: all five fields are required, so read get_order first and resend current values. Idempotent. Key scope: write_orders.

Reward, 4 operations

disable_rewardDisable rewardPOSTDisables a reward in the program configuration, for real: customers can no longer redeem it. Key scope: write_configuration.
enable_rewardEnable rewardPOSTEnables a reward in the program configuration, for real: customers can redeem it again. Key scope: write_configuration.
list_customer_available_rewardsList customer available rewardsGETLists the rewards a customer can redeem right now, with point cost, discount and targeting; pass a reward id to redeem_customer_reward. Key scope: read_customers.
redeem_customer_rewardRedeem customer rewardPOSTRedeems a reward for a customer, for real: the point cost is deducted from their balance and the reward is issued. The voucher or gift card code itself is not returned. Undo with refund_claimed_reward. Key scope: write_customers.

Webhook, 4 operations

create_webhookCreate webhookPOSTSubscribes an HTTPS URL to a LoyaltyLion event topic, for real: LoyaltyLion then POSTs each event to it. Deliveries carry an x-loyaltylion-hmac-sha256 header signed with your site secret. The key needs the scope of the topic's resource.
delete_webhookDelete webhookDELETEDeletes a webhook subscription, for real: its URL stops receiving events.
get_webhookGet webhookGETGets one webhook subscription: topic and dates (the target URL is not returned).
list_webhooksList webhooksGETLists the webhook subscriptions this credential created, with topic and dates (target URLs are not returned). Any key may call it.

Review, 3 operations

create_reviewCreate reviewPOSTRecords a product review left by a customer so review rules can award points (for real) once the review is approved. Key scope: write_reviews.
delete_reviewDelete reviewDELETEDeletes a review recorded with create_review, for real. Key scope: write_reviews.
update_reviewUpdate reviewPUTUpdates a review recorded with create_review; every field is required, so send the current values with the change. Approving a review can award its points. Key scope: write_reviews.

Customer, 2 operations

list_customersList customersGETLists loyalty program customers with their points (approved, pending, spent), tier, enrolment, referral and insights segment, newest first. Filter by email substring or created/updated dates; page with cursor.next. Key scope: read_customers.
update_customerUpdate customerPATCHUpdates a customer's birthday, or blocks or unblocks the customer in the loyalty program. Both fields are optional; send the one to change. Key scope: write_customers.

Email unsubscribe, 2 operations

create_email_unsubscribeCreate email unsubscribePOSTUnsubscribes an email address from LoyaltyLion loyalty emails, for real: that customer stops receiving them. Key scope: write_unsubscribes.
list_email_unsubscribesList email unsubscribesGETLists email addresses unsubscribed from LoyaltyLion loyalty emails. Page with page (1, 2, ...). Key scope: read_unsubscribes.

Point, 2 operations

add_customer_pointsAdd customer pointsPOSTAdds points to a customer's approved balance, for real; the reason is shown to the shopper. Key scope: write_customers.
remove_customer_pointsRemove customer pointsPOSTRemoves points from a customer's balance, for real; the reason is shown to the shopper. Key scope: write_customers.

Transaction, 2 operations

list_customer_transactionsList customer transactionsGETLists one customer's point transactions, newest first: each is an activity, a manual adjustment, a points expiry or a claimed reward (field resource says which). Page with cursor.next. Key scopes: read_customers and read_orders.
list_transactionsList transactionsGETLists point transactions across the program, newest first: activities, manual adjustments, points expiries and claimed rewards (field resource says which). Filter by LoyaltyLion customer_id or dates. Key scopes: read_customers and read_orders.

Claimed reward, 1 operation

refund_claimed_rewardRefund claimed rewardPOSTRefunds a claimed reward: the reward is voided and its points go back to the customer's balance. Acts for real. Key scope: write_customers.

Identity, 1 operation

get_api_identityGet api identityGETReturns what the connected credential is: its kind (api_key, oauth_client or site_token_secret), account and program ids and granted scopes. Use it to check a connection or a missing scope. Any key may call it.

Site, 1 operation

list_sitesList sitesGETLists the sites (stores) of the program with platform, currencies and languages; site ids feed the site_id parameter of create_order, create_activity and create_review. Needs a program API key.

Use LoyaltyLion from Claude Code, Cursor or Codex

Connect LoyaltyLion in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its LoyaltyLion 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 LoyaltyLion

Create your workspace
Sign up free. Nothing to install.
Connect LoyaltyLion once
Add your LoyaltyLion 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.