setup-token-gate

Setup Token-Gated MCP Server

Create a complete token-gated MCP server project with the specified configuration level:

• basic: Minimal setup with one protected tool
• full: Complete setup with multiple tiers and examples
• testnet: Configured for Radius Testnet deployment

Configuration: $ARGUMENTS

Tasks

1. Initialize Project

   • Create package.json with required dependencies
   • Set up TypeScript configuration
   • Create directory structure

2. Install Dependencies

   {
     "dependencies": {
       "fastmcp": "^3.0.0",
       "@radiustechsystems/mcp-sdk": "^1.0.0",
       "zod": "^3.22.0",
       "viem": "^2.31.0"
     },
     "devDependencies": {
       "@types/node": "^20.0.0",
       "tsx": "^4.0.0",
       "typescript": "^5.0.0",
       "prettier": "^3.0.0"
     }
   }
   

3. Create Server Implementation

   • Main server file with token protection
   • Example tools with different token requirements
   • Proper error handling and responses

4. Environment Configuration

   • Create .env.example with required variables
   • Set up for Radius Testnet (Chain ID: 1223953)
   • Configure debug settings

5. Create Helper Scripts

   • Development script with hot reload
   • Build script for production
   • Test script for auth flow validation

6. Documentation

   • README with setup instructions
   • Token tier documentation
   • Testing guide with ngrok

Implementation Structure

project/
├── src/
│   ├── index.ts          # Main server file
│   ├── tools/            # Tool implementations
│   ├── config/           # Configuration
│   └── types/            # Type definitions
├── .env.example          # Environment template
├── package.json          # Dependencies
├── tsconfig.json         # TypeScript config
├── README.md             # Documentation
└── .claude/              # Claude Code config
    └── CLAUDE.md         # Project context

Based on the configuration level ($ARGUMENTS), create the appropriate setup with working examples and clear documentation.