Koskamo

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.

Loyal Spark Holder MCP logo, by Loyal SparkCommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-18Published by Loyal Spark
You need:Holder rwk_ key (200 calls/month free per holder wallet, then per-call x402 or Pro/Enterprise)
MCP endpoint (Streamable HTTP)
https://api.loyalspark.online/recipient-loyalty-mcp
Vendor documentation

What its tools do

20 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

20 of 20 have a description · 20 of 20 declare behavior hints · 17 of 17 with parameters document them all

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

Community listingRegistry 1.0.0

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
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

Loyal Spark holder MCP on Base (chain 8453). Start keyless: call tools/list. Get a free rwk_ key via POST https://api.loyalspark.online/siwe-nonce then POST https://api.loyalspark.online/recipient-api/register (SIWE, chain 8453), or pay per call via x402 at https://api.loyalspark.online/x402-gateway/recipient-mcp-tools/<tool>. Send header x-api-key: rwk_... for wallet-scoped tools. Docs: https://loyalspark.online/llms.txt · OpenAPI: https://api.loyalspark.online/openapi.json · Onboarding: https://loyalspark.online/for-agents

Tools

20 advertised

get_recipient_profile — Get Recipient Profile
Advertised by the server during the last successful anonymous check.
Advertised read-only

Recipient agent profile bound to rwk_ API key: wallet address, key scopes, and registration metadata.

get_recipient_profile input schema
{
  "type": "object",
  "properties": {}
}
get_recipient_profile annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_my_loyalty_balances — List My Loyalty Balances
Advertised by the server during the last successful anonymous check.
Advertised read-only

All loyalty token balances and tier levels for the holder wallet linked to this rwk_ key.

list_my_loyalty_balances input schema
{
  "type": "object",
  "properties": {}
}
list_my_loyalty_balances annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_my_loyalty_balance — Get My Loyalty Balance
Advertised by the server during the last successful anonymous check.
Advertised read-only

Balance and tier for one loyalty program token held by the authenticated recipient wallet.

get_my_loyalty_balance input schema
{
  "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."
    }
  }
}
get_my_loyalty_balance annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
prepare_loyalty_token_transfer — Prepare Loyalty Token Transfer
Advertised by the server during the last successful anonymous check.

Build B20/ERC-20 transfer calldata for the holder wallet to send loyalty tokens to any address (submit tx locally).

prepare_loyalty_token_transfer input schema
{
  "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."
    }
  }
}
prepare_loyalty_token_transfer annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
list_rewards_for_program — List Rewards For Program
Advertised by the server during the last successful anonymous check.
Advertised read-only

List active rewards you can redeem for a program where your wallet has loyalty activity or balance.

list_rewards_for_program input schema
{
  "type": "object",
  "required": [
    "token_address"
  ],
  "properties": {
    "token_address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Loyalty program token contract."
    }
  }
}
list_rewards_for_program annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_my_vouchers — List My Vouchers
Advertised by the server during the last successful anonymous check.
Advertised read-only

List vouchers issued to your wallet (active, used, expired) across enrolled loyalty programs.

list_my_vouchers input schema
{
  "type": "object",
  "properties": {}
}
list_my_vouchers annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
redeem_my_reward — Redeem My Reward
Advertised by the server during the last successful anonymous check.

Redeem a reward into an active voucher after paying the token cost on-chain (requires transfer tx hash).

redeem_my_reward input schema
{
  "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."
    }
  }
}
redeem_my_reward annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
list_p2p_offers — List P2P Offers
Advertised by the server during the last successful anonymous check.
Advertised read-only

List open peer-to-peer token swap offers; optional filter by loyalty token (same price band as merchant GET /offers).

list_p2p_offers input schema
{
  "type": "object",
  "properties": {
    "token_address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Optional filter: offers involving this token."
    }
  }
}
list_p2p_offers annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
create_p2p_offer — Create P2P Offer
Advertised by the server during the last successful anonymous check.

Create a P2P swap intent: offer loyalty tokens in exchange for another B20/ERC-20 token amount.

create_p2p_offer input schema
{
  "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."
    }
  }
}
create_p2p_offer annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
accept_p2p_offer — Accept P2P Offer
Advertised by the server during the last successful anonymous check.

Accept another holder's P2P offer and record the match in Loyal Spark.

accept_p2p_offer input schema
{
  "type": "object",
  "required": [
    "offer_id"
  ],
  "properties": {
    "offer_id": {
      "type": "string",
      "format": "uuid",
      "description": "P2P offer UUID from list_p2p_offers."
    }
  }
}
accept_p2p_offer annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
cancel_p2p_offer — Cancel P2P Offer
Advertised by the server during the last successful anonymous check.
Advertised destructive

Cancel a P2P offer you created before it is accepted.

cancel_p2p_offer input schema
{
  "type": "object",
  "required": [
    "offer_id"
  ],
  "properties": {
    "offer_id": {
      "type": "string",
      "format": "uuid",
      "description": "P2P offer UUID to cancel."
    }
  }
}
cancel_p2p_offer annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": true
}
lookup_gift_certificate — Lookup Gift Certificate
Advertised by the server during the last successful anonymous check.
Advertised read-only

Preview a gift certificate by LOYAL-XXXXXX code without claiming (face value, expiry, program).

lookup_gift_certificate input schema
{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "Gift certificate code (LOYAL-XXXX-XXXX)."
    }
  }
}
lookup_gift_certificate annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
claim_gift_certificate — Claim Gift Certificate
Advertised by the server during the last successful anonymous check.

Claim an active gift certificate; binds it to your wallet (status active -> pending_mint).

claim_gift_certificate input schema
{
  "type": "object",
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "Gift certificate code to claim."
    }
  }
}
claim_gift_certificate annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
list_my_gift_certificates — List My Gift Certificates
Advertised by the server during the last successful anonymous check.
Advertised read-only

List gift certificates claimed by your wallet with optional status filter.

list_my_gift_certificates input schema
{
  "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."
    }
  }
}
list_my_gift_certificates annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_reward_workflow_status — Get Reward Workflow Status
Advertised by the server during the last successful anonymous check.
Advertised read-only

Autonomous status planner for recipients: returns current reward redemption step and machine-readable next_actions[] (check balance -> prepare transfer -> redeem -> voucher).

get_reward_workflow_status input schema
{
  "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."
    }
  }
}
get_reward_workflow_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
prepare_reward_redemption — Prepare Reward Redemption
Advertised by the server during the last successful anonymous check.

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.

prepare_reward_redemption input schema
{
  "type": "object",
  "required": [
    "reward_id"
  ],
  "properties": {
    "reward_id": {
      "type": "string",
      "format": "uuid",
      "description": "Reward UUID from list_rewards_for_program."
    }
  }
}
prepare_reward_redemption annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
bazaar_discover_resources — Bazaar Discover Resources
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Discover third-party x402-paid resources in Coinbase CDP's Bazaar registry. Read-only.

bazaar_discover_resources input schema
{
  "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'"
    }
  }
}
bazaar_discover_resources annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
bazaar_discover_mcp_servers — Bazaar Discover MCP Servers
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_mcp_servers input schema
{
  "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'"
    }
  }
}
bazaar_discover_mcp_servers annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
bazaar_probe_x402 — Bazaar Probe x402
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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_probe_x402 input schema
{
  "type": "object",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "https endpoint to probe"
    }
  }
}
bazaar_probe_x402 annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
bazaar_pay_and_call — Bazaar Pay And Call
Advertised by the server during the last successful anonymous check.
Open-world

Pay an x402-protected endpoint with USDC on Base and return its response.

bazaar_pay_and_call input schema
{
  "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"
    }
  }
}
bazaar_pay_and_call annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

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.

100% (12 of 12 checks answered)

  1. 2026-11-19: 4 of 4 checks answered
  2. 2026-11-20: 3 of 3 checks answered
  3. 2026-11-21: 4 of 4 checks answered
  4. 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.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http loyal-spark-holder-mcp https://api.loyalspark.online/recipient-loyalty-mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add loyal-spark-holder-mcp --url https://api.loyalspark.online/recipient-loyalty-mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable loyal-spark-holder-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "loyal-spark-holder-mcp": {
      "url": "https://api.loyalspark.online/recipient-loyalty-mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "loyal-spark-holder-mcp": {
      "type": "streamableHttp",
      "url": "https://api.loyalspark.online/recipient-loyalty-mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start loyal-spark-holder-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "loyal-spark-holder-mcp": {
      "type": "http",
      "url": "https://api.loyalspark.online/recipient-loyalty-mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http loyal-spark-holder-mcp https://api.loyalspark.online/recipient-loyalty-mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://api.loyalspark.online/recipient-loyalty-mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "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.