npm @hoya25/nctr-mcp-serverstreamable-httpMITupdated 5mo ago
The first rewards and loyalty MCP server. Enables AI agents to discover and interact with the NCTR Alliance rewards program — bounties, earning rates, tier progression, promotions, and Impact Engine communities.
nctr mcp server 能做什么?
Last updated: March 26, 2026
NCTR Alliance MCP Server
The first rewards and loyalty MCP server. Enables AI agents to discover and interact with the NCTR Alliance rewards program — bounties, earning rates, tier progression, promotions, and Impact Engine communities.
What It Does
When someone asks an AI assistant about NCTR, the assistant can call this server to get real, structured data instead of guessing. The server exposes 6 tools:
| Tool | What It Does |
|---|---|
search_bounties |
Search and filter all 19 available bounties by category, amount, keyword, or repeatability |
get_earning_rates |
Get earning multipliers by Crescendo tier, with optional bounty calculations |
check_tier_requirements |
Check tier thresholds, perks, and progress toward the next tier |
get_active_promotions |
Get current limited-time offers and launch bonuses |
get_onboarding_link |
Generate a join link with optional referral code |
get_impact_engines |
Discover NCTR's 6 passion-based communities |
Quick Start
Connect to the hosted server
Add this to your MCP client configuration (Claude Desktop, Cursor, etc.):
{
"mcpServers": {
"nctr-alliance": {
"url": "https://yhwcaodofmbusjurawhp.supabase.co/functions/v1/mcp/rpc"
}
}
}
Claude Code (terminal)
claude mcp add nctr-alliance -t http https://yhwcaodofmbusjurawhp.supabase.co/functions/v1/mcp/rpc
Or run locally
git clone https://github.com/Hoya25/mcp-server.git
cd mcp-server
supabase start
supabase functions serve --no-verify-jwt mcp
Server runs at: http://localhost:54321/functions/v1/mcp/rpc
Example Queries
Once connected, you can ask your AI assistant things like:
- "What bounties can I earn with NCTR?"
- "How much NCTR do I get for referring a friend?"
- "What tier am I at with 3,000 NCTR?"
- "What's the earning multiplier at Gold tier?"
- "Are there any active promotions?"
- "Tell me about the NCTR Impact Engines"
How Bounties Work
Every bounty in NCTR uses 360LOCK — tokens are locked for exactly 360 days. They're committed, not spent. After the lock period, the NCTR is fully yours.
Bounty Categories
| Category | Examples |
|---|---|
| Entry | Sign-up (625), Early Adopter Bonus (1,250), Profile Completion (375) |
| Revenue | First Purchase (2,500), Shop & Earn (250 uncapped), Quarterly Spend (5,000) |
| Merch | Collection (5,000), Repeat (500) |
| Referral | Friend sign-ups (625), friend purchases (2,500), milestone bonuses |
| Engagement | Social shares (500), monthly activity (250), community contributions (2,000) |
Crescendo Status Tiers
| Tier | NCTR Required | Multiplier |
|---|---|---|
| Bronze | 0 | 1.0x |
| Silver | 1,000 | 1.2x |
| Gold | 5,000 | 1.5x |
| Platinum | 25,000 | 1.8x |
| Diamond | 100,000 | 2.0x |
Impact Engines
NCTR includes 6 passion-based communities called Impact Engines:
- THROTTLE — Powersports
- GROUNDBALL — Lacrosse
- STARDUST — Entertainment
- SWEAT — Skilled Trades
- SISU — Recovery
- INSPIRATION — Wellness
API Endpoints
| Endpoint | Method | Description |
|---|---|---|
/ |
GET | Server info and tool list |
/health |
GET | Health check |
/rpc |
POST | MCP protocol endpoint (Streamable HTTP) |
Test with curl
# Health check
curl https://yhwcaodofmbusjurawhp.supabase.co/functions/v1/mcp/health
# Search all bounties
curl -X POST https://yhwcaodofmbusjurawhp.supabase.co/functions/v1/mcp/rpc \
-H "Content-Type: application/json" \
-H "Accept: application/json, text/event-stream" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_bounties","arguments":{}}}'
Deployment
This server runs on Supabase Edge Functions using the official MCP TypeScript SDK (@modelcontextprotocol/sdk@1.25.3).
supabase link --project-ref yhwcaodofmbusjurawhp
supabase functions deploy --no-verify-jwt mcp
Links
- NCTR Alliance: nctr.live
- The Garden (shopping): thegarden.nctr.live
- Crescendo (onboarding): crescendo.nctr.live
- For Agents: thegarden.nctr.live/for-agents
- Manifest: nctr.live/.well-known/nctr.json
License
MIT
安装
把 nctr mcp server 添加到你的客户端。选择你正在使用的那个。
{
"servers": {
"nctr-mcp-server": {
"type": "http",
"url": "https://yhwcaodofmbusjurawhp.supabase.co/functions/v1/mcp/rpc"
}
}
}Add to `.vscode/mcp.json` in your workspace.
claude mcp add nctr-mcp-server -- npx -y @hoya25/nctr-mcp-servercodex mcp add nctr-mcp-server -- npx -y @hoya25/nctr-mcp-serveramp mcp add nctr-mcp-server -- npx -y @hoya25/nctr-mcp-server{
"mcpServers": {
"nctr-mcp-server": {
"command": "npx",
"args": [
"-y",
"@hoya25/nctr-mcp-server"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"nctr-mcp-server": {
"command": "npx",
"args": [
"-y",
"@hoya25/nctr-mcp-server"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"mcpServers": {
"nctr-mcp-server": {
"command": "npx",
"args": [
"-y",
"@hoya25/nctr-mcp-server"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"nctr-mcp-server": {
"command": "npx",
"args": [
"-y",
"@hoya25/nctr-mcp-server"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"nctr-mcp-server": {
"command": "npx",
"args": [
"-y",
"@hoya25/nctr-mcp-server"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"nctr-mcp-server": {
"type": "local",
"command": "npx",
"args": [
"-y",
"@hoya25/nctr-mcp-server"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"nctr-mcp-server": {
"command": {
"path": "npx",
"args": [
"-y",
"@hoya25/nctr-mcp-server"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y @hoya25/nctr-mcp-serverRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
评分
39 / 100
不完整
- 文档25/25
- 维护13/25
- 可信度13/20
- 能力0/15
- 安装体验15/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 159 days ago
- Has a release history
- Repository is not archived
- Licensed MIT
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 18 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
版本历史
| 版本 | 发布于 |
|---|---|
| 1.0.1最新 | 2026年3月2日 |