@hoya25/nctr-mcp-server 1.0.0

package/.mcp/server.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.hoya25/nctr-mcp-server",
+  "description": "NCTR Alliance rewards program — search bounties, check earning rates by tier, discover Impact Engine communities, and get onboarding links. The first rewards and loyalty MCP server.",
+  "repository": {
+    "url": "https://github.com/Hoya25/mcp-server",
+    "source": "github"
+  },
+  "version": "1.0.0",
+  "packages": [
+    {
+      "registryType": "npm",
+      "identifier": "@hoya25/nctr-mcp-server",
+      "version": "1.0.0",
+      "transport": {
+        "type": "stdio"
+      }
+    }
+  ],
+  "remotes": [
+    {
+      "transportType": "streamable-http",
+      "url": "https://yhwcaodofmbusjurawhp.supabase.co/functions/v1/mcp/rpc"
+    }
+  ]
+}

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NCTR Alliance
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,137 @@
+# 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.):
+
+```json
+{
+  "mcpServers": {
+    "nctr-alliance": {
+      "url": "https://yhwcaodofmbusjurawhp.supabase.co/functions/v1/mcp/rpc"
+    }
+  }
+}
+```
+
+### Claude Code (terminal)
+
+```bash
+claude mcp add nctr-alliance -t http https://yhwcaodofmbusjurawhp.supabase.co/functions/v1/mcp/rpc
+```
+
+### Or run locally
+
+```bash
+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
+
+```bash
+# 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`).
+
+```bash
+supabase link --project-ref yhwcaodofmbusjurawhp
+supabase functions deploy --no-verify-jwt mcp
+```
+
+## Links
+
+- **NCTR Alliance**: [nctr.live](https://nctr.live)
+- **The Garden** (shopping): [thegarden.nctr.live](https://thegarden.nctr.live)
+- **Crescendo** (onboarding): [crescendo.nctr.live](https://crescendo.nctr.live)
+- **For Agents**: [thegarden.nctr.live/for-agents](https://thegarden.nctr.live/for-agents)
+- **Manifest**: [nctr.live/.well-known/nctr.json](https://nctr.live/.well-known/nctr.json)
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@hoya25/nctr-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for the NCTR Alliance rewards program. Enables AI agents to discover bounties, earning rates, tier requirements, promotions, and Impact Engine communities.",
+  "mcpName": "io.github.hoya25/nctr-mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Hoya25/mcp-server.git"
+  },
+  "keywords": [
+    "mcp",
+    "rewards",
+    "loyalty",
+    "nctr",
+    "bounties",
+    "model-context-protocol"
+  ],
+  "author": "NCTR Alliance <anderson@butterflystudios.live>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "dev": "supabase functions serve --no-verify-jwt mcp",
+    "deploy": "supabase functions deploy --no-verify-jwt mcp",
+    "test": "bash test-mcp-server.sh",
+    "inspector": "npx @modelcontextprotocol/inspector"
+  }
+}

package/supabase/config.toml

@@ -0,0 +1,2 @@
+[functions.mcp]
+verify_jwt = false

package/supabase/functions/mcp/deno.json

@@ -0,0 +1,7 @@
+{
+  "imports": {
+    "@modelcontextprotocol/sdk/": "npm:@modelcontextprotocol/sdk@1.25.3/",
+    "hono": "npm:hono@^4.9.7",
+    "zod": "npm:zod@^4.1.13"
+  }
+}

package/supabase/functions/mcp/index.ts

@@ -0,0 +1,897 @@
+/**
+ * NCTR Alliance MCP Server
+ * ========================
+ * Model Context Protocol server for AI agents to discover and interact
+ * with the NCTR rewards program, bounties, and Impact Engines.
+ *
+ * Deployment: Supabase Edge Functions
+ * Transport: Streamable HTTP (MCP specification standard)
+ * Auth: Public (no authentication required)
+ *
+ * Tools:
+ *   1. search_bounties     — Search and filter available bounties
+ *   2. get_earning_rates   — Get earning rates by Crescendo tier
+ *   3. check_tier_requirements — Check requirements for each tier
+ *   4. get_active_promotions  — Get current promotions and limited offers
+ *   5. get_onboarding_link    — Generate a member onboarding link
+ *   6. get_impact_engines     — Discover NCTR Impact Engine communities
+ *
+ * NCTR Alliance — https://nctr.live
+ * The Garden — https://thegarden.nctr.live
+ */
+
+import 'jsr:@supabase/functions-js/edge-runtime.d.ts'
+
+import { McpServer } from 'npm:@modelcontextprotocol/sdk@1.25.3/server/mcp.js'
+import { WebStandardStreamableHTTPServerTransport } from 'npm:@modelcontextprotocol/sdk@1.25.3/server/webStandardStreamableHttp.js'
+import { Hono } from 'npm:hono@^4.9.7'
+import { z } from 'npm:zod@^4.1.13'
+
+// ─────────────────────────────────────────────────────────────
+// DATA: Bounties
+// ─────────────────────────────────────────────────────────────
+
+interface Bounty {
+  id: string
+  name: string
+  category: 'entry' | 'revenue' | 'merch' | 'referral' | 'engagement'
+  description: string
+  amount: number
+  currency: string
+  lock_period: string
+  lock_days: number
+  repeatable: boolean
+  requirements: string[]
+  tags: string[]
+}
+
+const BOUNTIES: Bounty[] = [
+  // ── Entry Bounties ──
+  {
+    id: 'bounty-signup',
+    name: 'Sign-Up Bounty',
+    category: 'entry',
+    description: 'Create your NCTR account and complete onboarding. Earn 625 NCTR just for joining.',
+    amount: 625,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['Create account', 'Verify email', 'Complete profile'],
+    tags: ['new-member', 'onboarding', 'easy']
+  },
+  {
+    id: 'bounty-early-adopter',
+    name: 'Early Adopter Bonus',
+    category: 'entry',
+    description: 'Launch period only — earn 1,250 NCTR as an early adopter. Available during launch period.',
+    amount: 1250,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['Join during launch period'],
+    tags: ['limited-time', 'launch', 'bonus']
+  },
+  {
+    id: 'bounty-profile-complete',
+    name: 'Profile Completion Bounty',
+    category: 'entry',
+    description: 'Fill out your full profile including avatar, bio, and preferences. Earn 375 NCTR.',
+    amount: 375,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['Upload avatar', 'Write bio', 'Set preferences'],
+    tags: ['onboarding', 'profile', 'easy']
+  },
+  // ── Revenue Bounties ──
+  {
+    id: 'bounty-first-purchase',
+    name: 'First Purchase Bounty',
+    category: 'revenue',
+    description: 'Make your first purchase through The Garden and earn 2,500 NCTR.',
+    amount: 2500,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['Complete first purchase through The Garden'],
+    tags: ['shopping', 'first-time', 'the-garden']
+  },
+  {
+    id: 'bounty-shop-and-earn',
+    name: 'Shop & Earn',
+    category: 'revenue',
+    description: 'Earn 250 NCTR per qualifying purchase through The Garden. No cap — earn every time you shop.',
+    amount: 250,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: true,
+    requirements: ['Make a qualifying purchase through The Garden'],
+    tags: ['shopping', 'recurring', 'the-garden', 'uncapped']
+  },
+  {
+    id: 'bounty-quarterly-spend',
+    name: 'Quarterly Spend Bounty',
+    category: 'revenue',
+    description: 'Hit the quarterly spend threshold and earn 5,000 NCTR. Resets each quarter.',
+    amount: 5000,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: true,
+    requirements: ['Reach quarterly spend threshold'],
+    tags: ['shopping', 'quarterly', 'milestone']
+  },
+  {
+    id: 'bounty-annual-member',
+    name: 'Annual Member Bounty',
+    category: 'revenue',
+    description: 'Maintain active membership for a full year and earn 10,000 NCTR.',
+    amount: 10000,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: true,
+    requirements: ['Maintain active membership for 12 months'],
+    tags: ['loyalty', 'annual', 'milestone']
+  },
+  {
+    id: 'bounty-whale-spend',
+    name: 'Whale Spend Bounty',
+    category: 'revenue',
+    description: 'Reach the top-tier annual spend level and earn 25,000 NCTR.',
+    amount: 25000,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: true,
+    requirements: ['Reach top-tier annual spend threshold'],
+    tags: ['premium', 'annual', 'high-value']
+  },
+  // ── Merch Bounties ──
+  {
+    id: 'bounty-merch-collection',
+    name: 'Merch Collection Bounty',
+    category: 'merch',
+    description: 'Purchase from an NCTR merch collection and earn 5,000 NCTR.',
+    amount: 5000,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['Purchase from official NCTR merch collection'],
+    tags: ['merch', 'collection', 'branded']
+  },
+  {
+    id: 'bounty-merch-repeat',
+    name: 'Merch Repeat Bounty',
+    category: 'merch',
+    description: 'Earn 500 NCTR for each additional merch purchase.',
+    amount: 500,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: true,
+    requirements: ['Purchase additional merch items'],
+    tags: ['merch', 'recurring']
+  },
+  // ── Referral Bounties ──
+  {
+    id: 'bounty-referral-signup',
+    name: 'Referral Sign-Up Bounty',
+    category: 'referral',
+    description: 'Refer a friend who creates an account. Earn 625 NCTR per referral.',
+    amount: 625,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: true,
+    requirements: ['Referred friend creates account'],
+    tags: ['referral', 'friend', 'recurring']
+  },
+  {
+    id: 'bounty-referral-purchase',
+    name: 'Referral Purchase Bounty',
+    category: 'referral',
+    description: 'Earn 2,500 NCTR when your referral makes their first purchase.',
+    amount: 2500,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: true,
+    requirements: ['Referred friend completes first purchase'],
+    tags: ['referral', 'purchase', 'recurring']
+  },
+  {
+    id: 'bounty-early-referral',
+    name: 'Early Referral Bonus',
+    category: 'referral',
+    description: 'Launch period referral bonus — earn 500 NCTR per referral during early access.',
+    amount: 500,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: true,
+    requirements: ['Refer during launch period'],
+    tags: ['referral', 'launch', 'limited-time']
+  },
+  {
+    id: 'bounty-referral-milestone-5',
+    name: 'Referral Milestone — 5 Friends',
+    category: 'referral',
+    description: 'Refer 5 friends who all sign up. Earn a 2,500 NCTR milestone bonus.',
+    amount: 2500,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['5 referred friends create accounts'],
+    tags: ['referral', 'milestone']
+  },
+  {
+    id: 'bounty-referral-milestone-20',
+    name: 'Referral Milestone — 20 Friends',
+    category: 'referral',
+    description: 'Refer 20 friends who all sign up. Earn a 5,000 NCTR milestone bonus.',
+    amount: 5000,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['20 referred friends create accounts'],
+    tags: ['referral', 'milestone', 'ambassador']
+  },
+  // ── Engagement Bounties ──
+  {
+    id: 'bounty-social-share',
+    name: 'Social Share Bounty',
+    category: 'engagement',
+    description: 'Share NCTR on social media and earn 500 NCTR.',
+    amount: 500,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['Share NCTR content on social media', 'Tag @NCTRAlliance'],
+    tags: ['social', 'sharing', 'easy']
+  },
+  {
+    id: 'bounty-monthly-engagement',
+    name: 'Monthly Engagement Bounty',
+    category: 'engagement',
+    description: 'Stay active each month — earn 250 NCTR per month, up to 4 months.',
+    amount: 250,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: true,
+    requirements: ['Log in and complete qualifying activity each month'],
+    tags: ['monthly', 'activity', 'recurring']
+  },
+  {
+    id: 'bounty-community-contributor',
+    name: 'Community Contributor Bounty',
+    category: 'engagement',
+    description: 'Make a meaningful contribution to the NCTR community and earn 2,000 NCTR.',
+    amount: 2000,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['Submit approved community contribution'],
+    tags: ['community', 'contribution']
+  },
+  {
+    id: 'bounty-impact-engine-join',
+    name: 'Impact Engine Join Bounty',
+    category: 'engagement',
+    description: 'Join an Impact Engine community and earn 5,000 NCTR.',
+    amount: 5000,
+    currency: 'NCTR',
+    lock_period: '360LOCK',
+    lock_days: 360,
+    repeatable: false,
+    requirements: ['Join any Impact Engine community'],
+    tags: ['impact-engine', 'community', 'joining']
+  }
+]
+
+// ─────────────────────────────────────────────────────────────
+// DATA: Crescendo Status Tiers
+// ─────────────────────────────────────────────────────────────
+
+interface Tier {
+  name: string
+  threshold: number
+  multiplier: number
+  description: string
+  perks: string[]
+}
+
+const TIERS: Tier[] = [
+  {
+    name: 'Bronze',
+    threshold: 0,
+    multiplier: 1.0,
+    description: 'Starting tier — all members begin here. Base earning rate on all bounties.',
+    perks: ['Access to all standard bounties', 'The Garden shopping', 'Community access']
+  },
+  {
+    name: 'Silver',
+    threshold: 1000,
+    multiplier: 1.2,
+    description: 'Committed members with 1,000+ NCTR locked. 1.2x earning multiplier.',
+    perks: ['1.2x earning multiplier', 'Early access to new bounties', 'Silver badge']
+  },
+  {
+    name: 'Gold',
+    threshold: 5000,
+    multiplier: 1.5,
+    description: 'Active members with 5,000+ NCTR locked. 1.5x earning multiplier.',
+    perks: ['1.5x earning multiplier', 'Exclusive Gold bounties', 'Priority support', 'Gold badge']
+  },
+  {
+    name: 'Platinum',
+    threshold: 25000,
+    multiplier: 1.8,
+    description: 'Power members with 25,000+ NCTR locked. 1.8x earning multiplier.',
+    perks: ['1.8x earning multiplier', 'VIP experiences', 'Platinum-only drops', 'Platinum badge']
+  },
+  {
+    name: 'Diamond',
+    threshold: 100000,
+    multiplier: 2.0,
+    description: 'Top-tier members with 100,000+ NCTR locked. 2.0x earning multiplier.',
+    perks: ['2.0x earning multiplier', 'Founding member recognition', 'Diamond-exclusive events', 'Diamond badge', 'Direct team access']
+  }
+]
+
+// ─────────────────────────────────────────────────────────────
+// DATA: Impact Engines
+// ─────────────────────────────────────────────────────────────
+
+interface ImpactEngine {
+  name: string
+  slug: string
+  category: string
+  description: string
+  status: string
+}
+
+const IMPACT_ENGINES: ImpactEngine[] = [
+  {
+    name: 'THROTTLE',
+    slug: 'throttle',
+    category: 'Powersports',
+    description: 'The powersports community within NCTR. Connecting riders, racers, and off-road enthusiasts through shared rewards.',
+    status: 'active'
+  },
+  {
+    name: 'GROUNDBALL',
+    slug: 'groundball',
+    category: 'Lacrosse',
+    description: 'The lacrosse community within NCTR. Uniting players, coaches, and fans at every level of the sport.',
+    status: 'active'
+  },
+  {
+    name: 'STARDUST',
+    slug: 'stardust',
+    category: 'Entertainment',
+    description: 'The entertainment community within NCTR. Connecting creators, performers, and fans across music, film, and live events.',
+    status: 'active'
+  },
+  {
+    name: 'SWEAT',
+    slug: 'sweat',
+    category: 'Skilled Trades',
+    description: 'The skilled trades community within NCTR. Supporting tradespeople, apprentices, and craftworkers.',
+    status: 'active'
+  },
+  {
+    name: 'SISU',
+    slug: 'sisu',
+    category: 'Recovery',
+    description: 'The recovery community within NCTR. A judgment-free space for people on recovery journeys.',
+    status: 'active'
+  },
+  {
+    name: 'INSPIRATION',
+    slug: 'inspiration',
+    category: 'Wellness',
+    description: 'The wellness community within NCTR. Focused on mindfulness, fitness, nutrition, and holistic well-being.',
+    status: 'active'
+  }
+]
+
+// ─────────────────────────────────────────────────────────────
+// DATA: Active Promotions
+// ─────────────────────────────────────────────────────────────
+
+interface Promotion {
+  name: string
+  description: string
+  type: string
+  bounty_id: string | null
+  active: boolean
+  details: string
+}
+
+const PROMOTIONS: Promotion[] = [
+  {
+    name: 'Early Adopter Bonus',
+    description: 'Earn 1,250 NCTR just for joining during the launch period. No counter, no slot limit — available while the launch window is open.',
+    type: 'launch-bonus',
+    bounty_id: 'bounty-early-adopter',
+    active: true,
+    details: 'Launch period only. 1,250 NCTR with 360LOCK. Open to all new members.'
+  },
+  {
+    name: 'Early Referral Bonus',
+    description: 'During the launch period, earn 500 NCTR for each friend you refer (instead of standard 100 NCTR post-launch).',
+    type: 'referral-boost',
+    bounty_id: 'bounty-early-referral',
+    active: true,
+    details: 'Launch period only. 5x the standard referral rate. No cap on referrals.'
+  }
+]
+
+// ─────────────────────────────────────────────────────────────
+// MCP SERVER
+// ─────────────────────────────────────────────────────────────
+
+const app = new Hono()
+
+const server = new McpServer({
+  name: 'nctr-alliance',
+  version: '1.0.0',
+})
+
+// ── Tool 1: search_bounties ──
+
+server.registerTool(
+  'search_bounties',
+  {
+    title: 'Search Bounties',
+    description:
+      'Search and filter available NCTR bounties. Filter by category (entry, revenue, merch, referral, engagement), minimum/maximum NCTR amount, or keyword. Returns bounty details including name, amount, lock period, and requirements. All bounties use 360LOCK — tokens stay yours after the lock period.',
+    inputSchema: {
+      category: z
+        .enum(['entry', 'revenue', 'merch', 'referral', 'engagement'])
+        .optional()
+        .describe('Filter by bounty category'),
+      min_amount: z.number().optional().describe('Minimum NCTR amount'),
+      max_amount: z.number().optional().describe('Maximum NCTR amount'),
+      keyword: z
+        .string()
+        .optional()
+        .describe('Search keyword to match against bounty name, description, or tags'),
+      repeatable_only: z
+        .boolean()
+        .optional()
+        .describe('If true, only return bounties that can be earned multiple times'),
+    },
+  },
+  ({ category, min_amount, max_amount, keyword, repeatable_only }) => {
+    let results = [...BOUNTIES]
+
+    if (category) {
+      results = results.filter((b) => b.category === category)
+    }
+    if (min_amount !== undefined) {
+      results = results.filter((b) => b.amount >= min_amount)
+    }
+    if (max_amount !== undefined) {
+      results = results.filter((b) => b.amount <= max_amount)
+    }
+    if (keyword) {
+      const kw = keyword.toLowerCase()
+      results = results.filter(
+        (b) =>
+          b.name.toLowerCase().includes(kw) ||
+          b.description.toLowerCase().includes(kw) ||
+          b.tags.some((t) => t.includes(kw))
+      )
+    }
+    if (repeatable_only) {
+      results = results.filter((b) => b.repeatable)
+    }
+
+    if (results.length === 0) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: 'No bounties found matching your filters. Try broadening your search — there are 19 bounties across 5 categories.',
+          },
+        ],
+      }
+    }
+
+    const formatted = results.map((b) => ({
+      id: b.id,
+      name: b.name,
+      category: b.category,
+      amount: `${b.amount.toLocaleString()} NCTR`,
+      lock: b.lock_period,
+      repeatable: b.repeatable,
+      description: b.description,
+      requirements: b.requirements,
+    }))
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              total: results.length,
+              bounties: formatted,
+              note: 'All bounties use 360LOCK (exactly 360 days). Tokens are committed, not spent — they stay yours after the lock period.',
+            },
+            null,
+            2
+          ),
+        },
+      ],
+    }
+  }
+)
+
+// ── Tool 2: get_earning_rates ──
+
+server.registerTool(
+  'get_earning_rates',
+  {
+    title: 'Get Earning Rates',
+    description:
+      'Get NCTR earning rates for a specific Crescendo status tier, or compare all tiers. Shows the multiplier applied to bounty earnings at each tier level. Higher tiers earn more NCTR per bounty.',
+    inputSchema: {
+      tier: z
+        .enum(['Bronze', 'Silver', 'Gold', 'Platinum', 'Diamond'])
+        .optional()
+        .describe('Specific tier to check. Omit to see all tiers.'),
+      bounty_id: z
+        .string()
+        .optional()
+        .describe('Optional bounty ID to calculate tier-adjusted earning amount'),
+    },
+  },
+  ({ tier, bounty_id }) => {
+    let tiers = [...TIERS]
+    if (tier) {
+      tiers = tiers.filter((t) => t.name === tier)
+    }
+
+    const bounty = bounty_id ? BOUNTIES.find((b) => b.id === bounty_id) : null
+
+    const formatted = tiers.map((t) => {
+      const result: Record<string, unknown> = {
+        tier: t.name,
+        nctr_threshold: `${t.threshold.toLocaleString()} NCTR`,
+        multiplier: `${t.multiplier}x`,
+        description: t.description,
+        perks: t.perks,
+      }
+
+      if (bounty) {
+        const adjusted = Math.floor(bounty.amount * t.multiplier)
+        result.bounty_name = bounty.name
+        result.base_amount = `${bounty.amount.toLocaleString()} NCTR`
+        result.adjusted_amount = `${adjusted.toLocaleString()} NCTR`
+      }
+
+      return result
+    })
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              tiers: formatted,
+              note: 'Crescendo Status Tiers determine your earning multiplier. Lock more NCTR to progress through tiers and earn more on every bounty.',
+            },
+            null,
+            2
+          ),
+        },
+      ],
+    }
+  }
+)
+
+// ── Tool 3: check_tier_requirements ──
+
+server.registerTool(
+  'check_tier_requirements',
+  {
+    title: 'Check Tier Requirements',
+    description:
+      'Check what is needed to reach a specific Crescendo status tier, or see the full progression path. Shows NCTR lock thresholds, multipliers, and perks for each tier.',
+    inputSchema: {
+      current_balance: z
+        .number()
+        .optional()
+        .describe('Current NCTR balance to check tier status and progress to next tier'),
+      target_tier: z
+        .enum(['Bronze', 'Silver', 'Gold', 'Platinum', 'Diamond'])
+        .optional()
+        .describe('Target tier to check requirements for'),
+    },
+  },
+  ({ current_balance, target_tier }) => {
+    if (target_tier) {
+      const tier = TIERS.find((t) => t.name === target_tier)!
+      const result: Record<string, unknown> = {
+        tier: tier.name,
+        nctr_required: `${tier.threshold.toLocaleString()} NCTR`,
+        multiplier: `${tier.multiplier}x`,
+        perks: tier.perks,
+        description: tier.description,
+      }
+
+      if (current_balance !== undefined) {
+        if (current_balance >= tier.threshold) {
+          result.status = 'QUALIFIED'
+          result.message = `You already qualify for ${tier.name} with ${current_balance.toLocaleString()} NCTR.`
+        } else {
+          const needed = tier.threshold - current_balance
+          result.status = 'NOT YET'
+          result.nctr_needed = `${needed.toLocaleString()} NCTR`
+          result.message = `You need ${needed.toLocaleString()} more NCTR to reach ${tier.name}.`
+        }
+      }
+
+      return {
+        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+      }
+    }
+
+    // Full tier progression
+    const progression = TIERS.map((t) => {
+      const result: Record<string, unknown> = {
+        tier: t.name,
+        nctr_required: `${t.threshold.toLocaleString()} NCTR`,
+        multiplier: `${t.multiplier}x`,
+        perks: t.perks,
+      }
+
+      if (current_balance !== undefined) {
+        result.qualified = current_balance >= t.threshold
+        if (current_balance < t.threshold) {
+          result.nctr_needed = `${(t.threshold - current_balance).toLocaleString()} NCTR`
+        }
+      }
+
+      return result
+    })
+
+    let current_tier = 'Bronze'
+    if (current_balance !== undefined) {
+      for (const t of [...TIERS].reverse()) {
+        if (current_balance >= t.threshold) {
+          current_tier = t.name
+          break
+        }
+      }
+    }
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              current_tier: current_balance !== undefined ? current_tier : undefined,
+              current_balance:
+                current_balance !== undefined
+                  ? `${current_balance.toLocaleString()} NCTR`
+                  : undefined,
+              progression,
+              note: 'Tiers are based on total NCTR locked. Higher tiers unlock better multipliers and exclusive perks.',
+            },
+            null,
+            2
+          ),
+        },
+      ],
+    }
+  }
+)
+
+// ── Tool 4: get_active_promotions ──
+
+server.registerTool(
+  'get_active_promotions',
+  {
+    title: 'Get Active Promotions',
+    description:
+      'Get currently active promotions, limited-time offers, and special earning opportunities in the NCTR program.',
+    inputSchema: {},
+  },
+  () => {
+    const active = PROMOTIONS.filter((p) => p.active)
+
+    if (active.length === 0) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: 'No special promotions are active right now. Check back soon — new opportunities launch regularly.',
+          },
+        ],
+      }
+    }
+
+    const formatted = active.map((p) => ({
+      name: p.name,
+      type: p.type,
+      description: p.description,
+      details: p.details,
+      related_bounty: p.bounty_id,
+    }))
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              active_promotions: formatted,
+              count: active.length,
+              note: 'Promotions are time-limited. Join now to take advantage of launch period bonuses.',
+            },
+            null,
+            2
+          ),
+        },
+      ],
+    }
+  }
+)
+
+// ── Tool 5: get_onboarding_link ──
+
+server.registerTool(
+  'get_onboarding_link',
+  {
+    title: 'Get Onboarding Link',
+    description:
+      'Generate a link for a new member to join NCTR Alliance. Optionally include a referral code. Returns the sign-up URL and a summary of what new members earn.',
+    inputSchema: {
+      referral_code: z
+        .string()
+        .optional()
+        .describe('Optional referral code to credit the referring member'),
+    },
+  },
+  ({ referral_code }) => {
+    const baseUrl = 'https://crescendo.nctr.live/join'
+    const url = referral_code ? `${baseUrl}?ref=${encodeURIComponent(referral_code)}` : baseUrl
+
+    const welcomePackage = {
+      url,
+      welcome_bounties: [
+        { name: 'Sign-Up Bounty', amount: '625 NCTR', lock: '360LOCK' },
+        { name: 'Early Adopter Bonus', amount: '1,250 NCTR', lock: '360LOCK', note: 'Launch period only' },
+        { name: 'Profile Completion Bounty', amount: '375 NCTR', lock: '360LOCK' },
+      ],
+      total_potential: '2,250 NCTR',
+      referral_code: referral_code || null,
+      note: 'New members can earn up to 2,250 NCTR just by signing up and completing their profile during the launch period. All tokens use 360LOCK — committed, not spent.',
+    }
+
+    return {
+      content: [{ type: 'text', text: JSON.stringify(welcomePackage, null, 2) }],
+    }
+  }
+)
+
+// ── Tool 6: get_impact_engines ──
+
+server.registerTool(
+  'get_impact_engines',
+  {
+    title: 'Get Impact Engines',
+    description:
+      'Discover NCTR Impact Engine communities. Impact Engines are passion-based communities within NCTR — each focused on a different lifestyle vertical. Members can join any Impact Engine to connect with like-minded people and access community-specific experiences.',
+    inputSchema: {
+      category: z
+        .string()
+        .optional()
+        .describe(
+          'Filter by category (Powersports, Lacrosse, Entertainment, Skilled Trades, Recovery, Wellness)'
+        ),
+    },
+  },
+  ({ category }) => {
+    let engines = [...IMPACT_ENGINES]
+
+    if (category) {
+      const cat = category.toLowerCase()
+      engines = engines.filter((e) => e.category.toLowerCase().includes(cat))
+    }
+
+    if (engines.length === 0) {
+      return {
+        content: [
+          {
+            type: 'text',
+            text: `No Impact Engines found for "${category}". Available categories: Powersports, Lacrosse, Entertainment, Skilled Trades, Recovery, Wellness.`,
+          },
+        ],
+      }
+    }
+
+    const formatted = engines.map((e) => ({
+      name: e.name,
+      category: e.category,
+      description: e.description,
+      status: e.status,
+    }))
+
+    return {
+      content: [
+        {
+          type: 'text',
+          text: JSON.stringify(
+            {
+              impact_engines: formatted,
+              count: engines.length,
+              bounty: 'Join any Impact Engine to earn the Impact Engine Join Bounty — 5,000 NCTR with 360LOCK.',
+              note: 'Impact Engines are passion-based communities. Each one connects people around a shared interest, with community-specific experiences and rewards.',
+            },
+            null,
+            2
+          ),
+        },
+      ],
+    }
+  }
+)
+
+// ─────────────────────────────────────────────────────────────
+// HTTP HANDLER
+// ─────────────────────────────────────────────────────────────
+
+app.get('/', (c) => {
+  return c.json({
+    name: 'NCTR Alliance MCP Server',
+    version: '1.0.0',
+    description:
+      'Model Context Protocol server for AI agents to discover and interact with the NCTR rewards program.',
+    tools: [
+      'search_bounties',
+      'get_earning_rates',
+      'check_tier_requirements',
+      'get_active_promotions',
+      'get_onboarding_link',
+      'get_impact_engines',
+    ],
+    links: {
+      website: 'https://nctr.live',
+      the_garden: 'https://thegarden.nctr.live',
+      onboarding: 'https://crescendo.nctr.live',
+      for_agents: 'https://thegarden.nctr.live/for-agents',
+      manifest: 'https://nctr.live/.well-known/nctr.json',
+    },
+  })
+})
+
+app.all('/mcp', async (c) => {
+  const transport = new WebStandardStreamableHTTPServerTransport()
+  await server.connect(transport)
+  return transport.handleRequest(c.req.raw)
+})
+
+// Health check
+app.get('/health', (c) => {
+  return c.json({ status: 'ok', timestamp: new Date().toISOString() })
+})
+
+Deno.serve(app.fetch)

package/test-mcp-server.sh

@@ -0,0 +1,197 @@
+#!/bin/bash
+# ═══════════════════════════════════════════════════════════════
+# NCTR Alliance MCP Server — Test Script
+# ═══════════════════════════════════════════════════════════════
+# Usage:
+#   bash test-mcp-server.sh                                    # Test local server
+#   bash test-mcp-server.sh https://xyz.supabase.co/functions/v1/mcp  # Test production
+# ═══════════════════════════════════════════════════════════════
+
+BASE_URL="${1:-https://yhwcaodofmbusjurawhp.supabase.co/functions/v1/mcp}"
+MCP_URL="${BASE_URL}/rpc"
+PASS=0
+FAIL=0
+
+echo ""
+echo "╔══════════════════════════════════════════════════════╗"
+echo "║   NCTR Alliance MCP Server — Test Suite             ║"
+echo "╠══════════════════════════════════════════════════════╣"
+echo "║   Target: $BASE_URL"
+echo "╚══════════════════════════════════════════════════════╝"
+echo ""
+
+# ── Helper ──
+run_test() {
+  local test_name="$1"
+  local method_name="$2"
+  local params="$3"
+  local expect_text="$4"
+
+  echo "─── Test: $test_name ───"
+
+  RESPONSE=$(curl -s -X POST "$MCP_URL" \
+    -H "Content-Type: application/json" \
+    -H "Accept: application/json, text/event-stream" \
+    -d "{
+      \"jsonrpc\": \"2.0\",
+      \"id\": 1,
+      \"method\": \"tools/call\",
+      \"params\": {
+        \"name\": \"$method_name\",
+        \"arguments\": $params
+      }
+    }")
+
+  # Extract data line from SSE response
+  DATA_LINE=$(echo "$RESPONSE" | grep "^data:" | head -1 | sed 's/^data: //')
+
+  if [ -z "$DATA_LINE" ]; then
+    # Try parsing as direct JSON (non-SSE response)
+    DATA_LINE="$RESPONSE"
+  fi
+
+  if echo "$DATA_LINE" | grep -q "$expect_text"; then
+    echo "  ✅ PASS — Found expected: $expect_text"
+    PASS=$((PASS + 1))
+  else
+    echo "  ❌ FAIL — Expected to find: $expect_text"
+    echo "  Response: $(echo "$DATA_LINE" | head -c 200)"
+    FAIL=$((FAIL + 1))
+  fi
+  echo ""
+}
+
+# ── Test 0: Health Check ──
+echo "─── Test: Health Check ───"
+HEALTH=$(curl -s "$BASE_URL/health")
+if echo "$HEALTH" | grep -q '"status":"ok"'; then
+  echo "  ✅ PASS — Server is healthy"
+  PASS=$((PASS + 1))
+else
+  echo "  ❌ FAIL — Health check failed"
+  echo "  Response: $HEALTH"
+  FAIL=$((FAIL + 1))
+fi
+echo ""
+
+# ── Test 1: Root Info ──
+echo "─── Test: Root Info Endpoint ───"
+ROOT=$(curl -s "$BASE_URL/")
+if echo "$ROOT" | grep -q "NCTR Alliance MCP Server"; then
+  echo "  ✅ PASS — Root endpoint returns server info"
+  PASS=$((PASS + 1))
+else
+  echo "  ❌ FAIL — Root endpoint missing server info"
+  FAIL=$((FAIL + 1))
+fi
+echo ""
+
+# ── Test 2: search_bounties — All Bounties ──
+run_test "search_bounties — All Bounties" \
+  "search_bounties" \
+  "{}" \
+  "total"
+
+# ── Test 3: search_bounties — Filter by Category ──
+run_test "search_bounties — Entry Category" \
+  "search_bounties" \
+  '{"category": "entry"}' \
+  "Sign-Up Bounty"
+
+# ── Test 4: search_bounties — Filter by Amount ──
+run_test "search_bounties — Min 5000 NCTR" \
+  "search_bounties" \
+  '{"min_amount": 5000}' \
+  "5,000 NCTR"
+
+# ── Test 5: search_bounties — Keyword Search ──
+run_test "search_bounties — Keyword: referral" \
+  "search_bounties" \
+  '{"keyword": "referral"}' \
+  "Referral"
+
+# ── Test 6: search_bounties — Repeatable Only ──
+run_test "search_bounties — Repeatable Only" \
+  "search_bounties" \
+  '{"repeatable_only": true}' \
+  "repeatable"
+
+# ── Test 7: get_earning_rates — All Tiers ──
+run_test "get_earning_rates — All Tiers" \
+  "get_earning_rates" \
+  "{}" \
+  "Diamond"
+
+# ── Test 8: get_earning_rates — Specific Tier ──
+run_test "get_earning_rates — Gold Tier" \
+  "get_earning_rates" \
+  '{"tier": "Gold"}' \
+  "1.5x"
+
+# ── Test 9: get_earning_rates — With Bounty Calculation ──
+run_test "get_earning_rates — Gold + First Purchase Bounty" \
+  "get_earning_rates" \
+  '{"tier": "Gold", "bounty_id": "bounty-first-purchase"}' \
+  "adjusted_amount"
+
+# ── Test 10: check_tier_requirements — Full Progression ──
+run_test "check_tier_requirements — Full Progression" \
+  "check_tier_requirements" \
+  "{}" \
+  "progression"
+
+# ── Test 11: check_tier_requirements — With Balance ──
+run_test "check_tier_requirements — Balance 3000 NCTR" \
+  "check_tier_requirements" \
+  '{"current_balance": 3000}' \
+  "Silver"
+
+# ── Test 12: check_tier_requirements — Target Tier ──
+run_test "check_tier_requirements — Target Diamond" \
+  "check_tier_requirements" \
+  '{"target_tier": "Diamond", "current_balance": 500}' \
+  "NOT YET"
+
+# ── Test 13: get_active_promotions ──
+run_test "get_active_promotions" \
+  "get_active_promotions" \
+  "{}" \
+  "Early Adopter"
+
+# ── Test 14: get_onboarding_link — No Referral ──
+run_test "get_onboarding_link — No Referral" \
+  "get_onboarding_link" \
+  "{}" \
+  "crescendo.nctr.live/join"
+
+# ── Test 15: get_onboarding_link — With Referral ──
+run_test "get_onboarding_link — With Referral Code" \
+  "get_onboarding_link" \
+  '{"referral_code": "ANDERSON123"}' \
+  "ANDERSON123"
+
+# ── Test 16: get_impact_engines — All Engines ──
+run_test "get_impact_engines — All Engines" \
+  "get_impact_engines" \
+  "{}" \
+  "THROTTLE"
+
+# ── Test 17: get_impact_engines — Filter by Category ──
+run_test "get_impact_engines — Lacrosse" \
+  "get_impact_engines" \
+  '{"category": "Lacrosse"}' \
+  "GROUNDBALL"
+
+# ── Results ──
+echo "╔══════════════════════════════════════════════════════╗"
+echo "║   Results: $PASS passed, $FAIL failed               "
+echo "╚══════════════════════════════════════════════════════╝"
+echo ""
+
+if [ $FAIL -gt 0 ]; then
+  echo "⚠️  Some tests failed. Check the output above."
+  exit 1
+else
+  echo "All tests passed."
+  exit 0
+fi