Smile Io

io.usefulapiv1.0.0Updated Sep 30, 2026

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

VerifiedStreamable HTTPWeb executableBusiness & CommerceProductivity & Workflow

Overview

AI-generated overview

Lets an assistant read Smile.io loyalty data — customers, points, rewards, VIP tiers — and adjust points or record activities.

What it does
Connects to a hosted Smile.io loyalty API and exposes read tools for customers, points transactions, points products, reward fulfillments, earning rules, VIP tiers, and points and referral settings. Three write tools adjust a customer's points balance, record a customer activity, and redeem a customer's points for a reward. Two meta tools report usage and manage the subscription.
When to use it
Useful when an assistant needs to answer questions about loyalty program members, points balances and history, rewards, or VIP tiers, or to make specific points adjustments and record activities without opening the Smile.io admin. Read-only use is the safer default; add it when loyalty data is part of the workflow.
Requirements
Remote hosted endpoint; no local install. Requires a Smile.io merchant API key, entered on first connect and stored per user. Network access to the hosted endpoint.
Before you install
The merchant API key is a credential giving access to loyalty customer data. Three tools write: adjusting points balances, recording activities, and redeeming points for rewards — these change customer accounts and should be confirmed. Free tier is limited to 100 tool calls per month; Pro is $9/mo or $90/yr.

Installation

In SourceWeft

  1. Open Smile Io in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

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

README

Smile.io MCP by usefulapi

Use Smile.io from Claude, Cursor, or any MCP client — look up loyalty customers, points balances and history, ways to earn and redeem, issued rewards and VIP tiers, and adjust points. Hosted, no local install: connect with your own Smile.io credentials.

Live endpoint: https://smile-io.usefulapi.io/mcp · Homepage: https://usefulapi.io/smile-io

Add to Claude

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

On first connect you'll provide your Smile.io merchant API key (Smile Admin → Settings → Developer tools → API keys). They're validated, stored per-user, and scoped to you — no keys in config files.

Tools

ToolTypeWhat it does
smile_list_customersreadList customers
smile_get_customerreadGet a customer
smile_list_points_transactionsreadList points transactions
smile_get_points_transactionreadGet a points transaction
smile_list_points_productsreadList points products
smile_get_points_productreadGet a points product
smile_list_reward_fulfillmentsreadList reward fulfillments
smile_list_earning_rulesreadList earning rules
smile_list_vip_tiersreadList VIP tiers
smile_get_points_settingsreadGet points settings
smile_get_referral_settingsreadGet referral settings
smile_create_points_transactionwriteAdjust a customer's points balance
smile_create_activitywriteRecord a customer activity
smile_purchase_points_productwriteRedeem a customer's points for a reward
smile_usage_statusmetaUsage status (free-tier meter)
smile_upgrademetaUpgrade to Pro (unlimited)

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage or manage your subscription.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited

License

MIT © usefulapi. Not affiliated with or endorsed by Smile.io.

Source: servers/smile-io/README.md at commit 1ec23c2

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestSep 30, 2026