Loyal Spark
Server Details
43 MCP tools for onchain loyalty on Base: programs, minting, rewards, vouchers. x402 or lsk_ key.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-03-26
- URL
- Server Listing
- Loyal Spark Loyalty Protocol
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 43 tools
Most tools have distinguishable purposes, but several clusters overlap and rely on descriptions to separate: create_loyalty_program vs register_loyalty_program vs activate_loyalty_program, and update_program_config vs update_program_status are easy to misselect. The mint flow (mint_loyalty_tokens, earn_points, confirm_mint_fee) is also tightly coupled and requires careful reading, and the bazaar_* quartet sits outside the loyalty domain. Descriptions do carry the distinctions, keeping it mid-range.
Nearly everything follows snake_case verb_noun (create_reward, list_rewards, update_reward_status, redeem_reward), with predictable list_/get_/create_/update_ prefixes. Minor deviations exist (get_my_profile, bazaar_discover_mcp_servers, earn_points) but they are readable and not confusing.
43 tools is well beyond the comfortable 3-15 range for a single loyalty server, and the surface sprawls across loyalty programs, minting, gift certificates, vouchers, Shopify discount codes, marketplace listings, internal reports, and x402/Bazaar payments. Several tools (reports, Bazaar) feel like separate products bundled into one server, inflating the count.
Core lifecycle is well covered: deploy/register/activate program, mint/earn, rewards create-list-deactivate, gift certificates create/claim/mint/revoke, voucher check/use, analytics and export. However, gaps are notable: no way to delete or deactivate a loyalty program, no reward field updates or deletion, and only list_marketplace_offers with no offer creation/acceptance, so marketplace workflows dead-end.
Available Tools
43 toolsactivate_loyalty_programActivate Loyalty ProgramAInspect
For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).
Inputs: token_address (required).
bazaar_discover_mcp_serversBazaar Discover MCP ServersARead-onlyIdempotentInspect
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.
Inputs: q, limit, cursor, network.
bazaar_discover_resourcesBazaar Discover ResourcesBRead-onlyIdempotentInspect
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').
Inputs: q, limit, cursor, network.
bazaar_pay_and_callBazaar Pay And CallAInspect
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.
Inputs: url (required), body, method, headers, +3 more.
bazaar_probe_x402Bazaar Probe x402ARead-onlyIdempotentInspect
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.
Inputs: url (required).
check_voucher_statusCheck Voucher StatusARead-onlyIdempotentInspect
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.
Inputs: code, voucher_id, voucher_code.
confirm_mint_feeConfirm Mint FeeAIdempotentInspect
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.
Inputs: fee_tx_hash (required), obligation_id (required), mint_intent_id, recipient_tx_hash.
create_gift_certificateCreate Gift CertificateAInspect
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.
Inputs: usd_amount (required), token_address (required), title, quantity, +5 more.
create_loyalty_programCreate Loyalty ProgramAInspect
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.
Inputs: name (required), symbol (required), locale, auto_generate, +7 more.
create_personalized_offerCreate Personalized OfferBInspect
Create a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments).
Inputs: title (required), token_address (required), customer_address (required), valid_days, +3 more.
create_rewardCreate RewardCInspect
Create a new reward redeemable with loyalty tokens
Inputs: cost (required), name (required), token_address (required), description.
delete_reportDelete ReportCDestructiveInspect
Internal. Delete a report you submitted.
Inputs: report_id (required).
earn_pointsEarn PointsAInspect
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.
Inputs: token_address (required), purchase_amount (required), customer_address (required), redeem_all, +3 more.
export_customersExport CustomersBRead-onlyIdempotentInspect
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.
Inputs: token_address (required).
generate_program_defaultsGenerate Program DefaultsBRead-onlyIdempotentInspect
Workflow planner: field catalog, required parameters, next_actions, and non-binding examples. External agents must choose their own name, symbol, and economics.
Inputs: locale, category, description, business_name, +2 more.
get_my_profileGet My ProfileARead-onlyIdempotentInspect
Get authenticated agent's profile, plan limits, and current-period usage
Inputs: no named parameters.
get_payment_infoGet Payment InfoARead-onlyIdempotentInspect
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.
Inputs: product.
get_platform_infoGet Platform InfoCRead-onlyIdempotentInspect
Get info about Loyal Spark protocol on Base L2
Inputs: no named parameters.
get_program_analyticsGet Program AnalyticsBRead-onlyIdempotentInspect
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.
Inputs: token_address (required).
get_program_workflow_statusGet Program Workflow StatusARead-onlyIdempotentInspect
Explain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values)
Inputs: token_address.
get_token_balanceGet Token BalanceBRead-onlyIdempotentInspect
Get loyalty token balance and tier info for a customer (accepts 0x Base wallet address or customer email in customer_address / customer_email)
Inputs: token_address (required), customer_address (required).
list_fee_obligationsList Fee ObligationsARead-onlyIdempotentInspect
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.
Inputs: status.
list_gift_certificatesList Gift CertificatesARead-onlyIdempotentInspect
List gift certificates issued by the agent's merchant (with status and redemption info).
Inputs: limit, status, token_address.
list_loyalty_programsList Loyalty ProgramsARead-onlyIdempotentInspect
List loyalty programs owned by the agent's merchant
Inputs: include_expired.
list_marketplace_offersList Marketplace OffersBRead-onlyIdempotentInspect
List active token trading offers on the marketplace
Inputs: limit, status, token_address.
list_mintsList MintsARead-onlyIdempotentInspect
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.
Inputs: status, token_address.
list_my_reportsList My ReportsBRead-onlyIdempotentInspect
Internal. List reports this agent submitted (status new, reviewed, or done).
Inputs: limit, status.
list_rewardsList RewardsARead-onlyIdempotentInspect
List rewards for a loyalty program by token_address. Includes redemption metrics (total vouchers issued, redeemed, and last-30-day counts) for each reward.
Inputs: token_address (required).
list_store_discount_codesList Store Discount CodesBRead-onlyIdempotentInspect
List discount codes for this merchant's Shopify store, plus how customers spend points (online code, register voucher, or both).
Inputs: token_address.
mark_gift_certificate_mintedMark Gift Certificate MintedAIdempotentInspect
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.
Inputs: certificate_id (required), transaction_hash (required).
mint_loyalty_tokensMint Loyalty TokensAInspect
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.
Inputs: amount (required), token_address (required), recipient, recipient_email, +1 more.
redeem_rewardRedeem RewardAInspect
Redeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer.
Inputs: reward_id (required), customer_address (required), transaction_hash (required).
register_loyalty_programRegister Loyalty ProgramAInspect
Register a deployed token as a loyalty program in the database. B20 tokens are registered as active; legacy ERC-20 as inactive (activate next).
Inputs: name (required), symbol (required), token_address (required), cashback_rate, +3 more.
revoke_gift_certificateRevoke Gift CertificateADestructiveInspect
Revoke an active gift certificate (status active -> revoked). Only the issuing merchant can revoke. Already-redeemed/minted certificates cannot be revoked.
Inputs: certificate_id (required).
send_reportSend ReportBInspect
Internal. Send a report to the merchant's Agent Reports dashboard (SEO audits, growth ideas, anomalies, weekly summaries). Not a loyalty action.
Inputs: title (required), content (required), agent_role (required), report_type (required), +2 more.
set_store_sales_channelSet Store Sales ChannelAIdempotentInspect
Set how this store's customers spend loyalty points: online (checkout code), offline (voucher at the register), or both (the shopper chooses).
Inputs: channel (required).
transfer_loyalty_tokensTransfer Loyalty TokensAInspect
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).
Inputs: amount (required), token_address (required), to, to_address.
update_program_configUpdate Program ConfigBIdempotentInspect
Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)
Inputs: token_address (required), cashback_rate, points_per_dollar.
update_program_statusUpdate Program StatusAIdempotentInspect
Update program status in database after onchain activation/pause
Inputs: status (required), token_address (required).
update_report_statusUpdate Report StatusAIdempotentInspect
Internal. Set a report you submitted to reviewed or done.
Inputs: status (required), report_id (required).
update_reward_statusUpdate Reward StatusBIdempotentInspect
Activate or deactivate a reward in the catalog. Use to manage reward availability based on analytics.
Inputs: is_active (required), reward_id (required).
update_store_discount_codeUpdate Store Discount CodeADestructiveIdempotentInspect
Mark a Shopify discount code used, or cancel it and return the loyalty points. Same actions as the merchant discount-code journal.
Inputs: action (required), redemption_id (required).
use_voucherUse VoucherADestructiveInspect
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).
Inputs: code, voucher_id, voucher_code.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
32 paid x402 endpoints for crypto, Zora & on-chain analysis. 10 MCP tools. USDC on Base.
Loyalty holders on Base: balances, rewards, vouchers, P2P offers. x402 pay-per-call or rwk_ key.
Pay-per-use MCP tools for AI agents. USDC on Base via x402. No API keys.
37 paid x402 MCP tools for OSINT, prediction markets, web intel, and agent security on Base USDC.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenance498 MCP tools across 12 industry verticals. Marketplace, escrow, DeFi, legal, healthcare, insurance, construction, and trades. USDC payments on Base L2.MIT

AfaAgent x402 API Suiteofficial
FlicenseNot gradedqualityDmaintenance43 x402-enabled API tools — DeFi, wallet security, AI/ML, developer tools, SEO. Pay-per-call USDC on Base via x402 protocol.-- AlicenseAqualityDmaintenanceMCP server providing Solana/crypto/macro tools (wallet scan, password breach, Jito tip, GitHub health, FRED series, Drift exposure, premium chapters) with x402 payment gating (USDC on Base) for 7 of 8 tools.15MIT
- AlicenseAqualityBmaintenanceMCP server exposing 43 pay-per-call x402 tools (USDC on Base) for AI agents: validation, data lookup and utility APIs. No API key needed.59MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.