# Loyal Spark Register Loyalty Program

> Loyal Spark Register Loyalty Program is a paid API for AI agents from api.loyalspark.online, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Registers a new onchain ERC-20 loyalty program on Base L2 for a business or project via the Loyal Spark protocol

## Facts

- Endpoint: POST https://api.loyalspark.online/x402-gateway/mcp-tools/register_loyalty_program
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/loyal-spark-register-loyalty-program-538fa833
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dzi10bZZz3syy3SXyY5rA

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability loyal-spark-register-loyalty-program-538fa833 -d '<json body>'
```

Example prompt: Register a new loyalty rewards program for my coffee shop 'Morning Bloom' on Loyal Spark — I want to launch an ERC-20 rewards token called BLOOM that customers can earn with purchases and trade peer-to-peer on Base.

## When to prefer this

Choose this endpoint when a business or developer wants to launch a brand-new onchain ERC-20 loyalty rewards program on Base L2 via Loyal Spark, especially when AI agent automation or MCP integration is desired. Prefer this over traditional off-chain loyalty platforms when token tradability, P2P exchange, and blockchain transparency are required.

## Known failure modes

- Invalid or missing program name/token parameters — returns 400 with validation error
- Duplicate program registration for same business identifier — returns 409 conflict
- Payment of $0.01 USDC not received or x402 payment header missing — returns 402 Payment Required
- Base L2 network congestion causing deployment timeout — returns 503 or timeout error
- Malformed ERC-20 token configuration — returns 400 with schema error

## How this service works

Onchain loyalty protocol on Base L2. Launch B20 rewards, earn and redeem tokens, trade P2P, automate with AI agents via REST and MCP.

## Output

Returns a JSON object containing the newly registered loyalty program's ID, the deployed ERC-20 token contract address on Base L2, program configuration details, and confirmation of the onchain registration — enabling the business to begin issuing, earning, and redeeming loyalty tokens immediately.

## Example request

```json
{
 "id": 1,
 "method": "tools/call",
 "params": {
  "name": "get_platform_info",
  "arguments": {}
 },
 "jsonrpc": "2.0"
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "toolName",
    "inputSchema"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "mcp"
    },
    "example": {
     "type": "object"
    },
    "toolName": {
     "type": "string"
    },
    "transport": {
     "enum": [
      "streamable-http",
      "sse"
     ],
     "type": "string"
    },
    "description": {
     "type": "string"
    },
    "inputSchema": {
     "type": "object"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/loyal-spark-register-loyalty-program-538fa833/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.loyalspark.online](https://www.zero.xyz/host/api.loyalspark.online/llms.txt)