# Loyal Spark Holder

> Loyal Spark Holder is an MCP server for crypto and web3. MCP server for checking Base loyalty balances, rewards, vouchers and P2P offers. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** API
- **Website:** https://loyalspark.online/for-agents
- **MCP Registry name:** io.github.aspekt19/loyal-spark-recipient
- **Categories:** [crypto and web3](https://ai-powered.com/categories/crypto-and-web3)
- **Listing updated:** 2026-11-19

## About

The Loyal Spark recipient MCP server lets AI clients work with loyalty holdings on the Base L2 network. According to its registry entry, it covers balances, rewards, vouchers and peer-to-peer offers for loyalty holders.

The server is reached over streamable HTTP at a hosted endpoint. The registry entry says callers can authenticate either with x402 pay-per-call payments or with an rwk_ key. The vendor's page describes the wider protocol, which includes launching B20 rewards, earning and redeeming tokens, and trading peer-to-peer, with agent automation available through REST and MCP.

It suits developers and operators who want an AI agent to read or act on a Base-based loyalty program without building their own integration. The exact list of callable tools is not published in the material available here.

## Features

- **Loyalty balance lookup:** Reads loyalty holder balances on Base through the MCP endpoint.
- **Rewards and vouchers:** Exposes rewards and vouchers for loyalty holders to AI clients.
- **Peer-to-peer offers:** Covers P2P offers between loyalty holders.
- **Pay-per-call access:** Supports x402 pay-per-call payment as an access option.
- **Key-based access:** Supports access with an rwk_ key as an alternative to pay-per-call.
- **Streamable HTTP transport:** Runs as a remote server over streamable HTTP with no local package.

## Good for

- Let an AI assistant check a Base loyalty balance before recommending a redemption
- Automate voucher lookups for loyalty program holders
- Surface open peer-to-peer loyalty offers inside an agent workflow
- Pay per call for occasional loyalty queries without a subscription

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.loyalspark.online/recipient-loyalty-mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "loyal-spark-recipient": {
      "serverUrl": "https://api.loyalspark.online/recipient-loyalty-mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://api.loyalspark.online/recipient-loyalty-mcp
```

Enter a Name (for example "Loyal Spark Holder"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

12 of 20 tools say they're read-only. 8 of 20 tools say they can delete or change data. From the server's own tool annotations; not verified by us.

- `get_recipient_profile` (says read-only): Recipient agent profile bound to rwk_ API key: wallet address, key scopes, and registration metadata.
- `list_my_loyalty_balances` (says read-only): All loyalty token balances and tier levels for the holder wallet linked to this rwk_ key.
- `get_my_loyalty_balance` (says read-only): Balance and tier for one loyalty program token held by the authenticated recipient wallet.
- `prepare_loyalty_token_transfer` (says it can change data): Build B20/ERC-20 transfer calldata for the holder wallet to send loyalty tokens to any address (submit tx locally).
- `list_rewards_for_program` (says read-only): List active rewards you can redeem for a program where your wallet has loyalty activity or balance.
- `list_my_vouchers` (says read-only): List vouchers issued to your wallet (active, used, expired) across enrolled loyalty programs.
- `redeem_my_reward` (says it can change data): Redeem a reward into an active voucher after paying the token cost on-chain (requires transfer tx hash).
- `list_p2p_offers` (says read-only): List open peer-to-peer token swap offers; optional filter by loyalty token (same price band as merchant GET /offers).
- `create_p2p_offer` (says it can change data): Create a P2P swap intent: offer loyalty tokens in exchange for another B20/ERC-20 token amount.
- `accept_p2p_offer` (says it can change data): Accept another holder's P2P offer and record the match in Loyal Spark.
- `cancel_p2p_offer` (says it can change data): Cancel a P2P offer you created before it is accepted.
- `lookup_gift_certificate` (says read-only): Preview a gift certificate by LOYAL-XXXXXX code without claiming (face value, expiry, program).
- `claim_gift_certificate` (says it can change data): Claim an active gift certificate; binds it to your wallet (status active -> pending_mint).
- `list_my_gift_certificates` (says read-only): List gift certificates claimed by your wallet with optional status filter.
- `get_reward_workflow_status` (says read-only): Autonomous status planner for recipients: returns current reward redemption step and machine-readable next_actions[] (check balance -> prepare transfer -> redeem -> voucher).
- `prepare_reward_redemption` (says it can change data): One-shot planner: returns B20/ERC-20 transfer calldata for the reward token cost plus the recipient_reward workflow so the agent can broadcast the tx and then call redeem_my_reward.
- `bazaar_discover_resources` (says read-only): Discover third-party x402-paid resources in Coinbase CDP's Bazaar registry. Read-only.
- `bazaar_discover_mcp_servers` (says read-only): 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_probe_x402` (says read-only): Probe an x402 resource URL for its payment requirements without paying. Non-402 answers return an error, never the body. Read-only. No API key needed: keyless calls are limited to 20/minute per IP; with a key the key's own limits apply.
- `bazaar_pay_and_call` (says it can change data): Pay an x402-protected endpoint with USDC on Base and return its response.

## FAQ

### How do I connect to this MCP server?

The registry entry lists a streamable HTTP remote at api.loyalspark.online/recipient-loyalty-mcp.

### How is access paid for?

The registry entry says access is available via x402 pay-per-call or with an rwk_ key.

### Which blockchain does it use?

The registry entry and the vendor page both describe the loyalty holders as being on Base.

### How do I add Loyal Spark Holder to Claude Code?

Run this command in your terminal: claude mcp add --transport http loyal-spark-recipient https://api.loyalspark.online/recipient-loyalty-mcp

### What are the best alternatives to Loyal Spark Holder?

The closest alternatives to Loyal Spark Holder are WarpPay402 MCP Gateway, Limitless MCP Server, LensExtract x402 On-Chain Data and HOT x402 Quotes.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 19 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [WarpPay402 MCP Gateway](https://ai-powered.com/mcp/warppay402-mcp-gateway): WarpPay402 MCP Gateway is a paid MCP server for web search and scraping.
- [Limitless MCP Server](https://ai-powered.com/mcp/limitless-mcp-server): Limitless MCP Server is an open-source MCP server for crypto and web3.
- [LensExtract x402 On-Chain Data](https://ai-powered.com/mcp/lensextract-x402-on-chain-data): LensExtract x402 On-Chain Data is an open-source MCP server for crypto and web3.
- [HOT x402 Quotes](https://ai-powered.com/mcp/hot-x402-quotes-2): HOT x402 Quotes is an MCP server for crypto and web3.

---
Source: https://ai-powered.com/mcp/loyal-spark-holder
