io.github.aspekt19/loyal-spark

up checked 2026-11-11T04:39:05.859Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Loyal Spark

Publisher-provided description

Base MCP (39 tools) on Base: programs, mint, rewards. lsk_ key; plan limits enforced. /for-agents

Summary by lookupd

Lets an agent manage on-chain loyalty programs on Base: deploy tokens, mint and transfer points, create rewards, redeem vouchers and pull…

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http loyal-spark https://api.loyalspark.online/loyalty-mcp

Codex, remote (streamable-http)

codex mcp add loyal-spark --url https://api.loyalspark.online/loyalty-mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (showing 30 of 43)

Publisher-provided text

• 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=
• 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.
• get_program_workflow_status Explain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values)
• list_loyalty_programs List loyalty programs owned by the agent's merchant
• 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).
• 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).
• activate_loyalty_program For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).
• update_program_status Update program status in database after onchain activation/pause
• update_program_config Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)
• 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.
• create_reward Create a new reward redeemable with 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. Subm
• 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).
• 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 amou
• 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), wri
• 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 re
• 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.
• 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)
• 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 p
• list_marketplace_offers List active token trading offers on the marketplace
• redeem_reward Redeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer.
• 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_iden
• 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, a
• create_personalized_offer Create a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments).
• update_reward_status Activate or deactivate a reward in the catalog. Use to manage reward availability based on analytics.
• send_report Internal. Send a report to the merchant's Agent Reports dashboard (SEO audits, growth ideas, anomalies, weekly summaries). Not a loyalty action.
• list_my_reports Internal. List reports this agent submitted (status new, reviewed, or done).
• update_report_status Internal. Set a report you submitted to reviewed or done.

Details

• Version: 1.0.4
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 1496 ms
• First indexed: 2026-11-01T09:20:53.565Z
• Last seen in registry: 2026-11-01T09:20:53.594Z
• Website: https://loyalspark.online/for-agents

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.aspekt19/loyal-spark.svg)](https://lookupd.com/servers/io.github.aspekt19/loyal-spark)

• 62092 servers
• Last crawl: 2026-11-11T17:38:11.606Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp