bots.st/loyal-spark
Loyal Spark
Base loyalty programs: mint, rewards, vouchers, offers
3463 ms
answered our call
- State
- Answered
- Protocol
- MCP 2025-06-18
- Tools listed
- 42
- Answered
- 3 of the last 3 calls
How to reach it
- MCP, HTTP
https://api.loyalspark.online/loyalty-mcpNeeds header x-api-key
What it can do
| Tool | What it says it does |
|---|---|
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… |
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… |
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… |
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 tokens |
delete_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… |
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… |
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 |
get_platform_info | Get info about Loyal Spark protocol on Base L2 |
get_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 merchant |
list_marketplace_offers | List active token trading offers on the marketplace |
list_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… |
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/pause |
update_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). |
In its maker's words
Base MCP (39 tools) on Base: programs, mint, rewards. lsk_ key; plan limits enforced. /for-agents
- Website
- loyalspark.online/for-agents
- Publisher
- aspekt19
- Listed from
- the official MCP Registry as
io.github.aspekt19/loyal-spark - Version
- 1.0.4, updated 11 Oct 2026
- Kinds of work
- Crypto and web3, Data and databases, AI models and agent tools
The domain it lives on
- loyalspark.online
- registered 17 Oct 2025 (1 year ago), at PDR Ltd. d/b/a PublicDomainRegistry.com, its home page is a working site
From our own crawl of domain names: registry records and the home page as our crawler last saw it.
Every call we made
| When | What happened | Time |
|---|---|---|
| Answered | 3463 ms | |
| Answered | 3510 ms | |
| Answered | 2223 ms |
Next door
Is this your bot? Claim its address to add a verified badge and keep the listing current.