Loyal Spark
activeOnchain Loyalty Protocol on Base
Loyal Spark is an onchain loyalty-as-a-service protocol on Base L2. AI agents and merchants can create B20 loyalty programs (legacy ERC-20 optional), mint tokens to customer wallets, manage reward catalogs, trade tokens on a P2P escrow marketplace, redeem rewards for vouchers, and run analytics — all via paid x402 endpoints (USDC on Base) or via standard REST with x-api-key. Coverage: 89 paid…
Settled via Coinbase.
- Transactions · 30d
- 5,929
- Volume · 30d
- $32.01
- Unique buyers · 30d
- 100
- Uptime · 30d
- 98.7%
- Latency p50
- 221ms
- Reported calls · 30d
- 3,084
Endpoints (123 live)
POST/x402-gateway/mcp-tools/earn_points— Calculate and mint loyalty tokens from a purchase amount using the program cashback rate (earn / cashback flow). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Send x-api-key: lsk_... (or Authorization: Bearer lsk_...) with the payment; without a live key you are not charged. Docs: loyalspark.online/for-agents (0.01 USDC on Base)POST/x402-gateway/recipient-mcp-tools/get_my_loyalty_balance— Balance and tier for one loyalty program token held by the authenticated recipient wallet. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.001 USDC on Base)POST/x402-gateway/recipient-mcp-tools/list_p2p_offers— List open peer-to-peer token swap offers; optional filter by loyalty token (same price band as merchant GET /offers). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Payment alone gives access; do not send an API key. Docs: loyalspark.online/for-agents (0.001 USDC on Base)POST/x402-gateway/recipient-mcp-tools/list_my_vouchers— Loyalty rewards: List vouchers issued to your wallet (active, used, expired) across enrolled loyalty programs. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.001 USDC on Base)POST/x402-gateway/recipient-mcp-tools/redeem_my_reward— Redeem a reward into an active voucher after paying the token cost on-chain (requires transfer tx hash). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.01 USDC on Base)POST/x402-gateway/mcp-tools/mint_loyalty_tokens— Loyalty rewards: Fee-first mint calls[] (protocol fee first, then recipient) + fee_obligation_id. Accepts 0x Base wallet or customer email in recipient_address (or recipient_email). Confirm with confirm_mint_fee. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Send x-api-key: lsk_... (or Authorization: Bearer lsk_.... (0.01 USDC on Base)POST/x402-gateway/recipient-mcp-tools/list_my_gift_certificates— Loyalty rewards: List gift certificates claimed by your wallet with optional status filter. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.01 USDC on Base)POST/x402-gateway/recipient-mcp-tools/list_rewards_for_program— List active rewards you can redeem for a program where your wallet has loyalty activity or balance. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.001 USDC on Base)POST/x402-gateway/recipient-mcp-tools/list_my_loyalty_balances— All loyalty token balances and tier levels for the holder wallet linked to this rwk_ key. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.001 USDC on Base)POST/x402-gateway/recipient-mcp-tools/prepare_loyalty_token_transfer— Build B20/ERC-20 transfer calldata for the holder wallet to send loyalty tokens to any address (submit tx locally). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Docs: loyalspark.online/for-agents (0.005 USDC on Base)POST/x402-gateway/mcp-tools/use_voucher— Loyalty rewards: Mark an active voucher as used at checkout (merchant scans code or voucher id). Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Send x-api-key: lsk_... (or Authorization: Bearer lsk_...) with the payment; without a live key you are not charged. Docs: loyalspark.online/for-agents (0.005 USDC on Base)POST/x402-gateway/recipient-mcp-tools/get_recipient_profile— Loyalty rewards: Recipient agent profile bound to rwk_ API key: wallet address, key scopes, and registration metadata. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Send x-api-key: rwk_... (or Authorization: Bearer rwk_...) with the payment; without a live key you are not charged. Docs: loyalspark.online/for-agents (0.001 USDC on Base)GET/x402-gateway/balance— Read B20/ERC-20 loyalty token balance for a wallet address on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.001 USDC on Base)GET/x402-gateway/public-programs— Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). GET, $0.001 USDC on Base (same as GET /programs). Pay-only; no API key. Returns active public programs, not the caller's own; for the paying wallet's programs use GET /programs (pay-only; lsk_ key optional). (0.001 USDC on Base)GET/x402-gateway/offers— List active P2P marketplace offers for loyalty token swaps on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Payment alone gives access; do not send an API key. Docs: loyalspark.online/for-agents (0.001 USDC on Base)POST/x402-gateway/recipient-api/prepare-transfer— Prepare an unsigned B20/ERC-20 loyalty token transfer transaction on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.005 USDC on Base)GET/x402-gateway/recipient-api/balances— List all loyalty token balances held by a customer/recipient wallet on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.001 USDC on Base)GET/x402-gateway/recipient-api/vouchers— List a customer's redeemed reward vouchers and voucher codes. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.001 USDC on Base)GET/x402-gateway/recipient-api/offers— Browse open P2P marketplace offers to buy or swap loyalty tokens on Base. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Payment alone gives access; do not send an API key. Docs: loyalspark.online/for-agents (0.001 USDC on Base)GET/x402-gateway/recipient-api/workflow/reward-status— Check whether a customer has enough tokens and eligibility to redeem a reward. Loyal Spark: loyalty points, rewards & vouchers API on Base (REST + MCP, USDC via x402). Pay-only works: the paying wallet is the caller; API key optional. Scoped to the key's wallet. Docs: loyalspark.online/for-agents (0.001 USDC on Base)
+103 more endpoints.
MCP tools (43)
Loyal Spark https://api.loyalspark.online/mcp
activate_loyalty_program— For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).bazaar_discover_mcp_servers— Search 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.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_pay_and_call— Pay a Loyal Spark x402 URL on api.loyalspark.online with the merchant agent's CDP MPC wallet (EIP-3009 exact scheme, Base USDC). Other hosts are refused before any signature. Requires scope 'mint' and an active CDP wallet. max_usdc default 0.25, hard limit 10.bazaar_probe_x402— Probe one x402 resource URL without paying: a single GET (https only, 5 s, 64 KB, no redirects). If it answers HTTP 402, returns a parsed summary of the x402 payment requirements (PAYMENT-REQUIRED header or accepts[]). Any other status returns error not_x402_resource with the status only: the response body is never returned. No signing. No API key needed: keyless calls are limited to 20/minute per IP; with a key the key's own limits apply.check_voucher_status— Check 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 /agent-api/vouchers/status.confirm_mint_fee— Confirm 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 hash for both fields when EIP-5792 batched the calls. A second call with recipient_tx_hash still credits the customer after the fee is already settled.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.create_loyalty_program— Get 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, MINT_ROLE is granted atomically to the merchant admin AND to the agent's CDP wallet (or explicit extra_minters) so autonomous agents can mint with no follow-up transaction.create_personalized_offer— Create a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments).create_reward— Create a new reward redeemable with loyalty tokensdelete_report— Internal. Delete a report you submitted.earn_points— Mint cashback tokens for a purchase at the program's cashback rate, optionally redeeming points first (points_to_redeem or redeem_all) to lower the payable amount. Returns a fee-first calls[] bundle (protocol fee mint, then the customer mint): submit in order (atomically via EIP-5792 if supported), then call confirm_mint_fee with obligation_id, fee_tx_hash, recipient_tx_hash. Unconfirmed fees block future mints.export_customers— Export customers of one of your loyalty programs: the same wallet set and total_customers as GET /customers and get_program_analytics (voucher holders, ledger rows, completed mints), each with voucher stats, on-chain current_balance plus offchain_ledger_balance, and tier. Email-only store customers are listed in store_customers.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_my_profile— Get authenticated agent's profile, plan limits, and current-period usageget_payment_info— Free: agent Pro/Enterprise (or merchant) plan options, USDC subscription wallet, per-plan limits, annual prices, and the required-sender rule. Optional product=agent|merchant. Prefer this before paying; verify with POST /verify-agent-plan-payment action verify_payment.get_platform_info— Get info about Loyal Spark protocol on Base L2get_program_analytics— Get analytics for one of your loyalty programs. total_customers is the same count export_customers and GET /customers report; a program you do not own returns program_not_found.get_program_workflow_status— Explain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values)get_token_balance— Get loyalty token balance and tier info for a customer (accepts 0x Base wallet address or customer email in customer_address / customer_email)list_fee_obligations— List protocol-fee obligations for this API key. status=unpaid is an alias for pending. Each unpaid row includes next_action describing POST /mint/confirm.list_gift_certificates— List gift certificates issued by the agent's merchant (with status and redemption info).list_loyalty_programs— List loyalty programs owned by the agent's merchantlist_marketplace_offers— List active token trading offers on the marketplacelist_mints— List 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 offchain_ledger_balance stays 0 until confirm.list_my_reports— Internal. List reports this agent submitted (status new, reviewed, or done).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.list_store_discount_codes— List discount codes for this merchant's Shopify store, plus how customers spend points (online code, register voucher, or both).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.mint_loyalty_tokens— Record a mint intent and get a fee-first calls[] bundle: protocol fee mint first (in the merchant's own loyalty tokens, not USDC), then the recipient mint. Submit both in order (atomically via EIP-5792 if supported), then call confirm_mint_fee with obligation_id, fee_tx_hash, recipient_tx_hash. Unconfirmed fees block future mints. recipient_address takes a 0x Base wallet or a customer email (or use recipient_email); the wallet is resolved server-side.redeem_reward— Redeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer.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).revoke_gift_certificate— Revoke an active gift certificate (status active -> revoked). Only the issuing merchant can revoke. Already-redeemed/minted certificates cannot be revoked.send_report— Internal. Send a report to the merchant's Agent Reports dashboard (SEO audits, growth ideas, anomalies, weekly summaries). Not a loyalty action.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).transfer_loyalty_tokens— Build B20 token transfer calldata (ERC-20 compatible) to send loyalty tokens from your merchant wallet to any 0x address. Recipient: to (alias to_address).update_program_config— Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)update_program_status— Update program status in database after onchain activation/pauseupdate_report_status— Internal. Set a report you submitted to reviewed or done.update_reward_status— Activate or deactivate a reward in the catalog. Use to manage reward availability based on analytics.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.use_voucher— Mark a voucher as used at the merchant. Send one of voucher_code (alias code) or voucher_id (anyOf). If neither is sent the tool returns error_code missing_identifier and an example. A voucher used before returns error_code voucher_already_used (do not retry).
First seen · last seen · last active