Skip to content

Hoya25/mcp-server

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

License

MIT

About

MCP server for the NCTR Alliance rewards program. Enables AI agents to discover bounties, earning rates, tier requirements, promotions, and Impact Engine communities.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors