chainloyalty (v1.0.0)

AI-powered loyalty platform management — query events, analyze rewards, debug rules, track referrals, and monitor platform analytics with interactive widgets.

https://round-frog-gb3og.run.mcp-use.com/mcp

Powered by github.com/mcp-use/mcp-use

Installation Guide

Choose your preferred MCP client

Install in Claude Code

Run this command in your terminal:

claude mcp add --transport http "chainloyalty" https://round-frog-gb3og.run.mcp-use.com/mcp

Install in Cursor

Click the button below to add this MCP server to Cursor:

Open in Cursor

Or add manually: Settings → MCP → Add server

Install in VS Code

Click the button below to add this MCP server to VS Code:

Open in VS Code

Or add manually: Settings → MCP → Add server

Install in VS Code Insiders

Click the button below to add this MCP server to VS Code Insiders:

Open in VS Code Insiders

Or add manually: Settings → MCP → Add server

Connect with ChatGPT

Enable Developer Mode: Settings → Connectors → Advanced → Developer mode
Import this MCP server: Go to Connectors tab and add: https://round-frog-gb3og.run.mcp-use.com/mcp
Use in conversations: Choose the MCP server from the Plus menu

Primitives

Tools (18)

query-events

Search and filter loyalty events by wallet address, event type, or date range. Returns a visual timeline of matching events.

get-event-types

List all available event types with their counts. Optionally filter by wallet address.

count-events

Get aggregate event counts, optionally grouped by event type or day.

get-rewards

Get a complete rewards overview for a wallet: points balance, badges earned, and recent transactions.

get-leaderboard

Get the top users ranked by points balance. Shows a leaderboard of the highest earners.

get-badge-owners

Get all users who own a specific badge by badge ID.

list-rules

List all loyalty rules. Optionally filter by active status. Shows rule names, types, conditions, and rewards.

evaluate-rule

Evaluate a rule against a sample event to see if it would trigger. Shows a detailed breakdown of which conditions matched.

get-rule-details

Get detailed information about a specific rule including conditions, reward config, and trigger history.

get-referral-stats

Get referral statistics for a wallet address, including referral codes, referral count, and conversion rates.

lookup-code

Check if a referral code is valid and get details about it.

get-top-referrers

Get the top referrers ranked by completed referral count.

check-wallet

Check if a wallet address exists in the system and get a quick summary of its activity.

get-wallet-activity

Get the recent activity timeline for a wallet address, including events and transactions.

wallet-summary

Get a comprehensive overview of a wallet including points, badges, referrals, and recent events.

platform-stats

Get overall platform statistics including total users, events, points distributed, and active rules.

active-users

Get the count of active users (users with events) in a given time period.

engagement-trends

Get engagement metrics over a time period, showing daily event counts and trends.

Resources (6)

ui://widget/analytics-dashboard.htmlanalytics-dashboard

Platform analytics dashboard with KPI cards, event distribution, and engagement trends

ui://widget/event-timeline.htmlevent-timeline

Display loyalty events in a chronological timeline with event type badges and metadata

ui://widget/referral-analytics.htmlreferral-analytics

Display referral analytics: stats, codes, referral list, and top referrers

ui://widget/rewards-dashboard.htmlrewards-dashboard

Display rewards overview: points balance, badges, transactions, and leaderboard

ui://widget/rule-debugger.htmlrule-debugger

Display and debug loyalty rules with condition visualization and simulation results

ui://widget/wallet-overview.htmlwallet-overview

Comprehensive wallet overview showing points, badges, events, and transactions