Loyal Spark

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.

VerifiedStreamable HTTPWeb executableFinanceData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Merchant MCP for Loyal Spark on Base: deploy loyalty tokens, mint cashback, manage rewards, vouchers and gift certificates.

What you can do
  • Inspect platform info, plans, payment details and the agent's own profile and usage
  • Create, register, activate and configure loyalty programs; list programs and update status
  • Mint, transfer and check loyalty token balances; record mint intents and confirm protocol-fee obligations
  • Create and manage rewards, redeem them with a transfer hash, and issue, check or use vouchers
  • Analyze programs, export customers, create personalized offers and manage Shopify discount codes
  • Issue, list, revoke and mark minted gift certificates; browse marketplace offers and x402 resources
When to use it
Use it when an assistant should run a merchant loyalty program on Base end to end: launching a token, paying out cashback, running rewards and vouchers, and reviewing program analytics. It is aimed at merchants and agents that already operate a wallet on Base.
Requirements
Remote streamable HTTP endpoint at api.loyalspark.online; no local install. A merchant API key sent as x-api-key or Authorization: Bearer; tools/list and get_platform_info work without one. A Free-plan key costs $0.01 USDC paid once per wallet via the x402 gateway or SIWE. A Base wallet and network access are needed for onchain steps.
Before you install
The server handles a merchant API key and a Base wallet that signs token deployments, mints and transfers; keep the key private. Onchain actions spend gas and protocol fees are minted in the merchant's own loyalty tokens, while plan payment is in USDC. Tools write and change data: programs, rewards, vouchers, gift certificates, discount codes and reports, and some deletions are irreversible. Customer emails and wallet data are exported and sent to the service.

Installation

In SourceWeft

  1. Open Loyal Spark in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

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.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

This repository has no README.

Tools

43

get_platform_info

Get Platform Info

Get info about Loyal Spark protocol on Base L2

Takes no parameters.

get_my_profile

Get My Profile

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

Takes no parameters.

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.

Parametersproduct

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.

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

Parameterstoken_address

list_loyalty_programs

List Loyalty Programs

List loyalty programs owned by the agent's merchant

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

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

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

Parameterstoken_addressrequired

update_program_status

Update Program Status

Update program status in database after onchain activation/pause

Parametersstatusrequiredtoken_addressrequired

update_program_config

Update Program Config

Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)

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

Parameterstoken_addressrequired

create_reward

Create Reward

Create a new reward redeemable with loyalty tokens

Parameterscostrequirednamerequireddescriptiontoken_addressrequired

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.

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

Parameterstoamountrequiredto_addresstoken_addressrequired

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.

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

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

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

Parametersstatus

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)

Parameterstoken_addressrequiredcustomer_addressrequired

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.

Parameterstoken_addressrequired

list_marketplace_offers

List Marketplace Offers

List active token trading offers on the marketplace

Parameterslimitstatustoken_address

redeem_reward

Redeem Reward

Redeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer.

Parametersreward_idrequiredcustomer_addressrequiredtransaction_hashrequired

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

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

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

Parameterstitlerequiredvalid_daysdescriptionbonus_tokenstoken_addressrequiredcustomer_addressrequireddiscount_percentage

update_reward_status

Update Reward Status

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

Parametersis_activerequiredreward_idrequired

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.

Parameterstitlerequiredcontentrequiredpriorityagent_rolerequiredreport_typerequiredaction_items

list_my_reports

List My Reports

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

Parameterslimitstatus

update_report_status

Update Report Status

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

Parametersstatusrequiredreport_idrequired

delete_report

Delete Report

Internal. Delete a report you submitted.

Parametersreport_idrequired

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.

Parameterstoken_addressrequired

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

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

Parametersactionrequiredredemption_idrequired

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

Parameterschannelrequired

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.

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

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

Parameterscertificate_idrequired

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.

Parameterscertificate_idrequiredtransaction_hashrequired

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

Parametersqlimitcursornetwork

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.

Parametersqlimitcursornetwork

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.

Parametersurlrequired

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.

Parametersurlrequiredbodymethodheadersmax_usdcallowed_schemesallowed_networks

Version history

3
  1. v1.0.5LatestNov 19, 2026
  2. v1.0.4Oct 11, 2026
  3. v1.0.3Sep 16, 2026

Score

83% 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.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.