Loyalty holders on Base: balances, rewards, vouchers, P2P offers. x402 pay-per-call or rwk_ key.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Holder key rwk_... for wallet-scoped tools (tools/list works without it). See https://loyalspark.online/for-agents
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Accept another holder's P2P offer and record the match in Loyal Spark.
P2P offer UUID from list_p2p_offers.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http loyal-spark-recipient https://api.loyalspark.online/recipient-loyalty-mcp
Headers
x-api-key (optional, not in the config above): Holder key rwk_... for wallet-scoped tools (tools/list works without it). See https://loyalspark.online/for-agentsAccept another holder's P2P offer and record the match in Loyal Spark.
| Argument | Type | Description |
|---|---|---|
| offer_id* | string | P2P offer UUID from list_p2p_offers. |
{
"type": "object",
"required": [
"offer_id"
],
"properties": {
"offer_id": {
"type": "string",
"format": "uuid",
"description": "P2P offer UUID from list_p2p_offers."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| q | string | Search text, e.g. 'weather' or 'loyalty' |
| limit | number | Max rows (default 20, max 20) |
| cursor | string | Ignored: CDP search has no cursor. Narrow with q/network. |
| network | string | Network: 'base', 'base-sepolia', or CAIP-2 like 'eip155:8453' |
{
"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'"
}
}
}Discover third-party x402-paid resources in Coinbase CDP's Bazaar registry. Read-only.
| Argument | Type | Description |
|---|---|---|
| q | string | Free-text filter |
| limit | number | Max rows (default 25, max 100) |
| cursor | string | Pagination cursor from a previous discover_resources response |
| network | string | e.g. 'base' |
{
"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'"
}
}
}Pay an x402-protected endpoint with USDC on Base and return its response.
| Argument | Type | Description |
|---|---|---|
| url* | string | https x402 endpoint |
| body | object | Optional JSON body |
| method | string | HTTP method (default GET) |
| max_usdc | number | Spend cap in USDC |
{
"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"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| url* | string | https endpoint to probe |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "https endpoint to probe"
}
}
}Cancel a P2P offer you created before it is accepted.
| Argument | Type | Description |
|---|---|---|
| offer_id* | string | P2P offer UUID to cancel. |
{
"type": "object",
"required": [
"offer_id"
],
"properties": {
"offer_id": {
"type": "string",
"format": "uuid",
"description": "P2P offer UUID to cancel."
}
}
}Claim an active gift certificate; binds it to your wallet (status active -> pending_mint).
| Argument | Type | Description |
|---|---|---|
| code* | string | Gift certificate code to claim. |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "Gift certificate code to claim."
}
}
}Create a P2P swap intent: offer loyalty tokens in exchange for another B20/ERC-20 token amount.
| Argument | Type | Description |
|---|---|---|
| offer_amount* | number | Amount of offer token (whole units). |
| request_amount* | number | Amount of request token (whole units). |
| offer_token_address* | string | Token you are offering. |
| request_token_address* | string | Token you want in return. |
{
"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."
}
}
}Balance and tier for one loyalty program token held by the authenticated recipient wallet.
| Argument | Type | Description |
|---|---|---|
| token_address* | string | Loyalty program B20/ERC-20 contract on Base. |
{
"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."
}
}
}Recipient agent profile bound to rwk_ API key: wallet address, key scopes, and registration metadata.
No arguments.
{
"type": "object",
"properties": {}
}Autonomous status planner for recipients: returns current reward redemption step and machine-readable next_actions[] (check balance -> prepare transfer -> redeem -> voucher).
| Argument | Type | Description |
|---|---|---|
| reward_id | string | Optional specific reward UUID to focus the plan on. |
| token_address* | string | Loyalty program token contract. |
{
"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."
}
}
}List gift certificates claimed by your wallet with optional status filter.
| Argument | Type | Description |
|---|---|---|
| limit | number | Max rows to return (default 50). |
| status | string | Filter by certificate lifecycle status. |
{
"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."
}
}
}All loyalty token balances and tier levels for the holder wallet linked to this rwk_ key.
No arguments.
{
"type": "object",
"properties": {}
}List vouchers issued to your wallet (active, used, expired) across enrolled loyalty programs.
No arguments.
{
"type": "object",
"properties": {}
}List open peer-to-peer token swap offers; optional filter by loyalty token (same price band as merchant GET /offers).
| Argument | Type | Description |
|---|---|---|
| token_address | string | Optional filter: offers involving this token. |
{
"type": "object",
"properties": {
"token_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Optional filter: offers involving this token."
}
}
}List active rewards you can redeem for a program where your wallet has loyalty activity or balance.
| Argument | Type | Description |
|---|---|---|
| token_address* | string | Loyalty program token contract. |
{
"type": "object",
"required": [
"token_address"
],
"properties": {
"token_address": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Loyalty program token contract."
}
}
}Preview a gift certificate by LOYAL-XXXXXX code without claiming (face value, expiry, program).
| Argument | Type | Description |
|---|---|---|
| code* | string | Gift certificate code (LOYAL-XXXX-XXXX). |
{
"type": "object",
"required": [
"code"
],
"properties": {
"code": {
"type": "string",
"description": "Gift certificate code (LOYAL-XXXX-XXXX)."
}
}
}Build B20/ERC-20 transfer calldata for the holder wallet to send loyalty tokens to any address (submit tx locally).
| Argument | Type | Description |
|---|---|---|
| to | string | Recipient wallet address. |
| amount* | number | Whole-token amount to transfer. |
| to_address | string | Alias for to (same as REST to_address). |
| token_address* | string | Loyalty program token contract. |
{
"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."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| reward_id* | string | Reward UUID from list_rewards_for_program. |
{
"type": "object",
"required": [
"reward_id"
],
"properties": {
"reward_id": {
"type": "string",
"format": "uuid",
"description": "Reward UUID from list_rewards_for_program."
}
}
}Redeem a reward into an active voucher after paying the token cost on-chain (requires transfer tx hash).
| Argument | Type | Description |
|---|---|---|
| reward_id* | string | Reward UUID from list_rewards_for_program. |
| transaction_hash* | string | On-chain transfer tx paying the reward token cost. |
{
"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."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.