Loyal Spark MCP server

• activate_loyalty_programFree

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

• bazaar_discover_mcp_serversFree

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

• bazaar_discover_resourcesFree

  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_callwrite actionFree

  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_x402Free

  GET a candidate x402 URL and, if it responds HTTP 402, return the parsed payment requirements (accepts[]) so the caller can decide whether to pay. HTTPS only. No signing performed.

• check_voucher_statusFree

  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_feeFree

  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_certificatewrite actionFree

  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_programwrite actionFree

  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_offerwrite actionFree

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

• create_rewardwrite actionFree

  Create a new reward redeemable with loyalty tokens

• delete_reportwrite actionFree

  Internal. Delete a report you submitted.

• earn_pointsFree

  Calculate 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 calculating new cashback. 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 /agent-api/mint/confirm) with obligation_id, fee_tx_hash, and recipient_tx_hash. Unconfirmed fee obligations block future mints.

• export_customersFree

  Export customer data for a specific loyalty program. Returns wallet addresses, voucher stats, balances, and tier info. Use for analytics, segmentation, and personalized offers.

• generate_program_defaultsFree

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

• get_my_profileFree

  Get authenticated agent's profile

• get_platform_infoFree

  Get info about Loyal Spark protocol on Base L2

• get_program_analyticsFree

  Get analytics for one of your loyalty programs

• get_program_workflow_statusFree

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

• get_token_balanceFree

  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_obligationsFree

  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_certificatesFree

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

• list_loyalty_programsFree

  List loyalty programs owned by the agent's merchant

• list_marketplace_offersFree

  List active token trading offers on the marketplace

• list_mintsFree

  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 stays 0 until confirm.

• list_my_reportsFree

  Internal. List reports this agent submitted (status new, reviewed, or done).

• list_rewardsFree

  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_codesFree

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

• mark_gift_certificate_mintedFree

  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_tokensFree

  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), then call confirm_mint_fee (or POST /agent-api/mint/confirm) with obligation_id, fee_tx_hash, and recipient_tx_hash. Unconfirmed fee obligations block future mints. Accepts a 0x Base wallet address or customer email in recipient_address (or recipient_email), automatically resolving the customer's wallet.

• redeem_rewardFree

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

• register_loyalty_programFree

  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_certificateFree

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

• send_reportwrite actionFree

  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_channelFree

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

• transfer_loyalty_tokenswrite actionFree

  Get calldata to transfer loyalty tokens between wallets

• update_program_configwrite actionFree

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

• update_program_statuswrite actionFree

  Update program status in database after onchain activation/pause

• update_report_statuswrite actionFree

  Internal. Set a report you submitted to reviewed or done.

• update_reward_statuswrite actionFree

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

• update_store_discount_codewrite actionFree

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

• use_voucherFree

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

• –Code scanremote-only server, no package to scann/a
• Live reliabilityremote reachable in 1537ms20/20
• Tool poisoning42 tool descriptions checked15/15
• Auth qualityAPI key sent as a header8/15
• Maintenanceno repository listed3/15
• Maintainer identityno repository or website to verify2/10

Safety score

64/100

higher than 19% of 48,243 servers

Tools

42

the typical server has 7

Tools that change things

31%

typical: 0%. Fewer write tools means less an agent can break

Uptime

100%

of our recent checks; the typical remote server answers 100%

Response time

777 ms

faster than 19% of 30,027 servers

GitHub stars

13

more than 89% of 28,706 servers

Grade history

• 2026-10-29downgradeB → Cscore 64: No source repository listed

Loyal Spark: common questions

Is Loyal Spark MCP server safe?

With care: it is graded C, so read the findings first (64/100). Read the Loyal Spark safety report

How do I install Loyal Spark?

It runs remotely at api.loyalspark.online. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.

Does Loyal Spark need an API key?

Yes. The registry entry asks for x-api-key, Authorization.

Is Loyal Spark maintained?

The last commit was 47 days ago (2026-09-20). The latest release is v1.0.4.

Is Loyal Spark up?

100% of our last 28 checks got an answer. We check remote servers about four times a day.

How does Loyal Spark compare with other MCP servers?

safety score 64/100 (higher than 19% of 48,243 servers); tools 42 (the typical server has 7); tools that change things 31% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.