Back to Directory/Developer Tools

io.github.Hoya25/nctr-mcp-server

NCTR Alliance rewards — search bounties, check earning rates, and discover communities.

Developer ToolsTypeScriptv1.0.1

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:

ToolWhat It Does
search_bountiesSearch and filter all 19 available bounties by category, amount, keyword, or repeatability
get_earning_ratesGet earning multipliers by Crescendo tier, with optional bounty calculations
check_tier_requirementsCheck tier thresholds, perks, and progress toward the next tier
get_active_promotionsGet current limited-time offers and launch bonuses
get_onboarding_linkGenerate a join link with optional referral code
get_impact_enginesDiscover 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

CategoryExamples
EntrySign-up (625), Early Adopter Bonus (1,250), Profile Completion (375)
RevenueFirst Purchase (2,500), Shop & Earn (250 uncapped), Quarterly Spend (5,000)
MerchCollection (5,000), Repeat (500)
ReferralFriend sign-ups (625), friend purchases (2,500), milestone bonuses
EngagementSocial shares (500), monthly activity (250), community contributions (2,000)

Crescendo Status Tiers

TierNCTR RequiredMultiplier
Bronze01.0x
Silver1,0001.2x
Gold5,0001.5x
Platinum25,0001.8x
Diamond100,0002.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

EndpointMethodDescription
/GETServer info and tool list
/healthGETHealth check
/rpcPOSTMCP 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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @hoya25/nctr-mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-hoya25-nctr-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@hoya25/nctr-mcp-server"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@hoya25/nctr-mcp-servernpm

Compatible MCP Clients

io.github.Hoya25/nctr-mcp-server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More