get_platform_info
Get Platform Info
Get info about Loyal Spark protocol on Base L2
无需输入参数。
io.github.aspekt19由 GitHub 账号 aspekt19 发布v1.0.5更新于 Nov 22, 2026
43 MCP tools for onchain loyalty on Base: programs, minting, rewards, vouchers. x402 or lsk_ key.
面向 Base 上 Loyal Spark 商户的 MCP:部署忠诚度代币、发放返现、管理奖励、优惠券与礼品券。
Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。
把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。
阅读 https://sourceweft.com/mcp/io.github.aspekt19%2Floyal-spark/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。把它添加到你客户端的 mcpServers 配置中。
{
"mcpServers": {
"loyal-spark": {
"type": "http",
"url": "https://api.loyalspark.online/loyalty-mcp"
}
}
}该仓库没有 README。
Get Platform Info
Get info about Loyal Spark protocol on Base L2
无需输入参数。
Get My Profile
Get authenticated agent's profile, plan limits, and current-period usage
无需输入参数。
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.
name必填localesymbol必填auto_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).
name必填symbol必填cashback_ratetoken_address必填token_standardexpiration_dayspoints_per_dollarActivate Loyalty Program
For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).
token_address必填Update Program Status
Update program status in database after onchain activation/pause
status必填token_address必填Update Program Config
Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)
cashback_ratetoken_address必填points_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_address必填Create Reward
Create a new reward redeemable with loyalty tokens
cost必填name必填descriptiontoken_address必填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.
amount必填recipienttoken_address必填recipient_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).
toamount必填to_addresstoken_address必填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.
redeem_allcashback_ratetoken_address必填customer_emailpurchase_amount必填customer_address必填points_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_hash必填obligation_id必填mint_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_address必填customer_address必填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.
token_address必填List 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_id必填customer_address必填transaction_hash必填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).
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).
title必填valid_daysdescriptionbonus_tokenstoken_address必填customer_address必填discount_percentageUpdate Reward Status
Activate or deactivate a reward in the catalog. Use to manage reward availability based on analytics.
is_active必填reward_id必填Send Report
Internal. Send a report to the merchant's Agent Reports dashboard (SEO audits, growth ideas, anomalies, weekly summaries). Not a loyalty action.
title必填content必填priorityagent_role必填report_type必填action_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.
status必填report_id必填Delete Report
Internal. Delete a report you submitted.
report_id必填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.
token_address必填List 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.
action必填redemption_id必填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).
channel必填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.
titlequantityimage_urlusd_amount必填descriptiontoken_address必填expires_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_id必填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.
certificate_id必填transaction_hash必填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').
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.
url必填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.
url必填bodymethodheadersmax_usdcallowed_schemesallowed_networks已满足适用检查项的 83%
该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。
请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。
托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。