MCP server

Smile.io MCP by usefulapi

io.usefulapi/smile-io

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Look up loyalty customers, points history, rewards and VIP tiers, and add points or activities.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

14

Token cost

About 3,233 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http smile-io https://smile-io.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.smile-io]
url = "https://smile-io.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"smile-io":{"httpUrl":"https://smile-io.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"smile-io":{"url":"https://smile-io.usefulapi.io/mcp"}}}

VS Code

{"servers":{"smile-io":{"type":"http","url":"https://smile-io.usefulapi.io/mcp"}}}

Antigravity

agy mcp add smile-io https://smile-io.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"smile-io","server_url":"https://smile-io.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"smile-io","server_url":"https://smile-io.usefulapi.io/mcp"}

Tools

• smile_create_activity ~422 tokens
  WRITE: record that a customer performed an action (identified by an activity type token configured in Smile Admin, e.g. a custom 'newsletter signup' activity). Smile then asynchronously applies the store's earning rules and may issue points or rewards. Identify the customer by customer_id OR custome
• smile_create_points_transaction ~342 tokens
  WRITE: add or deduct points from a customer's balance (a manual adjustment, e.g. a goodwill credit or a correction). points_change > 0 adds, < 0 deducts; Smile rejects a deduction that would make the balance negative. Undo by creating an opposite adjustment. `description` is shown to the customer; `
• smile_get_customer ~205 tokens
  Fetch one customer by Smile customer ID: name, email, state, points_balance, referral_url, vip_tier_id, and optionally their VIP status with current and next tier. Smile: GET /customers/{id}.
• smile_get_points_product ~123 tokens
  Fetch one points product (a way to redeem points) by ID, including its reward. Smile: GET /points_products/{id}.
• smile_get_points_settings ~82 tokens
  Fetch the points program's configuration, e.g. the points currency label ("Points", "Stars"). Smile: GET /points_settings.
• smile_get_points_transaction ~117 tokens
  Fetch one points transaction by ID. Smile: GET /points_transactions/{id}.
• smile_get_referral_settings ~90 tokens
  Fetch the referral program's configuration: whether it is active, and the sender (advocate) and receiver (friend) rewards. Smile: GET /referral_settings.
• smile_list_customers ~326 tokens
  List loyalty-program customers, newest first, with their points balance, state and VIP tier id. Look a customer up by exact email, or filter by state or last-updated time. Cursor-paginated (metadata.next_cursor). Smile: GET /customers.
• smile_list_earning_rules ~194 tokens
  List the enabled earning rules — the ways customers earn points or rewards (placing an order, signing up, birthdays, custom activities), with reward, reward_value, earning_limit and any VIP-tier restriction. Cursor-paginated. Smile: GET /earning_rules.
• smile_list_points_products ~250 tokens
  List points products — the rewards customers can buy with points. 'fixed' products cost points_price; 'variable' products trade variable_points_step points for variable_points_step_reward_value, between variable_points_min and variable_points_max. Each embeds its reward. Page-numbered (page, page_si
• smile_list_points_transactions ~275 tokens
  List points transactions (every earn, spend and manual adjustment), newest first — e.g. a customer's full points history. Each has points_change (+/-), a customer-visible description and a merchant internal_note. Cursor-paginated. Smile: GET /points_transactions.
• smile_list_reward_fulfillments ~334 tokens
  List rewards that have been issued to customers — usually discount codes — with code, fulfillment_status (pending/issued/cancelled/failed), usage_status (used/unused/untracked), used_at and expires_at. Use customer_id to answer 'what codes does this customer have?'. Cursor-paginated. Smile: GET /rew
• smile_list_vip_tiers ~138 tokens
  List the VIP program's tiers, sorted by milestone (the threshold to reach each tier), optionally with each tier's perks and entry rewards. Smile: GET /vip_tiers.
• smile_purchase_points_product Moves money · ~335 tokens
  WRITE — SPENDS THE CUSTOMER'S POINTS: redeem points on the customer's behalf by purchasing a points product; Smile deducts the points and issues the reward (the response's points_purchase.reward_fulfillment usually holds a discount code). Only do this when the customer asked for it. For a 'variable'

Browse

• Email
• Email marketing

Related MCP servers

• FavCRM
  Agentic CRM for service businesses — bookings, customers, WhatsApp, loyalty, invoicing.
• Aclimação
  Aclimação — neighborhood directory: local places, events, menus, offers, and services.
• Loyverse MCP by usefulapi
  Query Loyverse POS receipts, shifts, items, inventory and customers, and update stock and customers.
• Hiboutik MCP by usefulapi
  Read Hiboutik products, stock, customers, sales and turnover; edit customers and sale comments.
• PHP Point of Sale MCP by usefulapi
  Read PHP Point of Sale items, sales, customers and 138 reports; manage customers, items, expenses.
• KiotViet MCP by usefulapi
  Read KiotViet products, customers, invoices, orders and stock; create customers and orders.
• Trisport
  Romanian sports store: search, sizes, stock, cart link; sign-in for orders, tracking, points.
• Thmenu
  Restaurant menus, carts, reservations and owner drafts for AI agents (Thmenu MCP).

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/smile-io.svg)](https://aptlynx.net/servers/io.usefulapi/smile-io)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents