architectgbt-mcp 0.2.4 → 0.4.0

package/README.md

@@ -7,6 +7,18 @@ Get instant AI model recommendations for your projects directly in Cursor IDE or
 [![npm version](https://img.shields.io/npm/v/architectgbt-mcp.svg)](https://www.npmjs.com/package/architectgbt-mcp)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
+## Quick Start (No Signup Required!)
+
+**Just run it** - no API key, no signup, no configuration:
+
+```bash
+npx -y architectgbt-mcp
+```
+
+You get **3 free recommendations per day** instantly. Perfect for trying it out!
+
+Want unlimited? [Upgrade to Pro](#pricing) ($15/month) and add an API key.
+
 ## Features
 
 ### 🎯 AI Model Recommendations
@@ -22,17 +34,23 @@ Get instant AI model recommendations for your projects directly in Cursor IDE or
 - **Detailed specs** (context windows, capabilities, speed rankings)
 - **Provider filtering** (OpenAI, Anthropic, Google, Meta, Mistral)
 
-### 💻 Code Templates
+### 💻 Code Templates (Pro Only)
 - **Production-ready integrations** for Anthropic, OpenAI, and Google
 - **TypeScript and Python** support
 - **Complete examples** with installation, env setup, and usage
 - **Best practices** including error handling and streaming
+- **Requires Pro subscription** ($15/month)
 
 ## Installation
 
-### Cursor IDE
+### Option 1: Anonymous (Free, No Setup)
+
+**Works immediately** - no configuration, no API key, no signup:
+
+#### Cursor IDE
 
 1. Create `.cursor/mcp.json` in your project:
+
 ```json
 {
   "mcpServers": {
@@ -45,17 +63,16 @@ Get instant AI model recommendations for your projects directly in Cursor IDE or
 ```
 
 2. Restart Cursor
+3. Ask Claude: "Recommend an AI model for my chatbot"
+4. ✅ **Works instantly** - 3 free recommendations/day
 
-3. Ask Claude:
-   - "Recommend an AI model for a customer support chatbot"
-   - "Show me all available AI models"
-   - "Give me Claude Sonnet code in TypeScript"
-
-### Claude Desktop
+#### Claude Desktop
 
-**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+1. **Open config:**
+   - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+   - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
 
-**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+2. **Add this:**
 
 ```json
 {
@@ -68,86 +85,225 @@ Get instant AI model recommendations for your projects directly in Cursor IDE or
 }
 ```
 
-### VS Code (with Continue or other MCP extensions)
+3. Restart Claude Desktop
+4. ✅ **Works instantly** - 3 free recommendations/day
+
+---
+
+### Option 2: Pro (Unlimited with API Key)
+
+Want unlimited recommendations? [Upgrade to Pro](https://architectgbt.com/pricing) then:
+
+#### Cursor IDE (Pro)
 
-Install an MCP-compatible extension, then add to settings:
+1. Create `.cursor/mcp.json`:
 
 ```json
 {
-  "mcp.servers": {
+  "mcpServers": {
     "architectgbt": {
       "command": "npx",
-      "args": ["-y", "architectgbt-mcp@latest"]
+      "args": ["-y", "architectgbt-mcp@latest"],
+      "env": {
+        "ARCHITECTGBT_API_KEY": "agbt_your_key_here"
+      }
     }
   }
 }
 ```
 
-### Zed Editor
+2. Get API key from [Settings](https://architectgbt.com/dashboard/settings)
+3. Replace `agbt_your_key_here` with your key
+4. Restart Cursor
+5. ✅ **Unlimited recommendations**
 
-Add to `~/.config/zed/settings.json`:
+#### Claude Desktop (Pro)
+
+1. **Open config:**
+   - **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+   - **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+
+2. **Edit the config:**
 
 ```json
 {
-  "context_servers": {
+  "mcpServers": {
     "architectgbt": {
       "command": "npx",
-      "args": ["-y", "architectgbt-mcp@latest"]
+      "args": ["-y", "architectgbt-mcp@latest"],
+      "env": {
+        "ARCHITECTGBT_API_KEY": "agbt_your_key_here"
+      }
     }
   }
 }
 ```
 
-### Any MCP-Compatible Client
+3. Get API key from [Settings](https://architectgbt.com/dashboard/settings)
+4. Replace `agbt_your_key_here` with your key
+5. Restart Claude Desktop
+6. ✅ **Unlimited recommendations**
 
-This server follows the [Model Context Protocol](https://modelcontextprotocol.io) standard and works with any MCP-compatible client. Run it via stdio:
+5. **Test it** - Look for 🔌 icon in bottom right, then ask:
+   - "Show me all available AI models"
 
-```bash
-npx architectgbt-mcp@latest
+---
+
+## Usage & Prompting Guide
+
+**ArchitectGBT has 3 tools** - here's how to use each one effectively:
+
+### 🎯 Get AI Recommendations (Rate Limited)
+
+**What it does:** AI-powered analysis to recommend the best model for your project.
+
+**Free tier limit:** 3 per day (anonymous users)
+
+**How to prompt:**
+```
+✅ "Recommend an AI model for building a customer support chatbot"
+✅ "What's the best model for analyzing legal documents with 50k context?"
+✅ "I need a fast, cheap model for sentiment analysis - recommend one"
+✅ "Use get_ai_recommendation to find a model for my project"
+```
+
+**What triggers it:**
+- Asking for "recommendations" or "best model for..."
+- Describing a project and asking "what model should I use?"
+- Explicitly saying "get_ai_recommendation"
+
+---
+
+### 💻 Get Code Templates (Pro Only)
+
+**What it does:** Returns production-ready code snippets for integrating specific AI models.
+
+**Tier requirement:** Pro subscription required
+
+**How to prompt:**
+```
+✅ "Give me code to integrate Claude in TypeScript"
+✅ "Show me how to use GPT-4 in Python"
+✅ "Get me a template for Gemini integration"
+✅ "I need example code for calling Anthropic's API"
 ```
 
-### With API Key (Unlimited Access)
+**What triggers it:**
+- Asking for "code", "template", "example", "integration"
+- Mentioning a specific model + language
+- Wanting implementation help
+
+---
 
-Add your API key to any config above:
+### 📊 List All Models (Unlimited)
+
+**What it does:** Shows all 50+ AI models with pricing and specs.
+
+**Free tier limit:** Unlimited (public endpoint)
+
+**How to prompt:**
+```
+✅ "Show me all AI models"
+✅ "List models from Anthropic"
+✅ "What models are available?"
+✅ "Show me all OpenAI models with pricing"
+```
+
+**What triggers it:**
+- Asking to "list", "show all", "browse" models
+- Wanting to see pricing/specs
+- Exploring available options
+
+---
+
+**💡 Pro tip:** Only `get_ai_recommendation` counts toward your daily limit. Browse models and get code templates unlimited!
+
+### VS Code (with Continue or other MCP extensions)
+
+---
+
+### Other Editors
+
+#### VS Code (with Continue extension)
 
 ```json
 {
-  "mcpServers": {
+  "mcp.servers": {
     "architectgbt": {
       "command": "npx",
-      "args": ["-y", "architectgbt-mcp@latest"],
-      "env": {
-        "ARCHITECTGBT_API_KEY": "agbt_your_key_here"
-      }
+      "args": ["-y", "architectgbt-mcp@latest"]
     }
   }
 }
 ```
 
-## Pricing
+**For unlimited:** Add `"env": { "ARCHITECTGBT_API_KEY": "agbt_your_key" }` and [upgrade to Pro](https://architectgbt.com/pricing).
+
+#### Zed Editor
+
+Add to `~/.config/zed/settings.json`:
+
+```json
+{
+  "context_servers": {
+    "architectgbt": {
+      "command": "npx",
+      "args": ["-y", "architectgbt-mcp@latest"]
+    }
+  }
+}
+```
 
-| Tier | Recommendations | Cost | API Key |
-|------|----------------|------|---------|
-| **Free** | 3/day | $0 | Not needed |
+**For unlimited:** Add `"env": { "ARCHITECTGBT_API_KEY": "agbt_your_key" }` and [upgrade to Pro](https://architectgbt.com/pricing).
+```bash
+npx architectgbt-mcp@latest
+```
+MCP Access | Cost | Setup Required |
+|------|-----------|------|---------------|
+| **Anonymous** | 3/day | $0 | None - works instantly |
+| **Free Account** | 3/day + 10/month web | $0 | Signup only (no API key) |
+| **Pro** | Unlimited | $15-29/month | API key required |
+
+### Free Tier
+- ✅ **No signup needed** - works immediately
+- ✅ **3 recommendations/day** via MCP (IP-based)
+- ✅ **No configuration** - just `npx -y architectgbt-mcp`
+- 📈 Perfect for trying it out!
+
+### Pro Tier
+- ✅ **Unlimited recommendations** (MCP + web app)
+- ✅ **API key access** (up to 5 keys)
+- ✅ **Priority support**
+- ✅ **Advanced features**
+- 💳 [$15-29/month →](https://architectgbt.com/pricing)
+
+**Getting the free tier limit?** [Upgrade to Pro](https://architectgbt.com/pricing) for unlimited access.
 | **Pro** | Unlimited | $15/month | Required |
 
 [Get your API key →](https://architectgbt.com/dashboard/settings)
 
 ## Tools
 
-### `list_models`
-Lists all 50+ available AI models with pricing.
+### `list_models` ✅ Unlimited & Free
+
+Browse all 50+ available AI models with real-time pricing and specs.
 
+**✨ No rate limits** - use as much as you want!
+
+**How to use:**
 ```
-User: "Show me all AI models"
+You: "Show me all AI models from Anthropic"
+
+Claude will use: list_models
 
 Response:
-Available AI Models (50 total)
+Available AI Models (8 total)
 ======================================================================
 
 Anthropic:
   • Claude Haiku 4.5      $  0.80 / $  4.00 (in/out per 1M tokens)
   • Claude Sonnet 4.5     $  3.00 / $ 15.00 (in/out per 1M tokens)
+  • Claude Opus 4         $ 15.00 / $ 75.00 (in/out per 1M tokens)
   ...
 ```
 
@@ -155,11 +311,69 @@ Anthropic:
 - `provider` (optional): Filter by "OpenAI" | "Anthropic" | "Google" | "Meta" | "Mistral"
 - `limit` (optional): Number of models (default: 50)
 
-### `get_ai_recommendation`
-Get personalized AI model recommendations.
+---
+
+### `get_code_template` 🔒 Pro Feature
+
+Get production-ready code for integrating specific AI models.
+
+**⚠️ Requires API key** - Pro subscription ($15/month)
 
+**How to use:**
 ```
-User: "I need an AI for a chatbot handling 10k requests/day"
+You: "Give me TypeScript code to integrate Claude"
+
+Claude will use: get_code_template
+
+Response:
+📝 Code Template: Claude (TypeScript)
+
+### Installation
+```bash
+npm install @anthropic-ai/sdk
+```
+
+### Environment Variables
+```
+ANTHROPIC_API_KEY=your_api_key_here
+```
+
+### Code
+```typescript
+import Anthropic from '@anthropic-ai/sdk';
+
+const client = new Anthropic({
+  apiKey: process.env.ANTHROPIC_API_KEY,
+});
+
+const message = await client.messages.create({
+  model: 'claude-sonnet-4-20250514',
+  max_tokens: 1024,
+  messages: [{ role: 'user', content: 'Hello!' }],
+});
+```
+
+### Usage Example
+```typescript
+// Full implementation with error handling...
+```
+```
+
+**Parameters:**
+- `model` (required): AI model name (e.g., "Claude", "GPT-4", "Gemini")
+- `language` (optional): "typescript" or "python" (default: typescript)
+
+### `get_ai_recommendation` ⚡ Rate Limited (3/day free)
+
+Get personalized AI model recommendations with budget optimization and detailed analysis.
+
+**⚠️ This is the only rate-limited tool** - counts toward your 3/day limit.
+
+**How to use:**
+```
+You: "Recommend an AI model for a customer support chatbot handling 10k requests/day"
+
+Claude will use: get_ai_recommendation
 
 Response:
 🎯 AI Model Recommendation — Analysis Complete!
@@ -168,7 +382,7 @@ Response:
 
 Claude Haiku 4.5
 Provider: Anthropic
-Estimated Cost: $0.0240
+Estimated Cost: $0.0240/day
 Context Window: 200,000 tokens
 
 💡 Why this model?
@@ -178,14 +392,36 @@ Perfect for customer support with fast responses, strong reasoning...
   • Extremely fast (sub-second)
   • Cost-effective at scale
   ...
+
+---
+📊 Free Tier: 2/3 recommendations remaining today
+💎 Get unlimited access at https://architectgbt.com
 ```
 
-**Parameters:**
-- `prompt` (required): Your project description
-- `budget` (optional): "low" | "medium" | "high" | "unlimited"
-- `priority` (optional): "cost" | "speed" | "quality" | "balanced"
+**Free tier:** You've used 3 free recommendations today.
+
+**Options:**
+1. ✅ Wait for reset (resets every 24 hours)
+2. 📈 [Upgrade to Pro](https://architectgbt.com/pricing) for unlimited access
+
+### "API Key Invalid" (Pro users)
+
+1. Check key starts with `agbt_`
+2. Regenerate from [Settings](https://architectgbt.com/dashboard/settings)
+3. Make sure it's in the `env` section of your config
+4. Verify you're on a Pro plan
+
+### Not Working at All?
+
+**First time user:**
+- ✅ No API key needed for free tier
+- ✅ Remove the `env` section from config if present
+- ✅ Just use: `"args": ["-y", "architectgbt-mcp@latest"]`
 
-- `language` (required): "typescript" | "python"
+**Pro user:**
+- ❌ Check API key is valid
+- ❌ Ensure you've upgraded to Pro at [architectgbt.com/pricing](https://architectgbt.com/pricing)
+- ❌ Free accounts cannot use API keys
 
 ## Environment Variables
 

package/TESTING.md

@@ -2,56 +2,96 @@
 
 ## Quick Test Guide
 
-### 1. Set Your API Key
+### Option 1: Test Anonymous (No Setup)
+
+**Easiest way** - works immediately:
+
+1. **Configure Cursor IDE** - Create `.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "architectgbt": {
+      "command": "npx",
+      "args": ["-y", "architectgbt-mcp@latest"]
+    }
+  }
+}
+```
+
+2. **Restart Cursor**
+
+3. **Test it** - Ask Claude:
+   - "Show me all available AI models"
+   - "Recommend an AI model for a chatbot"
+
+✅ **Expected:** Works instantly - 3 free recommendations/day
+
+---
+
+### Option 2: Test with Pro (Unlimited)
+
+**For unlimited access** - requires Pro account:
+
+1. **Upgrade to Pro:** [architectgbt.com/pricing](https://architectgbt.com/pricing)
+
+2. **Get API Key:** [architectgbt.com/dashboard/settings](https://architectgbt.com/dashboard/settings)
+
+3. **Set Environment Variable:**
 
 **Windows (PowerShell):**
 ```powershell
-$env:ARCHITECTGBT_API_KEY = "your_api_key_here"
+$env:ARCHITECTGBT_API_KEY = "agbt_your_key_here"
 ```
 
 **macOS/Linux:**
 ```bash
-export ARCHITECTGBT_API_KEY=your_api_key_here
+export ARCHITECTGBT_API_KEY=agbt_your_key_here
 ```
 
-### 2. Configure Cursor IDE
-
-Create or edit `.cursor/mcp.json` in your project:
+4. **Configure Cursor** - Edit `.cursor/mcp.json`:
 
 ```json
 {
   "mcpServers": {
     "architectgbt": {
       "command": "npx",
-      "args": ["-y", "architectgbt-mcp@0.2.0"]
+      "args": ["-y", "architectgbt-mcp@latest"],
+      "env": {
+        "ARCHITECTGBT_API_KEY": "agbt_your_key_here"
+      }
     }
   }
 }
 ```
 
-### 3. Restart Cursor
+5. **Restart Cursor**
+
+6. **Test it** - Ask Claude same questions as above
+
+✅ **Expected:** Unlimited recommendations, no daily limits
 
-Close and reopen Cursor IDE to load the MCP server with your API key.
+---
 
-### 4. Test Commands
+## Test Commands
 
-#### Test 1: List Models
+### Test 1: List Models
 Ask Claude in Cursor:
 ```
 Show me all available AI models
 ```
 
-Expected: List of models with pricing
+Expected: List of 50+ models with pricing
 
-#### Test 2: Get Recommendation
+### Test 2: Get Recommendation
 Ask Claude:
 ```
 Recommend an AI model for building a chatbot with 100k daily users and $500/month budget
 ```
 
-Expected: Top 3 model recommendations with cost breakdown
+Expected: Top recommendations with cost breakdown
 
-#### Test 3: Get Template
+### Test 3: Get Template
 Ask Claude:
 ```
 Show me the Next.js SaaS template
@@ -59,66 +99,136 @@ Show me the Next.js SaaS template
 
 Expected: Template code and description
 
-### 5. Verify Unlimited Access
+---
 
-With your API key set:
-- ✅ No rate limits (unlimited recommendations)
-- ✅ Usage tracked in your dashboard
-- ✅ `last_used_at` updates in Settings → API Keys
+## Verify Access Level
 
-### 6. Test Without API Key
+### Anonymous/Free (No API Key)
+- ✅ First 3 requests work
+- ❌ 4th request shows rate limit error
+- ✅ Resets after 24 hours
+- ✅ No signup required
 
-Remove the environment variable:
-```powershell
-Remove-Item Env:\ARCHITECTGBT_API_KEY
-```
-
-Restart Cursor and try again:
-- ✅ First 3 requests work (anonymous tier)
-- ✅ 4th request shows rate limit error
+### Pro (With API Key)
+- ✅ Unlimited requests
+- ✅ No rate limits
+- ✅ Usage tracked in dashboard
+---
 
 ## Troubleshooting
 
-### API Key Not Working
+### Anonymous Not Working
 
-1. **Check environment variable is set:**
+**Common issue:** API key in config but not valid
+
+**Solution:**
+1. Remove the `env` section from `.cursor/mcp.json`
+2. Use just: `"args": ["-y", "architectgbt-mcp@latest"]`
+3. Restart Cursor
+4. ✅ Should work with free tier (3/day)
+
+### API Key Not Working (Pro Users)
+
+1. **Check you've upgraded:**
+   - Free accounts cannot use API keys
+   - [Upgrade to Pro](https://architectgbt.com/pricing)
+
+2. **Verify environment variable:**
    ```powershell
    echo $env:ARCHITECTGBT_API_KEY
    ```
 
-2. **Verify format:**
+3. **Check format:**
    - Must start with `agbt_`
    - Should be 37+ characters long
 
-3. **Check Cursor loaded it:**
-   - Restart Cursor after setting the variable
-   - Check Cursor's MCP logs
+4. **Regenerate key:**
+   - Go to [Settings](https://architectgbt.com/dashboard/settings)
+   - Generate new key
+   - Update config
 
-### MCP Server Not Found
+### MCP Server Not Loading
 
+**Test directly:**
 ```powershell
-# Test MCP server directly
-npx -y architectgbt-mcp@0.2.0
+npx -y architectgbt-mcp@latest
 ```
 
-### Still Getting Rate Limited
+**Common fixes:**
+- Ensure Node.js >= 18.0.0
+- Check internet connection
+- Verify JSON syntax in config
+- Restart Cursor after config changes
+## Troubleshooting
+
+### API Key Not Working
+
+1. **Check environment variable is set:**
+   ```powershell
+   echo $env:ARCHITECTGBT_API_KEY
+   ```
+
+2. **Verify format:**
+   - Must start with `agbt_`
+   - Should be 37+ characters long
+
+---
 
-- Verify API key is in environment variables
-- Check it matches the key in your dashboard
-- Ensure Cursor was restarted after setting the variable
+## Testing Checklist
 
-## Production Testing Checklist
+### Anonymous Tier
+- [ ] Works without signup
+- [ ] Works without API key
+- [ ] First 3 requests succeed
+- [ ] 4th request shows rate limit
+- [ ] Rate limit resets after 24 hours
+- [ ] Error message shows upgrade path
 
-- [ ] Anonymous access works (3/day limit)
+### Pro Tier
+- [ ] Requires Pro subscription
 - [ ] API key provides unlimited access
 - [ ] Usage count increments in dashboard
-- [ ] last_used_at updates after each request
-- [ ] Rate limit resets after 24 hours
-- [ ] All 3 tools work (list_models, get_ai_recommendation, get_template)
+- [ ] `last_used_at` updates after requests
+- [ ] All tools work (list_models, get_ai_recommendation, get_template)
+- [ ] No rate limits
+
+### General
 - [ ] Error messages are user-friendly
-- [ ] MCP works in both Cursor and Claude Desktop
+- [ ] Works in Cursor IDE
+- [ ] Works in Claude Desktop
+- [ ] Handles network errors gracefully
+
+---
+
+## API Endpoints Used
+
+### Anonymous (No API Key)
+- **GET** `https://architectgbt.com/api/models` - Public endpoint
+- **POST** `https://architectgbt.com/api/recommend/public` - Rate limited (3/day)
+
+### Pro (With API Key)
+- **GET** `https://architectgbt.com/api/models` - Public endpoint
+- **POST** `https://architectgbt.com/api/recommend` - Unlimited
+
+**Headers sent:**
+```
+Authorization: Bearer agbt_your_key_here
+Content-Type: application/json
+```
+
+---
+
+## Next Steps
+
+### For Free Users
+1. Try anonymous tier (3/day)
+2. Sign up at [architectgbt.com](https://architectgbt.com) for web access (10/month)
+3. [Upgrade to Pro](https://architectgbt.com/pricing) when ready for unlimited
 
-## API Endpoints Being Used
+### For Pro Users
+1. Monitor usage in [Settings → API Keys](https://architectgbt.com/dashboard/settings)
+2. Generate multiple keys for different projects (max 5)
+3. Share MCP setup with your team
 
 When using MCP with API key:
 - **GET** `https://architectgbt.com/api/models` - List models

package/dist/tools/get-recommendation.js

@@ -34,7 +34,7 @@ export async function handleGetRecommendation(args) {
     const input = InputSchema.parse(args);
     try {
         // Determine which endpoint to use
-        const endpoint = API_KEY ? `${API_BASE}/api/recommend` : `${API_BASE}/api/recommend/public`;
+        const endpoint = API_KEY ? `${API_BASE}/api/recommend` : `${API_BASE}/api/recommend/anonymous`;
         // Build headers
         const headers = {
             "Content-Type": "application/json",

package/dist/tools/get-template.js

@@ -1,8 +1,9 @@
 import { z } from "zod";
 import { templates } from "../templates/index.js";
+const API_KEY = process.env.ARCHITECTGBT_API_KEY;
 export const getTemplateTool = {
     name: "get_code_template",
-    description: "Get a production-ready code template for integrating a specific AI model. Returns working code with setup instructions.",
+    description: "Get production-ready code templates for integrating AI models (TypeScript & Python). Pro feature - requires API key. Free users: browse models unlimited, get 3 AI recommendations/day.",
     inputSchema: {
         type: "object",
         properties: {
@@ -25,6 +26,50 @@ const InputSchema = z.object({
 });
 export async function handleGetTemplate(args) {
     const input = InputSchema.parse(args);
+    // Check if user has API key (Pro tier)
+    if (!API_KEY) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `🔒 **Code Templates are a Pro Feature**
+
+Production-ready code templates require an ArchitectGBT Pro subscription.
+
+**What you get with Pro:**
+✅ All 12+ production code templates (TypeScript & Python)
+✅ Unlimited AI recommendations  
+✅ One-click Vercel deploy
+✅ Cost calculator & optimization
+✅ Priority support (24h)
+
+**Upgrade now:** https://architectgbt.com/pricing ($15/month)
+
+**Already Pro?**
+1. Get your API key: https://architectgbt.com/dashboard/settings
+2. Add to your MCP config:
+\`\`\`json
+{
+  "mcpServers": {
+    "architectgbt": {
+      "command": "npx",
+      "args": ["-y", "architectgbt-mcp"],
+      "env": {
+        "ARCHITECTGBT_API_KEY": "agbt_your_key_here"
+      }
+    }
+  }
+}
+\`\`\`
+3. Restart your IDE
+
+**Free tier includes:**
+✅ Browse 50+ AI models (unlimited)
+✅ 3 AI recommendations/day (no signup needed)`,
+                },
+            ],
+        };
+    }
     const modelKey = input.model.toLowerCase();
     const lang = input.language;
     // Find matching template

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "architectgbt-mcp",
-  "version": "0.2.4",
-  "description": "Model Context Protocol server for ArchitectGBT - AI architecture recommendations",
+  "version": "0.4.0",
+  "description": "Model Context Protocol server for ArchitectGBT - AI model recommendations with zero-friction onboarding",
   "type": "module",
   "bin": {
     "architectgbt-mcp": "./dist/index.js"

package/src/tools/get-recommendation.ts

@@ -41,7 +41,7 @@ export async function handleGetRecommendation(args: unknown) {
 
   try {
     // Determine which endpoint to use
-    const endpoint = API_KEY ? `${API_BASE}/api/recommend` : `${API_BASE}/api/recommend/public`;
+    const endpoint = API_KEY ? `${API_BASE}/api/recommend` : `${API_BASE}/api/recommend/anonymous`;
     
     // Build headers
     const headers: HeadersInit = {

package/src/tools/get-template.ts

@@ -1,10 +1,12 @@
 import { z } from "zod";
 import { templates } from "../templates/index.js";
 
+const API_KEY = process.env.ARCHITECTGBT_API_KEY;
+
 export const getTemplateTool = {
   name: "get_code_template",
   description:
-    "Get a production-ready code template for integrating a specific AI model. Returns working code with setup instructions.",
+    "Get production-ready code templates for integrating AI models (TypeScript & Python). Pro feature - requires API key. Free users: browse models unlimited, get 3 AI recommendations/day.",
   inputSchema: {
     type: "object" as const,
     properties: {
@@ -31,6 +33,51 @@ const InputSchema = z.object({
 export async function handleGetTemplate(args: unknown) {
   const input = InputSchema.parse(args);
 
+  // Check if user has API key (Pro tier)
+  if (!API_KEY) {
+    return {
+      content: [
+        {
+          type: "text",
+          text: `🔒 **Code Templates are a Pro Feature**
+
+Production-ready code templates require an ArchitectGBT Pro subscription.
+
+**What you get with Pro:**
+✅ All 12+ production code templates (TypeScript & Python)
+✅ Unlimited AI recommendations  
+✅ One-click Vercel deploy
+✅ Cost calculator & optimization
+✅ Priority support (24h)
+
+**Upgrade now:** https://architectgbt.com/pricing ($15/month)
+
+**Already Pro?**
+1. Get your API key: https://architectgbt.com/dashboard/settings
+2. Add to your MCP config:
+\`\`\`json
+{
+  "mcpServers": {
+    "architectgbt": {
+      "command": "npx",
+      "args": ["-y", "architectgbt-mcp"],
+      "env": {
+        "ARCHITECTGBT_API_KEY": "agbt_your_key_here"
+      }
+    }
+  }
+}
+\`\`\`
+3. Restart your IDE
+
+**Free tier includes:**
+✅ Browse 50+ AI models (unlimited)
+✅ 3 AI recommendations/day (no signup needed)`,
+        },
+      ],
+    };
+  }
+
   const modelKey = input.model.toLowerCase();
   const lang = input.language;