Loyal Spark

Reliability

Status and outage history · Atom feed · Watch with other listings

How to connect

Add it to any MCP client that supports remote servers.

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

42 tools

• get_platform_info

  Get info about Loyal Spark protocol on Base L2

• get_my_profile

  Get authenticated agent's profile

• generate_program_defaults

  Workflow planner: field catalog, required parameters, next_actions, and non-binding examples. External agents must choose their own name, symbol, and economics.

• get_program_workflow_status

  Explain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values)

• list_loyalty_programs

  List loyalty programs owned by the agent's merchant

• create_loyalty_program

  Get factory calldata to deploy a new loyalty token on Base. Defaults to B20 (Base native ERC-20 superset, single tx, active immediately). Pass token_standard='erc20' for the legacy factory. For B20, MINT_ROLE is granted atomically to the merchant admin AND to the agent's CDP…

• register_loyalty_program

  Register 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_program

  For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).

• update_program_status

  Update program status in database after onchain activation/pause

• update_program_config

  Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)

• list_rewards

  List rewards for a loyalty program by token_address. Includes redemption metrics (total vouchers issued, redeemed, and last-30-day counts) for each reward.

• create_reward

  Create a new reward redeemable with loyalty tokens

• mint_loyalty_tokens

  Record 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 (atomically via EIP-5792 send_calls if your wallet supports it)…

• transfer_loyalty_tokens

  Get calldata to transfer loyalty tokens between wallets

• earn_points

  Calculate and mint loyalty tokens based on purchase amount and program's cashback rate. Returns a fee-first `calls[]` bundle (protocol fee mint first, then the customer mint) — submit in order, atomically via EIP-5792 if supported, then call confirm_mint_fee (or POST…

• confirm_mint_fee

  Confirm that the protocol fee transaction for a previous mint/earn was broadcast on Base. Verifies the fee mint on-chain and clears the obligation. Unconfirmed fee obligations block future mints.

• get_token_balance

  Get loyalty token balance and tier info for a customer

• get_program_analytics

  Get analytics for your loyalty programs

• list_marketplace_offers

  List active token trading offers on the marketplace

• redeem_reward

  Redeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer.

• use_voucher

  Mark a voucher as used (redeemed by customer at merchant). Merchant-only operation.

• check_voucher_status

  Check voucher status by code or ID. Requires a merchant agent key; only vouchers issued by the key owner's store are returned.

• get_platform_stats

  Get global platform statistics across all merchants. Admin-only: requires agent owned by an admin wallet.

• cancel_stale_offers

  Cancel marketplace offers that have been active for more than N days with no completions. Admin-only action tool.

• create_personalized_offer

  Create a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments).

• update_reward_status

  Activate or deactivate a reward in the catalog. Use to manage reward availability based on analytics.

• send_report

  Send a report to the developer/owner. Use this to submit SEO audits, growth ideas, data reports, anomalies, recommendations, or weekly summaries. The report will appear in the merchant's Agent Reports dashboard.

• list_my_reports

  List your previously submitted reports. Allows reviewing past reports, checking status (new/reviewed/done), and identifying what still needs attention.

• update_report_status

  Update report status to 'reviewed' or 'done'. Use 'done' when the action items have been completed. Use 'reviewed' to acknowledge a report.

• delete_report

  Delete a report that is no longer relevant. Use to clean up outdated or irrelevant reports.

• export_customers

  Export 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_codes

  List discount codes for this merchant's Shopify store, plus how customers spend points (online code, register voucher, or both).

• update_store_discount_code

  Mark a Shopify discount code used, or cancel it and return the loyalty points. Same actions as the merchant discount-code journal.

• set_store_sales_channel

  Set how this store's customers spend loyalty points: online (checkout code), offline (voucher at the register), or both (the shopper chooses).

• create_gift_certificate

  Create 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, promo campaigns, partnership gifts.

• list_gift_certificates

  List gift certificates issued by the agent's merchant (with status and redemption info).

• revoke_gift_certificate

  Revoke an active gift certificate (status active → revoked). Only the issuing merchant can revoke. Already-redeemed/minted certificates cannot be revoked.

• mark_gift_certificate_minted

  After 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_resources

  Discover 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_servers

  Discover third-party MCP servers published in Coinbase CDP's Bazaar. Read-only. Filter by free-text q and/or network.

Security scan

Recent checks