get_platform_info
Get Platform Info
Get info about Loyal Spark protocol on Base L2
Takes no parameters.
io.github.aspekt19Published by GitHub account aspekt19v1.0.5Updated Nov 22, 2026
43 MCP tools for onchain loyalty on Base: programs, minting, rewards, vouchers. x402 or lsk_ key.
Merchant MCP for Loyal Spark on Base: deploy loyalty tokens, mint cashback, manage rewards, vouchers and gift certificates.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.github.aspekt19%2Floyal-spark/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"loyal-spark": {
"type": "http",
"url": "https://api.loyalspark.online/loyalty-mcp"
}
}
}This repository has no README.
Get Platform Info
Get info about Loyal Spark protocol on Base L2
Takes no parameters.
Get My Profile
Get authenticated agent's profile, plan limits, and current-period usage
Takes no parameters.
Get 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.
productGenerate Program Defaults
Workflow planner: field catalog, required parameters, next_actions, and non-binding examples. External agents must choose their own name, symbol, and economics.
localecategorydescriptionbusiness_namepreferred_styletarget_audienceGet Program Workflow Status
Explain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values)
token_addressList Loyalty Programs
List loyalty programs owned by the agent's merchant
include_expiredCreate 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.
namerequiredlocalesymbolrequiredauto_generateextra_minterstoken_standardexpiration_dayspreferred_styletarget_audiencebusiness_contextagent_wallet_addressRegister 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).
namerequiredsymbolrequiredcashback_ratetoken_addressrequiredtoken_standardexpiration_dayspoints_per_dollarActivate Loyalty Program
For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).
token_addressrequiredUpdate Program Status
Update program status in database after onchain activation/pause
statusrequiredtoken_addressrequiredUpdate Program Config
Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)
cashback_ratetoken_addressrequiredpoints_per_dollarList 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.
token_addressrequiredCreate Reward
Create a new reward redeemable with loyalty tokens
costrequirednamerequireddescriptiontoken_addressrequiredMint 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.
amountrequiredrecipienttoken_addressrequiredrecipient_emailrecipient_addressTransfer 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).
toamountrequiredto_addresstoken_addressrequiredEarn 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.
redeem_allcashback_ratetoken_addressrequiredcustomer_emailpurchase_amountrequiredcustomer_addressrequiredpoints_to_redeemConfirm 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.
fee_tx_hashrequiredobligation_idrequiredmint_intent_idrecipient_tx_hashList 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.
statustoken_addressList 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.
statusGet 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)
token_addressrequiredcustomer_addressrequiredGet 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.
token_addressrequiredList Marketplace Offers
List active token trading offers on the marketplace
limitstatustoken_addressRedeem Reward
Redeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer.
reward_idrequiredcustomer_addressrequiredtransaction_hashrequiredUse 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).
codevoucher_idvoucher_codeCheck 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.
codevoucher_idvoucher_codeCreate Personalized Offer
Create a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments).
titlerequiredvalid_daysdescriptionbonus_tokenstoken_addressrequiredcustomer_addressrequireddiscount_percentageUpdate Reward Status
Activate or deactivate a reward in the catalog. Use to manage reward availability based on analytics.
is_activerequiredreward_idrequiredSend Report
Internal. Send a report to the merchant's Agent Reports dashboard (SEO audits, growth ideas, anomalies, weekly summaries). Not a loyalty action.
titlerequiredcontentrequiredpriorityagent_rolerequiredreport_typerequiredaction_itemsList My Reports
Internal. List reports this agent submitted (status new, reviewed, or done).
limitstatusUpdate Report Status
Internal. Set a report you submitted to reviewed or done.
statusrequiredreport_idrequiredDelete Report
Internal. Delete a report you submitted.
report_idrequiredExport 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.
token_addressrequiredList Store Discount Codes
List discount codes for this merchant's Shopify store, plus how customers spend points (online code, register voucher, or both).
token_addressUpdate 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.
actionrequiredredemption_idrequiredSet 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).
channelrequiredCreate 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.
titlequantityimage_urlusd_amountrequireddescriptiontoken_addressrequiredexpires_in_dayspoints_per_dollarmax_redemption_percentList Gift Certificates
List gift certificates issued by the agent's merchant (with status and redemption info).
limitstatustoken_addressRevoke Gift Certificate
Revoke an active gift certificate (status active -> revoked). Only the issuing merchant can revoke. Already-redeemed/minted certificates cannot be revoked.
certificate_idrequiredMark 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.
certificate_idrequiredtransaction_hashrequiredBazaar 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').
qlimitcursornetworkBazaar 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.
qlimitcursornetworkBazaar 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.
urlrequiredBazaar 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.
urlrequiredbodymethodheadersmax_usdcallowed_schemesallowed_networks83% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.
A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.