Skip to content
Agentmart
Submit a tool

Loyal Spark

Base MCP (39 tools) on Base: programs, mint, rewards.

Connector by aspekt19 · GitHub account verified by the MCP Registry

IndexedLicense unknownRemote (HTTP)
Write a review

Install

Works with Claude Code, VS Code, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/aspekt19-loyal-spark

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Remote endpoint

  • https://api.loyalspark.online/loyalty-mcp Remote (HTTP)

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
19 read · 19 write · 4 delete
Secrets
2 (API keys, tokens or passwords)
Install scripts
Nothing to install (hosted)
Runs as
Hosted (remote endpoint)

Tools by what they do 42

From the running server's own tool list (tools/list) on Oct 25, 2026.

Read 19 · Look things up without changing anything.

  • bazaar_discover_mcp_servers
  • bazaar_discover_resources
  • bazaar_probe_x402
  • check_voucher_status
  • export_customers
  • generate_program_defaults
  • get_my_profile
  • get_platform_info
  • get_program_analytics
  • get_program_workflow_status
  • get_token_balance
  • list_fee_obligations
Show 7 more tools
  • list_gift_certificates
  • list_loyalty_programs
  • list_marketplace_offers
  • list_mints
  • list_my_reports
  • list_rewards
  • list_store_discount_codes

Write 19 · Create, change, send or run things.

  • activate_loyalty_program
  • bazaar_pay_and_call
  • confirm_mint_fee
  • create_gift_certificate
  • create_loyalty_program
  • create_personalized_offer
  • create_reward
  • earn_points
  • mark_gift_certificate_minted
  • mint_loyalty_tokens
  • redeem_reward
  • register_loyalty_program
Show 7 more tools
  • send_report
  • set_store_sales_channel
  • transfer_loyalty_tokens
  • update_program_config
  • update_program_status
  • update_report_status
  • update_reward_status

Delete 4 · Delete, drop, revoke or wipe things.

  • delete_report
  • revoke_gift_certificate
  • update_store_discount_code
  • use_voucher

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • Authorization
  • x-api-key

Network hosts it talks to 1

  • api.loyalspark.online · found in remote endpoint, install command

Tools (42)

As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • activate_loyalty_program

    For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active).

  • bazaar_discover_mcp_serversread-only

    Discover third-party MCP servers published in Coinbase CDP's Bazaar. Read-only. Filter by free-text q and/or network.

  • bazaar_discover_resourcesread-only

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

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

  • bazaar_probe_x402read-only

    GET a candidate x402 URL and, if it responds HTTP 402, return the parsed payment requirements (accepts[]) so the caller can decide whether to pay. HTTPS only. No signing performed.

  • check_voucher_statusread-only

    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.

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

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

  • create_loyalty_program

    Get factory calldata to deploy a new loyalty token on Base. Defaults to B20 (Base native ERC-20 superset, 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.

  • create_personalized_offer

    Create a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments).

  • create_reward

    Create a new reward redeemable with loyalty tokens

  • delete_reportcan change or delete data

    Internal. Delete a report you submitted.

  • earn_points

    Calculate and mint loyalty tokens based on purchase amount and program's cashback rate. Returns a fee-first `calls[]` bundle (protocol fee mint first, then the customer mint) — submit in order, atomically via EIP-5792 if supported, then call confirm_mint_fee (or POST /agent-api/mint/confirm) with obligation_id, fee_tx_hash, and recipient_tx_hash. Unconfirmed fee obligations block future mints.

  • export_customersread-only

    Export customer data for a specific loyalty program. Returns wallet addresses, voucher stats, balances, and tier info. Use for analytics, segmentation, and personalized offers.

  • generate_program_defaultsread-only

    Workflow planner: field catalog, required parameters, next_actions, and non-binding examples. External agents must choose their own name, symbol, and economics.

Show 27 more tools
  • get_my_profileread-only

    Get authenticated agent's profile

  • get_platform_inforead-only

    Get info about Loyal Spark protocol on Base L2

  • get_program_analyticsread-only

    Get analytics for one of your loyalty programs

  • get_program_workflow_statusread-only

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

  • get_token_balanceread-only

    Get loyalty token balance and tier info for a customer

  • list_fee_obligationsread-only

    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.

  • list_gift_certificatesread-only

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

  • list_loyalty_programsread-only

    List loyalty programs owned by the agent's merchant

  • list_marketplace_offersread-only

    List active token trading offers on the marketplace

  • list_mintsread-only

    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 stays 0 until confirm.

  • list_my_reportsread-only

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

  • list_rewardsread-only

    List rewards for a loyalty program by token_address. Includes redemption metrics (total vouchers issued, redeemed, and last-30-day counts) for each reward.

  • list_store_discount_codesread-only

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

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

  • mint_loyalty_tokens

    Record mint intent and get a fee-first `calls[]` bundle: protocol fee mint FIRST, then the recipient mint. The protocol fee is charged in the merchant's own loyalty tokens (not USDC). Submit both calls in order (atomically via EIP-5792 send_calls if your wallet supports it), then call confirm_mint_fee (or POST /agent-api/mint/confirm) with obligation_id, fee_tx_hash, and recipient_tx_hash. Unconfirmed fee obligations block future mints. Prefer recipient_address (same as REST POST /agent-api/mint); `recipient` is a legacy alias.

  • redeem_reward

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

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

  • revoke_gift_certificatecan change or delete data

    Revoke an active gift certificate (status active -> revoked). Only the issuing merchant can revoke. Already-redeemed/minted certificates cannot be revoked.

  • send_report

    Internal. Send a report to the merchant's Agent Reports dashboard (SEO audits, growth ideas, anomalies, weekly summaries). Not a loyalty action.

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

  • transfer_loyalty_tokens

    Get calldata to transfer loyalty tokens between wallets

  • update_program_config

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

  • update_program_status

    Update program status in database after onchain activation/pause

  • update_report_status

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

  • update_reward_status

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

  • update_store_discount_codecan change or delete data

    Mark a Shopify discount code used, or cancel it and return the loyalty points. Same actions as the merchant discount-code journal.

  • use_vouchercan change or delete data

    Mark a voucher as used at the merchant. Send one of voucher_code or voucher_id (anyOf). If neither is sent the tool returns error_code missing_identifier and an example.

Signals

Last release
Oct 11, 2026 (17 days ago)

Details

Registry name
io.github.aspekt19/loyal-spark
Version
1.0.4
Auth
API key, Bearer token
License
License unknown
Website
loyalspark.online/for-agents
First seen
Oct 24, 2026
Last checked
Oct 25, 2026
Source
Official MCP Registry
Cite this page

Loyal Spark MCP server. Agent Mart. https://agentmart.dev/connectors/aspekt19-loyal-spark (last updated 2026-10-25)