Loyal Spark Holder MCP
An MCP server for loyalty program recipients on Base, enabling agents to hold, spend, and transfer loyalty tokens. It supports checking balances, redeeming rewards, managing vouchers, and creating peer-to-peer offers. Access requires an rwk_ key obtained via SIWE or pay-per-call x402.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://api.loyalspark.online/recipient-loyalty-mcpWhat its tools do
20 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (12)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Uptime 100% over 90 days
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Check loyalty token balances
- Redeem rewards and vouchers
- Create P2P token offers
- Transfer loyalty tokens
Source and maintenance
Protocol and capabilities
- Server
- loyal-spark-recipient-mcp 1.0.0
- MCP protocol negotiated in check
- 2025-03-26
- Tools
- 20 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": true
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
20 advertised
get_recipient_profile — Get Recipient Profile
Recipient agent profile bound to rwk_ API key: wallet address, key scopes, and registration metadata.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_my_loyalty_balances — List My Loyalty Balances
All loyalty token balances and tier levels for the holder wallet linked to this rwk_ key.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_my_loyalty_balance — Get My Loyalty Balance
Balance and tier for one loyalty program token held by the authenticated recipient wallet.
{
"type": "object",
"required": [
"token_address"
],
"properties": {
"token_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Loyalty program B20/ERC-20 contract on Base."
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}prepare_loyalty_token_transfer — Prepare Loyalty Token Transfer
Build B20/ERC-20 transfer calldata for the holder wallet to send loyalty tokens to any address (submit tx locally).
{
"type": "object",
"anyOf": [
{
"required": [
"to"
]
},
{
"required": [
"to_address"
]
}
],
"required": [
"token_address",
"amount"
],
"properties": {
"to": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Recipient wallet address."
},
"amount": {
"type": "number",
"description": "Whole-token amount to transfer."
},
"to_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Alias for to (same as REST to_address)."
},
"token_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Loyalty program token contract."
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}list_rewards_for_program — List Rewards For Program
List active rewards you can redeem for a program where your wallet has loyalty activity or balance.
{
"type": "object",
"required": [
"token_address"
],
"properties": {
"token_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Loyalty program token contract."
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}list_my_vouchers — List My Vouchers
List vouchers issued to your wallet (active, used, expired) across enrolled loyalty programs.
{
"type": "object",
"properties": {}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}redeem_my_reward — Redeem My Reward
Redeem a reward into an active voucher after paying the token cost on-chain (requires transfer tx hash).
{
"type": "object",
"required": [
"reward_id",
"transaction_hash"
],
"properties": {
"reward_id": {
"type": "string",
"format": "uuid",
"description": "Reward UUID from list_rewards_for_program."
},
"transaction_hash": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{64}$",
"description": "On-chain transfer tx paying the reward token cost."
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}list_p2p_offers — List P2P Offers
List open peer-to-peer token swap offers; optional filter by loyalty token (same price band as merchant GET /offers).
{
"type": "object",
"properties": {
"token_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Optional filter: offers involving this token."
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}create_p2p_offer — Create P2P Offer
Create a P2P swap intent: offer loyalty tokens in exchange for another B20/ERC-20 token amount.
{
"type": "object",
"required": [
"offer_token_address",
"offer_amount",
"request_token_address",
"request_amount"
],
"properties": {
"offer_amount": {
"type": "number",
"description": "Amount of offer token (whole units)."
},
"request_amount": {
"type": "number",
"description": "Amount of request token (whole units)."
},
"offer_token_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Token you are offering."
},
"request_token_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Token you want in return."
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}accept_p2p_offer — Accept P2P Offer
Accept another holder's P2P offer and record the match in Loyal Spark.
{
"type": "object",
"required": [
"offer_id"
],
"properties": {
"offer_id": {
"type": "string",
"format": "uuid",
"description": "P2P offer UUID from list_p2p_offers."
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}cancel_p2p_offer — Cancel P2P Offer
Cancel a P2P offer you created before it is accepted.
{
"type": "object",
"required": [
"offer_id"
],
"properties": {
"offer_id": {
"type": "string",
"format": "uuid",
"description": "P2P offer UUID to cancel."
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": true
}lookup_gift_certificate — Lookup Gift Certificate
Preview a gift certificate by LOYAL-XXXXXX code without claiming (face value, expiry, program).
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "Gift certificate code (LOYAL-XXXX-XXXX)."
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}claim_gift_certificate — Claim Gift Certificate
Claim an active gift certificate; binds it to your wallet (status active -> pending_mint).
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "Gift certificate code to claim."
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}list_my_gift_certificates — List My Gift Certificates
List gift certificates claimed by your wallet with optional status filter.
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Max rows to return (default 50)."
},
"status": {
"enum": [
"active",
"pending_mint",
"redeemed",
"revoked",
"expired"
],
"type": "string",
"description": "Filter by certificate lifecycle status."
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_reward_workflow_status — Get Reward Workflow Status
Autonomous status planner for recipients: returns current reward redemption step and machine-readable next_actions[] (check balance -> prepare transfer -> redeem -> voucher).
{
"type": "object",
"required": [
"token_address"
],
"properties": {
"reward_id": {
"type": "string",
"format": "uuid",
"description": "Optional specific reward UUID to focus the plan on."
},
"token_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Loyalty program token contract."
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}prepare_reward_redemption — Prepare Reward Redemption
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.
{
"type": "object",
"required": [
"reward_id"
],
"properties": {
"reward_id": {
"type": "string",
"format": "uuid",
"description": "Reward UUID from list_rewards_for_program."
}
}
}{
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}bazaar_discover_resources — Bazaar Discover Resources
Discover third-party x402-paid resources in Coinbase CDP's Bazaar registry. Read-only.
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Free-text filter"
},
"limit": {
"type": "number",
"description": "Max rows (default 25, max 100)"
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous discover_resources response"
},
"network": {
"type": "string",
"description": "e.g. 'base'"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}bazaar_discover_mcp_servers — 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.
{
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Search text, e.g. 'weather' or 'loyalty'"
},
"limit": {
"type": "number",
"description": "Max rows (default 20, max 20)"
},
"cursor": {
"type": "string",
"description": "Ignored: CDP search has no cursor. Narrow with q/network."
},
"network": {
"type": "string",
"description": "Network: 'base', 'base-sepolia', or CAIP-2 like 'eip155:8453'"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}bazaar_probe_x402 — Bazaar Probe x402
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.
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "https endpoint to probe"
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}bazaar_pay_and_call — Bazaar Pay And Call
Pay an x402-protected endpoint with USDC on Base and return its response.
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "https x402 endpoint"
},
"body": {
"type": "object",
"description": "Optional JSON body"
},
"method": {
"type": "string",
"description": "HTTP method (default GET)"
},
"max_usdc": {
"type": "number",
"description": "Spend cap in USDC"
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-19: 4 of 4 checks answered
- 2026-11-20: 3 of 3 checks answered
- 2026-11-21: 4 of 4 checks answered
- 2026-11-22: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1156 ms
- 95th percentile latency
- 1156 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1156 ms · metadata changed · 20 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http loyal-spark-holder-mcp https://api.loyalspark.online/recipient-loyalty-mcpCodex
codex mcp add loyal-spark-holder-mcp --url https://api.loyalspark.online/recipient-loyalty-mcpCursor
{
"mcpServers": {
"loyal-spark-holder-mcp": {
"url": "https://api.loyalspark.online/recipient-loyalty-mcp"
}
}
}Cline
{
"mcpServers": {
"loyal-spark-holder-mcp": {
"type": "streamableHttp",
"url": "https://api.loyalspark.online/recipient-loyalty-mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"loyal-spark-holder-mcp": {
"type": "http",
"url": "https://api.loyalspark.online/recipient-loyalty-mcp"
}
}
}Gemini CLI
gemini mcp add --transport http loyal-spark-holder-mcp https://api.loyalspark.online/recipient-loyalty-mcpClaude Desktop
https://api.loyalspark.online/recipient-loyalty-mcpWindsurf
{
"mcpServers": {
"loyal-spark-holder-mcp": {
"serverUrl": "https://api.loyalspark.online/recipient-loyalty-mcp"
}
}
}Let your agent find its tools
Find servers like Loyal Spark Holder MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.