{"uid":"cap_V1_zYeRZZNjrVwz8fswha","slug":"loyal-spark-use-voucher-a8cd7be4","name":"Loyal Spark - Use Voucher","description":"Onchain loyalty protocol on Base L2. Launch B20 rewards, earn and redeem tokens, trade P2P, automate with AI agents via REST and MCP.","url":"https://api.loyalspark.online/x402-gateway/mcp-tools/use_voucher","method":"POST","headers":{},"bodySchema":{"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":{}}}}},"responseSchema":{"type":"json"},"example":{"request":{"id":1,"method":"tools/call","params":{"name":"get_platform_info","arguments":{}},"jsonrpc":"2.0"},"response":{"id":1,"result":{"content":[{"text":"{\"name\":\"Loyal Spark\",\"chain\":\"Base L2\",\"chain_id\":8453,\"token_standard\":\"ERC-20\",\"features\":[\"loyalty_programs\",\"rewards\",\"marketplace\",\"tiers\",\"referrals\",\"vouchers\",\"analytics\"],\"api_docs\":\"https://loyalspark.online/api-docs\"}","type":"text"}]},"jsonrpc":"2.0"}},"exampleRequest":{"id":1,"method":"tools/call","params":{"name":"get_platform_info","arguments":{}},"jsonrpc":"2.0"},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VU2726Hzng23CkKcfUu9P","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Redeems a loyalty voucher on the Loyal Spark onchain rewards protocol running on Base L2","exampleAgentPrompt":"Redeem my Loyal Spark voucher — the voucher ID is VOUCHER-ABC123 — and apply it to my wallet 0xABCDEF1234567890 to get the associated ERC-20 reward tokens on Base.","exampleUseCases":null,"resultDescription":"Returns a JSON response confirming the voucher redemption, including transaction hash on Base L2, updated token balance, and voucher status (e.g. redeemed/consumed). May also include the amount of ERC-20 reward tokens credited to the wallet.","failureModes":["Voucher already redeemed — returns error indicating voucher has been consumed","Invalid voucher ID — returns 400 or similar error","Wallet address not eligible for this voucher","Insufficient payment of $0.01 USDC via x402 causes request rejection","Onchain transaction failure due to Base L2 network congestion","Voucher expired — returns error indicating expiry"],"whenToPreferThis":"Use this endpoint when a user wants to redeem or consume a specific loyalty voucher on the Loyal Spark protocol on Base L2, converting a voucher code into onchain ERC-20 reward tokens. Prefer this over 'earn' or 'trade' endpoints when the user has an existing voucher to apply rather than wanting to earn new rewards or swap tokens.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:49:25.251Z","isFirstParty":false}