architectgbt-mcp 0.1.2 → 0.2.0

package/README.md

@@ -14,19 +14,21 @@ Get instant AI model recommendations without leaving your IDE.
 
 ### For Cursor
 
-Add to your `~/.cursor/mcp.json`:
+Add to your `~/.cursor/mcp.json` (or `C:\Users\YourName\.cursor\mcp.json` on Windows):
 
 ```json
 {
   "mcpServers": {
     "architectgbt": {
       "command": "npx",
-      "args": ["architectgbt-mcp"]
+      "args": ["-y", "architectgbt-mcp"]
     }
   }
 }
 ```
 
+**Important:** Restart Cursor completely after adding the configuration.
+
 ### For Claude Desktop
 
 Add to your Claude Desktop config (`%APPDATA%\Claude\claude_desktop_config.json` on Windows):
@@ -59,32 +61,102 @@ Add to your MCP configuration:
 
 ## Available Tools
 
-### `get_ai_recommendation`
+### `list_models`
 
-Get personalized AI model recommendations based on your project description.
+List available AI models with pricing information.
 
 **Example prompts:**
-- "What AI model should I use for a customer support chatbot?"
-- "Recommend a model for code generation on a budget"
-- "Best model for document analysis with 100K context?"
+- "List all Anthropic models"
+- "Show me all models"
+- "What OpenAI models are available?"
+
+**Example output:**
+```
+## 📊 Available AI Models
+
+| Model | Provider | Input $/1M | Output $/1M |
+|-------|----------|------------|-------------|
+| Claude Haiku 4.5 | Anthropic | $0.80 | $4.00 |
+| Claude Opus 4.5 | Anthropic | $15.00 | $75.00 |
+| Claude Sonnet 4.5 | Anthropic | $3.00 | $15.00 |
+| GPT-4o | OpenAI | $2.50 | $10.00 |
+| GPT-4o mini | OpenAI | $0.15 | $0.60 |
+...
+
+*Showing 10 models. Use `get_ai_recommendation` for personalized suggestions.*
+```
 
 ### `get_code_template`
 
 Get production-ready integration code for any AI model.
 
+**Supported providers:** Anthropic (Claude), OpenAI (GPT), Google (Gemini)  
+**Languages:** TypeScript, Python
+
 **Example prompts:**
 - "Give me a TypeScript template for Claude"
 - "Python code for OpenAI GPT-4"
 - "Gemini integration in TypeScript"
 
-### `list_models`
+**Example output:**
+```typescript
+// ✅ Installation
+npm install @anthropic-ai/sdk
 
-List available AI models with pricing information.
+// 🔑 Environment Variables
+ANTHROPIC_API_KEY=your_api_key_here
+
+// 📦 Code
+import Anthropic from '@anthropic-ai/sdk';
+
+const client = new Anthropic({
+  apiKey: process.env.ANTHROPIC_API_KEY,
+});
+
+const message = await client.messages.create({
+  model: 'claude-3-5-sonnet-20241022',
+  max_tokens: 1024,
+  messages: [
+    { role: 'user', content: 'Hello, Claude!' }
+  ],
+});
+
+console.log(message.content);
+
+// 💡 Usage Tips
+// - Use streaming for real-time responses
+// - Add system prompts for better control
+// - Handle rate limits with retries
+```
+
+### `get_ai_recommendation`
+
+Get personalized AI model recommendations based on your project description.
+
+**Note:** Requires authentication. For full recommendations with cost analysis and reasoning, visit [architectgbt.com](https://architectgbt.com) and sign up for a free account.
 
 **Example prompts:**
-- "List all Anthropic models"
-- "Show me the cheapest models"
-- "What OpenAI models are available?"
+- "What AI model should I use for a customer support chatbot?"
+- "Recommend a model for code generation on a budget"
+- "Best model for document analysis with 100K context?"
+
+**Example response:**
+```
+❌ Authentication Required
+
+The ArchitectGBT API requires authentication. To get AI model recommendations:
+
+1. Visit https://architectgbt.com
+2. Sign up for a free account (free tier available!)
+3. Use the website directly for personalized recommendations
+
+Alternatively, you can:
+- Use `list_models` to browse available models
+- Use `get_code_template` to get integration code for any model
+
+For your query: "customer support chatbot"
+I recommend visiting the website for a personalized analysis with cost estimates and reasoning.
+```
 
 ## Development
 

package/dist/tools/get-recommendation.js

@@ -1,8 +1,9 @@
 import { z } from "zod";
 const API_BASE = process.env.ARCHITECTGBT_API_URL || "https://architectgbt.com";
+const API_KEY = process.env.ARCHITECTGBT_API_KEY;
 export const getRecommendationTool = {
     name: "get_ai_recommendation",
-    description: "Analyze a project description and recommend the best AI model with pricing, reasoning, and alternatives. Use this when someone asks which AI model to use for their project. Note: This uses the public ArchitectGBT website - users should visit architectgbt.com and sign up for full API access.",
+    description: "Analyze a project description and recommend the best AI model with pricing, reasoning, and alternatives. Free tier: 3 recommendations/day. Add ARCHITECTGBT_API_KEY for unlimited access.",
     inputSchema: {
         type: "object",
         properties: {
@@ -32,11 +33,19 @@ const InputSchema = z.object({
 export async function handleGetRecommendation(args) {
     const input = InputSchema.parse(args);
     try {
-        const response = await fetch(`${API_BASE}/api/recommend`, {
+        // Determine which endpoint to use
+        const endpoint = API_KEY ? `${API_BASE}/api/recommend` : `${API_BASE}/api/recommend/public`;
+        // Build headers
+        const headers = {
+            "Content-Type": "application/json",
+        };
+        // Add API key if available
+        if (API_KEY) {
+            headers["Authorization"] = `Bearer ${API_KEY}`;
+        }
+        const response = await fetch(endpoint, {
             method: "POST",
-            headers: {
-                "Content-Type": "application/json",
-            },
+            headers,
             body: JSON.stringify({
                 prompt: input.prompt,
                 budget: input.budget,
@@ -44,13 +53,27 @@ export async function handleGetRecommendation(args) {
             }),
         });
         if (!response.ok) {
+            // Handle rate limiting for free tier
+            if (response.status === 429) {
+                const data = await response.json();
+                const resetHeader = response.headers.get('X-RateLimit-Reset');
+                const resetTime = resetHeader ? new Date(resetHeader).toLocaleString() : 'tomorrow';
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `🚫 **Daily Limit Reached**\n\n${data.error?.message || 'You\'ve used all 3 free recommendations today.'}\n\nResets at: ${resetTime}\n\n**Get unlimited access:**\n1. Visit https://architectgbt.com\n2. Sign up for free (10 recommendations/month)\n3. Generate an API key from Settings\n4. Add to your MCP config:\n\`\`\`json\n{\n  "mcpServers": {\n    "architectgbt": {\n      "command": "npx",\n      "args": ["-y", "architectgbt-mcp"],\n      "env": {\n        "ARCHITECTGBT_API_KEY": "your_api_key_here"\n      }\n    }\n  }\n}\n\`\`\`\n\n💡 Pro tip: Upgrade to Pro ($15/mo) for unlimited recommendations!`,
+                        },
+                    ],
+                };
+            }
             // Handle authentication requirement
-            if (response.status === 401) {
+            if (response.status === 401 || response.status === 405) {
                 return {
                     content: [
                         {
                             type: "text",
-                            text: `❌ **Authentication Required**\n\nThe ArchitectGBT API requires authentication. To get AI model recommendations:\n\n1. Visit https://architectgbt.com\n2. Sign up for a free account\n3. Use the website directly for personalized recommendations\n\nAlternatively, you can:\n- Use \`list_models\` to browse available models\n- Use \`get_code_template\` to get integration code for any model\n\nFor your query: "${input.prompt}"\nI recommend visiting the website for a personalized analysis.`,
+                            text: `❌ **API Key Invalid or Expired**\n\nYour API key is not valid. To fix this:\n\n1. Visit https://architectgbt.com/settings\n2. Generate a new API key\n3. Update your MCP config\n\n**Without an API key:**\nYou can still use the free tier (3 recommendations/day). Remove the ARCHITECTGBT_API_KEY from your config.`,
                         },
                     ],
                 };
@@ -58,8 +81,15 @@ export async function handleGetRecommendation(args) {
             throw new Error(`API error: ${response.status}`);
         }
         const data = await response.json();
+        // Show rate limit info if present
+        const remaining = response.headers.get('X-RateLimit-Remaining');
+        const limit = response.headers.get('X-RateLimit-Limit');
         // Format the response nicely
-        const result = formatRecommendation(data);
+        let result = formatRecommendation(data);
+        // Add rate limit footer for free tier
+        if (remaining !== null && limit !== null && !API_KEY) {
+            result += `\n\n---\n📊 **Free Tier:** ${remaining}/${limit} recommendations remaining today\n💎 Get unlimited access at https://architectgbt.com`;
+        }
         return {
             content: [{ type: "text", text: result }],
         };

package/dist/tools/list-models.js

@@ -53,7 +53,10 @@ export async function handleListModels(args) {
         result += `| Model | Provider | Input $/1M | Output $/1M |\n`;
         result += `|-------|----------|------------|-------------|\n`;
         models.forEach((m) => {
-            result += `| ${m.name} | ${m.provider} | $${m.input_price || "?"} | $${m.output_price || "?"} |\n`;
+            // Convert per-1K pricing to per-1M for display
+            const inputPer1M = m.input_cost_per_1k ? (m.input_cost_per_1k * 1000).toFixed(2) : "?";
+            const outputPer1M = m.output_cost_per_1k ? (m.output_cost_per_1k * 1000).toFixed(2) : "?";
+            result += `| ${m.name} | ${m.provider} | $${inputPer1M} | $${outputPer1M} |\n`;
         });
         result += `\n*Showing ${models.length} models. Use \`get_ai_recommendation\` for personalized suggestions.*`;
         return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "architectgbt-mcp",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "MCP server for AI model recommendations from ArchitectGBT",
   "type": "module",
   "main": "dist/index.js",