Loyal Spark MCP Server

by aspekt19 Your server? Claim it

answering

Loyal Spark is answering right now. Last checked 9 min ago. It exposes 42 tools. Last commit 11 Oct 2026.

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

Uptime history 91 days of history · worst day 95%

91 days agonow

100.0%

Uptime 24h

91 of 91 checks

Tools

read from the server

783 ms

Response time

average over 24h

Stars

last commit 11 Oct 2026

What changed 57

Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 1 October 2026. No other catalogue keeps this.

2 Nov 3 tool descriptions were rewritten earn_points, mint_loyalty_tokens, use_voucher

2 Nov 2 tools changed the parameters they ask for confirm_mint_fee, use_voucher

1 Nov 4 tool descriptions were rewritten export_customers, get_program_analytics, list_mints and 1 more

1 Nov 2 tools changed the parameters they ask for send_report, transfer_loyalty_tokens

30 Oct 2 tool descriptions were rewritten3 times that day bazaar_discover_mcp_servers, bazaar_probe_x402

30 Oct a tool changed the parameters it asks for bazaar_discover_mcp_servers

28 Oct a tool description was rewritten earn_points

28 Oct a tool changed the parameters it asks for earn_points

27 Oct 2 tool descriptions were rewritten get_token_balance, mint_loyalty_tokens

27 Oct 2 tools changed the parameters they ask for get_token_balance, mint_loyalty_tokens

and 37 more, back to 1 October 2026

Tools have disappeared from this server

A tool that vanishes takes a piece of your agent with it, and the change arrives silently. Watch this server and every such change lands in your inbox.

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 9 min ago.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

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

Settings → Connectors → Add custom connector, then paste this address

https://api.loyalspark.online/loyalty-mcp

~/.codex/config.toml

[mcp_servers.loyal-spark]
url = "https://api.loyalspark.online/loyalty-mcp"

.cursor/mcp.json

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

.vscode/mcp.json

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

Available tools 42

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

bazaar

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.

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

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

program

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.

get_program_workflow_status

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

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

store

list_store_discount_codes

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

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

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.

gift

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.

list_gift_certificates

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

loyalty

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.

list_loyalty_programs

List loyalty programs owned by the agent's merchant

report

delete_report

Internal. Delete a report you submitted.

update_report_status

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

reward

create_reward

Create a new reward redeemable with loyalty tokens

update_reward_status

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

activate

activate_loyalty_program

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

confirm

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.

earn

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.

export

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.

fee

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.

generate

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.

mark

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.

marketplace

list_marketplace_offers

List active token trading offers on the marketplace

mint

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.

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.

personalized

create_personalized_offer

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

platform

get_platform_info

Get info about Loyal Spark protocol on Base L2

profile

get_my_profile

Get authenticated agent's profile

redeem

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

reports

list_my_reports

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

revoke

revoke_gift_certificate

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

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.

send

send_report

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

token

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)

transfer

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

use

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

voucher

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.

Tools removed

Tools this server used to expose. Anything built against them stopped working on the day they went.

cancel_stale_offers

removed 22 Oct 2026

get_platform_stats

removed 22 Oct 2026

Endpoints

URL	Transport	State	Latency	Checked
https://api.loyalspark.online/loyalty-mcp	streamable-http	answering	729 ms	9 min ago

Alternatives to Loyal Spark

same job, measured the same way

SIGNALS Loyalty Agent Platform

by signals

63 MCP tools for loyalty programs, rewards, and member operations with HITL approval.

answering

Money Reactor

by makar-aibot

Pay-per-call x402 MCP for AI agents: 35 tools, USDC on Base, from $0.001/call, no API keys.

35 tools answering

Nervous System

by levelsofself

Governance for LLM agents: 7 enforced rules + read-only reference tools. Safe in any MCP client.

75 installs/wk local only

Logicnodes MCP

by cmdenney

Remote MCP for LogicNodes: Signed PII-Shield flagship + payable x402 agent tools on Base.

2 tools answering

pilotfish (local)

by gai-ventures

A real Chromium on your machine for any MCP agent: ref-based tools, evidence per action, no API key.

local only

Marketo

by zleventer

MCP server for Marketo — 32 tools for leads, programs, emails, forms, lists, and bulk export.

42 installs/wk local only

Tollbooth

by huwhitememes

37 paid x402 MCP tools for OSINT, prediction markets, web intel, and agent security on Base USDC.

120 tools answering

Hive Doctrine MCP

by mizukaizen

Agent knowledge marketplace. 105 products, 6 MCP tools, x402 payments on Base network.

44 installs/wk local only

Loyal Spark — questions

Answers built from our own checks of this server.

What can Loyal Spark do?

It exposes 42 tools, read directly from the server on our last check. Among them: activate_loyalty_program, bazaar_discover_mcp_servers, bazaar_discover_resources, bazaar_pay_and_call, bazaar_probe_x402, check_voucher_status and 36 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →

What is Loyal Spark mostly used for?

Its tools cluster around program, bazaar and store. That is what this server is built to work with — the grouping comes from the actual tool names, not from a category we assigned.

Is Loyal Spark working right now?

We send a real MCP handshake every 15 minutes. Over the last 24 hours 91 of 91 checks got a reply (100.0%), average response time 783 ms. The bar chart above shows every period we have measured.

Did Loyal Spark ever remove tools?

Yes. cancel_stale_offers, get_platform_stats are no longer exposed — we recorded the date each one disappeared. A tool vanishing usually means a breaking change for anything that depended on it.

How do I connect Loyal Spark?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.

Does Loyal Spark need an API key?

No. Loyal Spark completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 42 of them are readable on this page. This is what we observed, not what the docs claim.

How fast is Loyal Spark?

It answers our handshake in 783 ms on average, which is faster than 9% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. The comparison comes from our own checks across the whole registry, every 15 minutes.

Is Loyal Spark open source?

The code is open source: it is published under the MIT licence, written in TypeScript and 1 stars on GitHub. The licence covers the code in the repository, not the hosted service at api.loyalspark.online, which runs on its operator's own terms.