eCommerce
loyalspark.online
Manage loyalty programs and merchant workflows on the Loyal Spark protocol.
ENDPOINT 1
https://api.loyalspark.online/loyalty-mcp
MCP server metadata
- Name
- loyal-spark-mcp
- Version
- 1.0.0
Known tools 39
generate_program_defaultsWorkflow planner: field catalog, required parameters, next_actions, and non-binding examples.
Inferred read-onlyget_program_workflow_statusExplain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values)
Inferred read-onlyregister_loyalty_programRegister a deployed token as a loyalty program in the database.
Inferred read-onlyactivate_loyalty_programFor legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata.
Inferred read-onlyupdate_program_statusUpdate program status in database after onchain activation/pause
Potential side effectsupdate_program_configUpdate default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders)
Potential side effectsmint_loyalty_tokensRecord mint intent and get a fee-first `calls[]` bundle: protocol fee mint FIRST, then the recipient mint.
Inferred read-onlytransfer_loyalty_tokensGet calldata to transfer loyalty tokens between wallets
Potential side effectsearn_pointsCalculate and mint loyalty tokens based on purchase amount and program's cashback rate.
Potential side effectsconfirm_mint_feeConfirm that the protocol fee transaction for a previous mint/earn was broadcast on Base.
Inferred read-onlyredeem_rewardRedeem a reward by providing a verified token transfer transaction hash.
Potential side effectscancel_stale_offersCancel marketplace offers that have been active for more than N days with no completions.
Inferred read-onlycreate_gift_certificateCreate a gift / welcome certificate (UDS-style) with a unique 6-character redemption code (LOYAL-XXXXXX).
Potential side effectslist_gift_certificatesList gift certificates issued by the agent's merchant (with status and redemption info).
Inferred read-onlyrevoke_gift_certificateRevoke an active gift certificate (status active → revoked).
Inferred read-onlymark_gift_certificate_mintedAfter 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.
Inferred read-onlybazaar_discover_resourcesDiscover third-party x402-paid resources published in Coinbase CDP's Bazaar (docs, data feeds, AI inference, etc).
Inferred read-onlybazaar_discover_mcp_serversDiscover third-party MCP servers published in Coinbase CDP's Bazaar.
Inferred read-onlybazaar_probe_x402GET a candidate x402 URL and, if it responds HTTP 402, return the parsed payment requirements (accepts[]) so the caller can decide whether to pay.
Potential side effectsbazaar_pay_and_callPay and call any x402-paid HTTPS endpoint using the merchant agent's CDP MPC wallet (EIP-3009 exact scheme on Base USDC).
Potential side effectsCONNECT WITH APPROVAL
Client installation
Review this server and its permissions before adding it. Secret placeholders must be set locally.
Codex
~/.codex/config.toml
[mcp_servers.loyal-spark-mcp]
url = "https://api.loyalspark.online/loyalty-mcp"
enabled = true
Claude Code
.mcp.json
{
"mcpServers": {
"loyal-spark-mcp": {
"type": "http",
"url": "https://api.loyalspark.online/loyalty-mcp"
}
}
}
Claude Desktop
Settings → Connectors → Add custom connector
Name: loyal-spark-mcp
Remote MCP URL: https://api.loyalspark.online/loyalty-mcp
Add this remote URL as a custom connector in Claude Desktop. Availability depends on the user plan and workspace policy.
Cursor
.cursor/mcp.json
{
"mcpServers": {
"loyal-spark-mcp": {
"url": "https://api.loyalspark.online/loyalty-mcp"
}
}
}
Visual Studio Code
.vscode/mcp.json
Add to Visual Studio Code{
"servers": {
"loyal-spark-mcp": {
"type": "http",
"url": "https://api.loyalspark.online/loyalty-mcp"
}
}
}
Generic MCP
Client-specific MCP configuration
{
"name": "loyal-spark-mcp",
"transport": "streamable-http",
"url": "https://api.loyalspark.online/loyalty-mcp"
}
MCP Inspector
Run the official MCP Inspector locally and enter the indexed Streamable HTTP endpoint.
TRUST AND VERIFICATION EVIDENCE
Loading Trust v2 evidence…
Checking the associated registrable domain. The BuiltWith key remains server-side.
Evidence is source-attributed and does not guarantee that a third-party server is safe. Risk labels are conservative metadata heuristics.