Loyal Spark

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.

已验证Streamable HTTP可网页运行金融数据与分析商业与电商

概览

AI 生成的概览

面向 Base 上 Loyal Spark 商户的 MCP:部署忠诚度代币、发放返现、管理奖励、优惠券与礼品券。

可以做什么
  • 查询平台信息、套餐、付款详情以及代理自身资料与用量
  • 创建、注册、激活并配置忠诚度计划,列出计划并更新状态
  • 铸造、转账并查询忠诚度代币余额,记录铸造意图并确认协议费义务
  • 创建和管理奖励,凭转账哈希兑换奖励,签发、查询或核销优惠券
  • 分析计划表现、导出客户、创建个性化优惠并管理 Shopify 折扣码
  • 签发、列出、撤销礼品券并标记已铸造,浏览市场报价与 x402 资源
适用场景
适合让助手端到端运营 Base 上的商户忠诚度计划:发行代币、发放返现、运行奖励与优惠券,并查看计划分析。主要面向已在 Base 上持有钱包的商户和代理。
运行要求
远程 streamable HTTP 端点 api.loyalspark.online,无需本地安装。需要商户 API 密钥,通过 x-api-key 或 Authorization: Bearer 发送;tools/list 和 get_platform_info 无需密钥。免费套餐密钥需每个钱包通过 x402 网关或 SIWE 一次性支付 0.01 USDC。链上操作需要 Base 钱包和网络访问。
安装前请注意
服务涉及商户 API 密钥和用于签署代币部署、铸造与转账的 Base 钱包,请妥善保管密钥。链上操作消耗 gas,协议费以商户自有忠诚度代币铸造,套餐费用则以 USDC 支付。多个工具会写入或修改数据:计划、奖励、优惠券、礼品券、折扣码和报告,部分删除不可恢复。客户邮箱和钱包数据会被导出并发送到该服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Loyal Spark,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.aspekt19%2Floyal-spark/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "loyal-spark": {
      "type": "http",
      "url": "https://api.loyalspark.online/loyalty-mcp"
    }
  }
}

README

该仓库没有 README。

工具

43

get_platform_info

Get Platform Info

Get info about Loyal Spark protocol on Base L2

无需输入参数。

get_my_profile

Get My Profile

Get authenticated agent's profile, plan limits, and current-period usage

无需输入参数。

get_payment_info

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.

输入参数product

generate_program_defaults

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.

输入参数localecategorydescriptionbusiness_namepreferred_styletarget_audience

get_program_workflow_status

Get Program Workflow Status

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

输入参数token_address

list_loyalty_programs

List Loyalty Programs

List loyalty programs owned by the agent's merchant

输入参数include_expired

create_loyalty_program

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 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_address

register_loyalty_program

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

输入参数name必填symbol必填cashback_ratetoken_address必填token_standardexpiration_dayspoints_per_dollar

activate_loyalty_program

Activate 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

Update program status in database after onchain activation/pause

输入参数status必填token_address必填

update_program_config

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_dollar

list_rewards

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.

输入参数token_address必填

create_reward

Create Reward

Create a new reward redeemable with loyalty tokens

输入参数cost必填name必填descriptiontoken_address必填

mint_loyalty_tokens

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_address

transfer_loyalty_tokens

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

输入参数toamount必填to_addresstoken_address必填

earn_points

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_redeem

confirm_mint_fee

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 recipient_tx_hash still credits the customer after the fee is already settled.

输入参数fee_tx_hash必填obligation_id必填mint_intent_idrecipient_tx_hash

list_mints

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.

输入参数statustoken_address

list_fee_obligations

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.

输入参数status

get_token_balance

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)

输入参数token_address必填customer_address必填

get_program_analytics

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 Marketplace Offers

List active token trading offers on the marketplace

输入参数limitstatustoken_address

redeem_reward

Redeem 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

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_code

check_voucher_status

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.

输入参数codevoucher_idvoucher_code

create_personalized_offer

Create 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_percentage

update_reward_status

Update Reward Status

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

输入参数is_active必填reward_id必填

send_report

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_items

list_my_reports

List My Reports

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

输入参数limitstatus

update_report_status

Update Report Status

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

输入参数status必填report_id必填

delete_report

Delete Report

Internal. Delete a report you submitted.

输入参数report_id必填

export_customers

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 Store Discount Codes

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

输入参数token_address

update_store_discount_code

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.

输入参数action必填redemption_id必填

set_store_sales_channel

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 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_percent

list_gift_certificates

List Gift Certificates

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

输入参数limitstatustoken_address

revoke_gift_certificate

Revoke 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

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

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').

输入参数qlimitcursornetwork

bazaar_discover_mcp_servers

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.

输入参数qlimitcursornetwork

bazaar_probe_x402

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

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

版本历史

3
  1. v1.0.5最新Nov 19, 2026
  2. v1.0.4Oct 11, 2026
  3. v1.0.3Sep 16, 2026

评分

已满足适用检查项的 83%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分

    请声明包含 README 的 GitHub 仓库,或在 OAuth 受保护资源元数据中提供 resource_documentation。

  • 许可证不适用

    托管服务按其提供方的条款使用,因此这里不要求许可证。此检查项不计入百分比。