Loyal Spark

Connect it to your AI

Claude Code

claude mcp add --transport http loyal-spark https://api.loyalspark.online/loyalty-mcp

Claude, ChatGPT, Cursor and other apps

Add it as a custom connector with this URL (Streamable HTTP):

https://api.loyalspark.online/loyalty-mcp

This server expects extra headers, usually an API key from its maker.

Cursor, VS Code and other apps (mcp.json)

{
  "mcpServers": {
    "loyal-spark": {
      "url": "https://api.loyalspark.online/loyalty-mcp"
    }
  }
}

Tools it offers

42 tools, as the server itself reported during our check on Oct 31, 2026.

• get_platform_infoGet info about Loyal Spark protocol on Base L2
• get_my_profileGet authenticated agent's profile
• generate_program_defaultsWorkflow planner: field catalog, required parameters, next_actions, and non-binding examples. External agents must choose their own name, symbol, and economics.
• get_program_workflow_statusExplain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values)
• list_loyalty_programsList loyalty programs owned by the agent's merchant
• create_loyalty_programGet factory calldata to deploy a new loyalty token on Base. Defaults to B20 (Base-native B20 asset standard, ERC-20 compatible, single tx, active immediately). Pass token_standard='erc20' for the legacy factory. For B20,
• register_loyalty_programRegister a deployed token as a loyalty program in the database. B20 tokens are registered as active; legacy ERC-20 as inactive (activate next).
• activate_loyalty_programFor legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).
• update_program_statusUpdate program status in database after onchain activation/pause
• update_program_configUpdate default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)
• list_rewardsList rewards for a loyalty program by token_address. Includes redemption metrics (total vouchers issued, redeemed, and last-30-day counts) for each reward.
• create_rewardCreate a new reward redeemable with loyalty tokens
• mint_loyalty_tokensRecord mint intent and get a fee-first `calls[]` bundle: protocol fee mint FIRST, then the recipient mint. The protocol fee is charged in the merchant's own loyalty tokens (not USDC). Submit both calls in order (atomical
• transfer_loyalty_tokensGet calldata to transfer loyalty tokens between wallets
• earn_pointsCalculate and mint loyalty tokens based on purchase amount and program's cashback rate, optionally redeeming existing points at checkout (points_to_redeem or redeem_all) to reduce the payable receipt amount before calcul
• confirm_mint_feeConfirm a prepared mint on Base. Verifies the protocol-fee mint and, when recipient_tx_hash is set (or the fee receipt already contains the recipient mint), writes customer_tier_status so get_token_balance leaves 0. Same
• list_mintsList mint intents for this merchant. status=pending means transaction_hash is still null (confirm has not credited the recipient). status=completed means the recipient mint was recorded. GET /balance stays 0 until confir
• list_fee_obligationsList protocol-fee obligations for this API key. status=unpaid is an alias for pending. Each unpaid row includes next_action describing POST /mint/confirm.
• get_token_balanceGet loyalty token balance and tier info for a customer (accepts 0x Base wallet address or customer email in customer_address / customer_email)
• get_program_analyticsGet analytics for one of your loyalty programs
• list_marketplace_offersList active token trading offers on the marketplace
• redeem_rewardRedeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer.
• use_voucherMark a voucher as used at the merchant. Send one of voucher_code or voucher_id (anyOf). If neither is sent the tool returns error_code missing_identifier and an example.
• check_voucher_statusCheck voucher status for this merchant. Send one of code, voucher_code, or voucher_id (anyOf). If none is sent the tool returns error_code missing_identifier, an example, and next_action. Anonymous public lookup is GET /
• create_personalized_offerCreate a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments).
• update_reward_statusActivate or deactivate a reward in the catalog. Use to manage reward availability based on analytics.
• send_reportInternal. Send a report to the merchant's Agent Reports dashboard (SEO audits, growth ideas, anomalies, weekly summaries). Not a loyalty action.
• list_my_reportsInternal. List reports this agent submitted (status new, reviewed, or done).
• update_report_statusInternal. Set a report you submitted to reviewed or done.
• delete_reportInternal. Delete a report you submitted.
• export_customersExport customer data for a specific loyalty program. Returns wallet addresses, voucher stats, balances, and tier info. Use for analytics, segmentation, and personalized offers.
• list_store_discount_codesList discount codes for this merchant's Shopify store, plus how customers spend points (online code, register voucher, or both).
• update_store_discount_codeMark a Shopify discount code used, or cancel it and return the loyalty points. Same actions as the merchant discount-code journal.
• set_store_sales_channelSet how this store's customers spend loyalty points: online (checkout code), offline (voucher at the register), or both (the shopper chooses).
• create_gift_certificateCreate a gift / welcome certificate (UDS-style) with a unique random redemption code (LOYAL-XXXX-XXXX-XXXX). Customer redeems via QR or by entering the code; merchant then mints tokens on-chain. Use for welcome bonuses,
• list_gift_certificatesList gift certificates issued by the agent's merchant (with status and redemption info).
• revoke_gift_certificateRevoke an active gift certificate (status active -> revoked). Only the issuing merchant can revoke. Already-redeemed/minted certificates cannot be revoked.
• mark_gift_certificate_mintedAfter the merchant submits the on-chain mint transaction for a claimed gift certificate, call this to mark it as minted (status pending_mint -> redeemed) and store the mint tx hash.
• bazaar_discover_resourcesDiscover third-party x402-paid resources published in Coinbase CDP's Bazaar (docs, data feeds, AI inference, etc). Read-only. Filter by free-text q and/or network (e.g. 'base').
• bazaar_discover_mcp_serversSearch Coinbase CDP's Bazaar MCP catalog (search_resources) for third-party x402-payable tools. Read-only, free. Rows are run via the Bazaar MCP server's proxy_tool_call, not here.

Questions