
Loyal Spark
Loyal Spark: программы лояльности на блокчейне Base — 39 инструментов
Что умеет
- Создавать и активировать программы лояльности
- Минтить и переводить токены лояльности
- Создавать и выпускать награды, обменивать баллы
- Смотреть аналитику по программе и баланс токенов
- Управлять предложениями на маркетплейсе
Какие данные видит
Ассистент работает с программами и токенами лояльности пользователя по API-ключу с учётом лимитов тарифа.
Нужен ли аккаунт
Нужен API-ключ из настроек сервиса
Loyal Spark — MCP-сервер для создания и управления программами лояльности на блокчейне Base. Ассистент может создавать программу, минтить и переводить токены лояльности, выпускать награды и отслеживать аналитику по программе. Доступ по API-ключу с ограничениями согласно тарифному плану.
Как подключить
Как подключить Loyal Spark к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://api.loyalspark.online/loyalty-mcp
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить Loyal Spark к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://api.loyalspark.online/loyalty-mcp
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить Loyal Spark к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://api.loyalspark.online/loyalty-mcp
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (39)
Технические названия из tools/list. Нужны только разработчикам.
| get_platform_info | Get info about Loyal Spark protocol on Base L2 |
| get_my_profile | Get authenticated agent's profile |
| generate_program_defaults | Workflow planner: field catalog, required parameters, next_actions, and non-binding examples. External agents must choose their own name, symbol, and economics. |
| get_program_workflow_status | Explain the next merchant action: current_step, required fields, and ordered next_actions (you provide all parameter values) |
| list_loyalty_programs | List loyalty programs owned by the agent's merchant |
| create_loyalty_program | Get factory calldata to deploy a new loyalty token on Base. Defaults to B20 (Base native ERC-20 superset, single tx, active immediately). Pass token_standard='erc20' for the legacy factory. For B20, MINT_ROLE is granted atomically to the merchant admin AND to the agent's CDP wallet (or explicit extra_minters) so autonomous agents can mint with no follow-up transaction. |
| register_loyalty_program | Register a deployed token as a loyalty program in the database. B20 tokens are registered as active; legacy ERC-20 as inactive (activate next). |
| activate_loyalty_program | For legacy ERC-20 programs: returns unpauseUtility + enableMinting calldata. For B20 programs: no-op (already active). |
| update_program_status | Update program status in database after onchain activation/pause |
| update_program_config | Update default cashback_rate and/or points_per_dollar for a program (same as merchant dashboard sliders) |
| list_rewards | List rewards for a loyalty program by token_address. Includes redemption metrics (total vouchers issued, redeemed, and last-30-day counts) for each reward. |
| create_reward | Create a new reward redeemable with loyalty tokens |
| mint_loyalty_tokens | Record mint intent and get a fee-first `calls[]` bundle: protocol fee mint FIRST, then the recipient mint. The protocol fee is charged in the merchant's own loyalty tokens (not USDC). Submit both calls in order (atomically via EIP-5792 send_calls if your wallet supports it), then call confirm_mint_fee (or POST /agent-api/mint/confirm) with the fee tx hash. Unconfirmed fee obligations block future mints. |
| transfer_loyalty_tokens | Get calldata to transfer loyalty tokens between wallets |
| earn_points | Calculate and mint loyalty tokens based on purchase amount and program's cashback rate. Returns a fee-first `calls[]` bundle (protocol fee mint first, then the customer mint) — submit in order, atomically via EIP-5792 if supported, then call confirm_mint_fee (or POST /agent-api/mint/confirm). Unconfirmed fee obligations block future mints. |
| confirm_mint_fee | Confirm that the protocol fee transaction for a previous mint/earn was broadcast on Base. Verifies the fee mint on-chain and clears the obligation. Unconfirmed fee obligations block future mints. |
| get_token_balance | Get loyalty token balance and tier info for a customer |
| get_program_analytics | Get analytics for your loyalty programs |
| list_marketplace_offers | List active token trading offers on the marketplace |
| redeem_reward | Redeem a reward by providing a verified token transfer transaction hash. Creates a voucher for the customer. |
| use_voucher | Mark a voucher as used (redeemed by customer at merchant). Merchant-only operation. |
| check_voucher_status | Check voucher status by code or ID. Public endpoint — no API key or authentication required. |
| get_platform_stats | Get global platform statistics across all merchants. Admin-only: requires agent owned by an admin wallet. |
| cancel_stale_offers | Cancel marketplace offers that have been active for more than N days with no completions. Admin-only action tool. |
| create_personalized_offer | Create a personalized offer for a specific customer. Use when analytics reveal engagement patterns (e.g., inactive customers, high-value segments). |
| update_reward_status | Activate or deactivate a reward in the catalog. Use to manage reward availability based on analytics. |
| send_report | Send a report to the developer/owner. Use this to submit SEO audits, growth ideas, data reports, anomalies, recommendations, or weekly summaries. The report will appear in the merchant's Agent Reports dashboard. |
| list_my_reports | List your previously submitted reports. Allows reviewing past reports, checking status (new/reviewed/done), and identifying what still needs attention. |
| update_report_status | Update report status to 'reviewed' or 'done'. Use 'done' when the action items have been completed. Use 'reviewed' to acknowledge a report. |
| delete_report | Delete a report that is no longer relevant. Use to clean up outdated or irrelevant reports. |
| export_customers | Export customer data for a specific loyalty program. Returns wallet addresses, voucher stats, balances, and tier info. Use for analytics, segmentation, and personalized offers. |
| create_gift_certificate | Create a gift / welcome certificate (UDS-style) with a unique 6-character redemption code (LOYAL-XXXXXX). Customer redeems via QR or by entering the code; merchant then mints tokens on-chain. Use for welcome bonuses, promo campaigns, partnership gifts. |
| list_gift_certificates | List gift certificates issued by the agent's merchant (with status and redemption info). |
| revoke_gift_certificate | Revoke an active gift certificate (status active → revoked). Only the issuing merchant can revoke. Already-redeemed/minted certificates cannot be revoked. |
| mark_gift_certificate_minted | After the merchant submits the on-chain mint transaction for a claimed gift certificate, call this to mark it as minted (status pending_mint → redeemed) and store the mint tx hash. |
| bazaar_discover_resources | Discover third-party x402-paid resources published in Coinbase CDP's Bazaar (docs, data feeds, AI inference, etc). Read-only. Filter by free-text q and/or network (e.g. 'base'). |
| bazaar_discover_mcp_servers | Discover third-party MCP servers published in Coinbase CDP's Bazaar. Read-only. Filter by free-text q and/or network. |
| bazaar_probe_x402 | GET a candidate x402 URL and, if it responds HTTP 402, return the parsed payment requirements (accepts[]) so the caller can decide whether to pay. HTTPS only. No signing performed. |
| bazaar_pay_and_call | Pay and call any x402-paid HTTPS endpoint using the merchant agent's CDP MPC wallet (EIP-3009 exact scheme on Base USDC). Probes the URL for HTTP 402, picks a compatible requirement, signs TransferWithAuthorization via CDP, retries with X-PAYMENT header, and returns the paid response. Requires scope 'mint' and a pre-created CDP wallet. Safety cap: max_usdc (default 0.25, hard limit 10). |