{
  "name": "Loyal Spark merchant MCP",
  "description": "Merchant loyalty and rewards tools on Base (chain 8453): create B20 loyalty programs, mint loyalty points, manage rewards catalogs and vouchers. The server exposes 43 tools to non-admin keys (45 registered). tools/list hides admin-only get_platform_stats and cancel_stale_offers unless the key owner is a platform admin.",
  "url": "https://api.loyalspark.online/loyalty-mcp",
  "transport": "streamable-http",
  "protocol": "mcp",
  "headers": {
    "Content-Type": "application/json",
    "Accept": "application/json, text/event-stream"
  },
  "auth": {
    "type": "apiKey",
    "header": "x-api-key",
    "prefix": "lsk_",
    "bearer": "Authorization: Bearer lsk_...",
    "free_plan_key": {
      "first": true,
      "method": "POST",
      "url": "https://api.loyalspark.online/x402-gateway/register-agent",
      "price_usdc": "0.01",
      "payment": "x402 v2, USDC on Base, no API key or SIWE needed",
      "plan": "free",
      "scopes": [
        "read",
        "create_program",
        "mint",
        "trade",
        "manage_rewards"
      ],
      "api_calls_monthly": 200,
      "max_mint_amount_monthly": 1000,
      "transaction_fee_percent": 1.25,
      "note": "Full Free-plan lsk_ key with all 5 scopes when the wallet has no Store Plan or Paid Agent Plan (plan-scoped otherwise). api_key is shown once: save it. Lost it? Rotate it free with SIWE (see write_key)."
    },
    "write_key": {
      "method": "SIWE",
      "nonce": "POST https://api.loyalspark.online/siwe-nonce",
      "register": "POST https://api.loyalspark.online/agent-register-siwe",
      "body": [
        "message",
        "signature",
        "agent_name",
        "scopes"
      ],
      "note": "Free. Issues or rotates an lsk_ key once the wallet has a Store Plan, a Paid Agent Plan, or a registered agent (for example after the $0.01 free_plan_key route). Same wallet and name rotates and recovers the key.",
      "docs": "https://loyalspark.online/.well-known/skills/00-getting-started.md",
      "body_aliases": {
        "name": "agent_name"
      }
    },
    "read_only_option": {
      "deprecated": true,
      "alias_of": "free_plan_key",
      "method": "POST",
      "url": "https://api.loyalspark.online/x402-gateway/register-agent",
      "price_usdc": "0.01",
      "scopes": [
        "read",
        "create_program",
        "mint",
        "trade",
        "manage_rewards"
      ],
      "note": "Deprecated name. This route issues the full Free plan (all 5 scopes, 200 calls/mo), not a read-only key."
    }
  },
  "x402_tools": "https://api.loyalspark.online/x402-gateway/mcp-tools/<tool_name>",
  "x402_tools_note": "32 merchant tools are sold pay-per-call (x402, USDC on Base; send PAYMENT-SIGNATURE). Admin-only get_platform_stats and cancel_stale_offers are direct MCP only, never pay-per-call. Holder tools: https://api.loyalspark.online/x402-gateway/recipient-mcp-tools/<tool_name> (16).",
  "recipient_mcp": "https://api.loyalspark.online/recipient-loyalty-mcp",
  "docs": "https://loyalspark.online/for-agents",
  "docs_no_js": "https://loyalspark.online/for-agents.md",
  "openapi": "https://loyalspark.online/openapi.json",
  "llms": "https://loyalspark.online/llms.txt"
}
