architectgbt-mcp 0.4.0 → 0.4.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +487 -278
- package/dist/tools/get-recommendation.js +2 -2
- package/package.json +1 -1
- package/src/tools/get-recommendation.ts +2 -2
package/README.md
CHANGED
|
@@ -1,55 +1,114 @@
|
|
|
1
1
|
# ArchitectGBT MCP Server
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
AI model recommendations directly in your IDE. Compare 50+ models, get code templates, and optimize costs without leaving Cursor or Claude Desktop.
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**[Try it Free →](https://architectgbt.com)** · **[Get API Key →](https://architectgbt.com/dashboard/settings)** · **[View All Models →](https://architectgbt.com/models)**
|
|
6
|
+
|
|
7
|
+
**Resources:** [NPM Package](https://www.npmjs.com/package/architectgbt-mcp) · [GitHub Repository](https://github.com/3rdbrain/architectgbt-mcp)
|
|
6
8
|
|
|
7
9
|
[](https://www.npmjs.com/package/architectgbt-mcp)
|
|
8
10
|
[](https://opensource.org/licenses/MIT)
|
|
9
11
|
|
|
10
|
-
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Quick Start
|
|
11
15
|
|
|
12
|
-
|
|
16
|
+
No signup, no API key, no configuration needed:
|
|
13
17
|
|
|
14
18
|
```bash
|
|
15
19
|
npx -y architectgbt-mcp
|
|
16
20
|
```
|
|
17
21
|
|
|
18
|
-
|
|
22
|
+
Get 3 free AI recommendations per day to try it out.
|
|
23
|
+
|
|
24
|
+
Want unlimited access + code templates + advanced features? **[Upgrade to Pro →](https://architectgbt.com/pricing)** (starts at $15/mo)
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
## What is ArchitectGBT?
|
|
29
|
+
|
|
30
|
+
Choosing the right AI model shouldn't take hours of research. ArchitectGBT analyzes your project requirements and recommends the best model with actual cost estimates, not marketing fluff.
|
|
31
|
+
|
|
32
|
+
Instead of manually comparing pricing tables across OpenAI, Anthropic, Google, Meta, and Mistral, you get:
|
|
33
|
+
|
|
34
|
+
- AI-powered recommendations based on your project requirements
|
|
35
|
+
- Cost optimization with realistic usage estimates
|
|
36
|
+
- Model comparison across 50+ models with real-time pricing
|
|
37
|
+
- Production-ready code in TypeScript and Python
|
|
38
|
+
- Direct IDE integration via Model Context Protocol (MCP)
|
|
39
|
+
|
|
40
|
+
This MCP server brings ArchitectGBT's intelligence directly into your IDE, so you never have to leave your coding flow.
|
|
41
|
+
|
|
42
|
+
**New to ArchitectGBT?** [Explore the full platform →](https://architectgbt.com)
|
|
43
|
+
|
|
44
|
+
---
|
|
45
|
+
|
|
46
|
+
## Why This vs Cursor's Auto?
|
|
47
|
+
|
|
48
|
+
Cursor's Auto feature is great for quick model switching, but it doesn't solve the research problem:
|
|
49
|
+
|
|
50
|
+
**ArchitectGBT solves:**
|
|
51
|
+
1. **Cost planning** - Get realistic estimates before you build, not surprise bills after
|
|
52
|
+
2. **Model discovery** - Find models you didn't know existed (Mistral, Cohere, specialized models)
|
|
53
|
+
3. **Requirements matching** - Match your specific use case (context window needs, latency requirements, budget constraints)
|
|
54
|
+
4. **Production templates** - Get working integration code, not just model names
|
|
19
55
|
|
|
20
|
-
|
|
56
|
+
**When to use Cursor Auto:** Switching between models you already know
|
|
57
|
+
**When to use ArchitectGBT:** Figuring out which model to use in the first place
|
|
58
|
+
|
|
59
|
+
Think of it as research before execution. ArchitectGBT helps you make the decision, Cursor Auto helps you execute it.
|
|
60
|
+
|
|
61
|
+
---
|
|
21
62
|
|
|
22
63
|
## Features
|
|
23
64
|
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
-
|
|
39
|
-
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
-
|
|
65
|
+
| Feature | Free | Pro |
|
|
66
|
+
|---------|------|-----|
|
|
67
|
+
| **Browse 50+ AI Models** | Unlimited | Unlimited |
|
|
68
|
+
| **AI Recommendations** | 3/day | Unlimited |
|
|
69
|
+
| **Code Templates** | No | Unlimited |
|
|
70
|
+
| **Cost Calculator** | No | Yes |
|
|
71
|
+
| **API Keys** | No | Up to 5 |
|
|
72
|
+
| **Priority Support** | No | Yes |
|
|
73
|
+
|
|
74
|
+
### AI Model Recommendations
|
|
75
|
+
Get intelligent, personalized suggestions for your specific use case:
|
|
76
|
+
- Smart analysis with detailed reasoning, pros/cons, and alternatives
|
|
77
|
+
- Budget optimization (low/medium/high/unlimited budgets)
|
|
78
|
+
- Priority matching (optimize for cost, speed, quality, or balanced)
|
|
79
|
+
- Real cost estimates based on realistic token usage
|
|
80
|
+
- Alternative suggestions if your top pick doesn't fit
|
|
81
|
+
|
|
82
|
+
### Model Database (Always Free)
|
|
83
|
+
- 50+ AI models from OpenAI, Anthropic, Google, Meta, Mistral
|
|
84
|
+
- Real-time pricing per 1M tokens (input + output)
|
|
85
|
+
- Detailed specs (context windows, speed rankings, capabilities)
|
|
86
|
+
- Provider filtering to compare similar models
|
|
87
|
+
- Always updated with the latest model releases
|
|
88
|
+
|
|
89
|
+
### Code Templates (Pro Only)
|
|
90
|
+
Production-ready integration code to ship faster:
|
|
91
|
+
- Copy-paste ready for Anthropic, OpenAI, Google Gemini
|
|
92
|
+
- TypeScript & Python support
|
|
93
|
+
- Complete examples with installation, env setup, and error handling
|
|
94
|
+
- Best practices including streaming, retries, and rate limiting
|
|
95
|
+
- Saves hours of reading API docs
|
|
96
|
+
|
|
97
|
+
**[View all features on ArchitectGBT →](https://architectgbt.com)**
|
|
98
|
+
|
|
99
|
+
---
|
|
43
100
|
|
|
44
101
|
## Installation
|
|
45
102
|
|
|
46
|
-
|
|
103
|
+
Choose your editor below. No API key needed to start — upgrade to Pro later for unlimited access.
|
|
104
|
+
|
|
105
|
+
### Cursor IDE
|
|
47
106
|
|
|
48
|
-
|
|
107
|
+
Cursor has native MCP support built-in.
|
|
49
108
|
|
|
50
|
-
####
|
|
109
|
+
#### Option 1: Free (No API Key)
|
|
51
110
|
|
|
52
|
-
1. Create `.cursor/mcp.json` in your project:
|
|
111
|
+
1. Create `.cursor/mcp.json` in your project root:
|
|
53
112
|
|
|
54
113
|
```json
|
|
55
114
|
{
|
|
@@ -62,17 +121,51 @@ Want unlimited? [Upgrade to Pro](#pricing) ($15/month) and add an API key.
|
|
|
62
121
|
}
|
|
63
122
|
```
|
|
64
123
|
|
|
65
|
-
2. Restart Cursor
|
|
66
|
-
3.
|
|
67
|
-
|
|
124
|
+
2. Restart Cursor IDE
|
|
125
|
+
3. Test it — Look for the connection icon in the bottom right, then ask:
|
|
126
|
+
- "Show me all available AI models"
|
|
127
|
+
- "Recommend an AI model for my chatbot project"
|
|
128
|
+
|
|
129
|
+
You're done. You get 3 free recommendations/day.
|
|
130
|
+
|
|
131
|
+
#### Option 2: Pro (Unlimited)
|
|
68
132
|
|
|
69
|
-
|
|
133
|
+
**[Upgrade to Pro →](https://architectgbt.com/pricing)** then:
|
|
70
134
|
|
|
71
|
-
1.
|
|
135
|
+
1. Get your API key from [ArchitectGBT Dashboard](https://architectgbt.com/dashboard/settings)
|
|
136
|
+
2. Edit `.cursor/mcp.json`:
|
|
137
|
+
|
|
138
|
+
```json
|
|
139
|
+
{
|
|
140
|
+
"mcpServers": {
|
|
141
|
+
"architectgbt": {
|
|
142
|
+
"command": "npx",
|
|
143
|
+
"args": ["-y", "architectgbt-mcp@latest"],
|
|
144
|
+
"env": {
|
|
145
|
+
"ARCHITECTGBT_API_KEY": "agbt_your_key_here"
|
|
146
|
+
}
|
|
147
|
+
}
|
|
148
|
+
}
|
|
149
|
+
}
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
3. Replace `agbt_your_key_here` with your actual API key
|
|
153
|
+
4. Restart Cursor IDE
|
|
154
|
+
|
|
155
|
+
Unlimited recommendations + code templates unlocked.
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
### Claude Desktop
|
|
160
|
+
|
|
161
|
+
#### Option 1: Free (No API Key)
|
|
162
|
+
|
|
163
|
+
1. Open config file:
|
|
72
164
|
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
|
|
73
165
|
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
|
|
166
|
+
- **Linux:** `~/.config/Claude/claude_desktop_config.json`
|
|
74
167
|
|
|
75
|
-
2.
|
|
168
|
+
2. Add this configuration:
|
|
76
169
|
|
|
77
170
|
```json
|
|
78
171
|
{
|
|
@@ -86,17 +179,18 @@ Want unlimited? [Upgrade to Pro](#pricing) ($15/month) and add an API key.
|
|
|
86
179
|
```
|
|
87
180
|
|
|
88
181
|
3. Restart Claude Desktop
|
|
89
|
-
4.
|
|
90
|
-
|
|
91
|
-
|
|
182
|
+
4. Test it — Ask Claude:
|
|
183
|
+
- "List all AI models from Anthropic"
|
|
184
|
+
- "Recommend a model for document analysis"
|
|
92
185
|
|
|
93
|
-
|
|
186
|
+
You're set. You get 3 free recommendations/day.
|
|
94
187
|
|
|
95
|
-
|
|
188
|
+
#### Option 2: Pro (Unlimited)
|
|
96
189
|
|
|
97
|
-
|
|
190
|
+
**[Upgrade to Pro →](https://architectgbt.com/pricing)** then:
|
|
98
191
|
|
|
99
|
-
1.
|
|
192
|
+
1. Get your API key from [ArchitectGBT Dashboard](https://architectgbt.com/dashboard/settings)
|
|
193
|
+
2. Edit the config file (same locations as above):
|
|
100
194
|
|
|
101
195
|
```json
|
|
102
196
|
{
|
|
@@ -112,365 +206,465 @@ Want unlimited recommendations? [Upgrade to Pro](https://architectgbt.com/pricin
|
|
|
112
206
|
}
|
|
113
207
|
```
|
|
114
208
|
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
4. Restart Cursor
|
|
118
|
-
5. ✅ **Unlimited recommendations**
|
|
209
|
+
3. Replace `agbt_your_key_here` with your actual API key
|
|
210
|
+
4. Restart Claude Desktop
|
|
119
211
|
|
|
120
|
-
|
|
212
|
+
Unlimited access activated.
|
|
121
213
|
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
214
|
+
---
|
|
215
|
+
|
|
216
|
+
### Other Editors
|
|
125
217
|
|
|
126
|
-
|
|
218
|
+
#### VS Code (with Continue extension)
|
|
219
|
+
|
|
220
|
+
1. Install [Continue extension](https://marketplace.visualstudio.com/items?itemName=Continue.continue)
|
|
221
|
+
2. Add to settings:
|
|
127
222
|
|
|
128
223
|
```json
|
|
129
224
|
{
|
|
130
|
-
"
|
|
225
|
+
"mcp.servers": {
|
|
131
226
|
"architectgbt": {
|
|
132
227
|
"command": "npx",
|
|
133
|
-
"args": ["-y", "architectgbt-mcp@latest"]
|
|
134
|
-
"env": {
|
|
135
|
-
"ARCHITECTGBT_API_KEY": "agbt_your_key_here"
|
|
136
|
-
}
|
|
228
|
+
"args": ["-y", "architectgbt-mcp@latest"]
|
|
137
229
|
}
|
|
138
230
|
}
|
|
139
231
|
}
|
|
140
232
|
```
|
|
141
233
|
|
|
142
|
-
|
|
143
|
-
4. Replace `agbt_your_key_here` with your key
|
|
144
|
-
5. Restart Claude Desktop
|
|
145
|
-
6. ✅ **Unlimited recommendations**
|
|
234
|
+
**For Pro:** Add `"env": { "ARCHITECTGBT_API_KEY": "agbt_your_key" }` after [upgrading](https://architectgbt.com/pricing).
|
|
146
235
|
|
|
147
|
-
|
|
148
|
-
|
|
236
|
+
#### Zed Editor
|
|
237
|
+
|
|
238
|
+
Add to `~/.config/zed/settings.json`:
|
|
239
|
+
|
|
240
|
+
```json
|
|
241
|
+
{
|
|
242
|
+
"context_servers": {
|
|
243
|
+
"architectgbt": {
|
|
244
|
+
"command": "npx",
|
|
245
|
+
"args": ["-y", "architectgbt-mcp@latest"]
|
|
246
|
+
}
|
|
247
|
+
}
|
|
248
|
+
}
|
|
249
|
+
```
|
|
250
|
+
|
|
251
|
+
**For Pro:** Add `"env": { "ARCHITECTGBT_API_KEY": "agbt_your_key" }` after [upgrading](https://architectgbt.com/pricing).
|
|
252
|
+
|
|
253
|
+
#### Other MCP-Compatible Editors
|
|
254
|
+
|
|
255
|
+
Check [ArchitectGBT Documentation](https://architectgbt.com/docs/mcp-integration) for setup instructions.
|
|
149
256
|
|
|
150
257
|
---
|
|
151
258
|
|
|
152
|
-
## Usage
|
|
259
|
+
## Usage Guide
|
|
153
260
|
|
|
154
|
-
|
|
261
|
+
ArchitectGBT provides 3 MCP tools that work directly in your IDE:
|
|
155
262
|
|
|
156
|
-
###
|
|
263
|
+
### 1. `list_models` — Browse Models (Always Free)
|
|
157
264
|
|
|
158
|
-
|
|
265
|
+
Shows all 50+ AI models with pricing, specs, and capabilities.
|
|
159
266
|
|
|
160
|
-
**
|
|
267
|
+
**Rate limit:** Unlimited (no restrictions)
|
|
161
268
|
|
|
162
|
-
**
|
|
269
|
+
**Example prompts:**
|
|
163
270
|
```
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
271
|
+
"Show me all AI models"
|
|
272
|
+
"List models from Anthropic with pricing"
|
|
273
|
+
"What OpenAI models are available?"
|
|
274
|
+
"Compare Claude models"
|
|
168
275
|
```
|
|
169
276
|
|
|
170
|
-
**
|
|
171
|
-
-
|
|
172
|
-
-
|
|
173
|
-
-
|
|
277
|
+
**Response includes:**
|
|
278
|
+
- Model name and provider
|
|
279
|
+
- Pricing per 1M tokens (input/output)
|
|
280
|
+
- Context window size
|
|
281
|
+
- Speed ranking
|
|
282
|
+
- Key capabilities
|
|
283
|
+
|
|
284
|
+
**Tip:** Start here to explore options before asking for a recommendation.
|
|
174
285
|
|
|
175
286
|
---
|
|
176
287
|
|
|
177
|
-
###
|
|
288
|
+
### 2. `get_ai_recommendation` — AI-Powered Suggestions
|
|
178
289
|
|
|
179
|
-
|
|
290
|
+
Analyzes your project and recommends the best model with detailed reasoning.
|
|
180
291
|
|
|
181
|
-
**
|
|
292
|
+
**Rate limit:**
|
|
293
|
+
- **Free:** 3 per day (resets at midnight UTC)
|
|
294
|
+
- **Pro:** Unlimited
|
|
182
295
|
|
|
183
|
-
**
|
|
296
|
+
**Example prompts:**
|
|
184
297
|
```
|
|
185
|
-
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
298
|
+
"Recommend an AI model for a customer support chatbot handling 10k requests/day"
|
|
299
|
+
"What's the best model for analyzing legal documents with 50k tokens?"
|
|
300
|
+
"I need a fast, cheap model for sentiment analysis — recommend one"
|
|
301
|
+
"Find me a model with low latency and medium budget for a translation app"
|
|
189
302
|
```
|
|
190
303
|
|
|
191
|
-
**
|
|
192
|
-
-
|
|
193
|
-
-
|
|
194
|
-
-
|
|
304
|
+
**Response includes:**
|
|
305
|
+
- Top recommended model with match score
|
|
306
|
+
- Detailed reasoning (why it's perfect for your use case)
|
|
307
|
+
- Pros and cons
|
|
308
|
+
- Estimated daily cost
|
|
309
|
+
- Alternative suggestions
|
|
310
|
+
- Upgrade prompt if you hit the free limit
|
|
311
|
+
|
|
312
|
+
**Important:** This is the **only rate-limited tool**. Browse models (`list_models`) unlimited.
|
|
313
|
+
|
|
314
|
+
**Hit your limit?**
|
|
315
|
+
1. Wait for daily reset (midnight UTC)
|
|
316
|
+
2. **[Upgrade to Pro →](https://architectgbt.com/pricing)** for unlimited access
|
|
195
317
|
|
|
196
318
|
---
|
|
197
319
|
|
|
198
|
-
###
|
|
320
|
+
### 3. `get_code_template` — Production Code (Pro Only)
|
|
199
321
|
|
|
200
|
-
|
|
322
|
+
Returns production-ready integration code for specific AI models.
|
|
201
323
|
|
|
202
|
-
**
|
|
324
|
+
**Rate limit:**
|
|
325
|
+
- **Free:** Not available
|
|
326
|
+
- **Pro:** Unlimited
|
|
203
327
|
|
|
204
|
-
**
|
|
328
|
+
**Example prompts:**
|
|
205
329
|
```
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
330
|
+
"Give me TypeScript code to integrate Claude"
|
|
331
|
+
"Show me how to use GPT-4 in Python"
|
|
332
|
+
"Get me a Gemini integration template"
|
|
333
|
+
"I need example code for calling Anthropic's API with streaming"
|
|
210
334
|
```
|
|
211
335
|
|
|
212
|
-
**
|
|
213
|
-
-
|
|
214
|
-
-
|
|
215
|
-
-
|
|
336
|
+
**Response includes:**
|
|
337
|
+
- Installation commands
|
|
338
|
+
- Environment variable setup
|
|
339
|
+
- Complete working code
|
|
340
|
+
- Usage examples with error handling
|
|
341
|
+
|
|
342
|
+
**Not a Pro user?** Free users see an upgrade prompt with pricing.
|
|
343
|
+
|
|
344
|
+
**[Get Pro access →](https://architectgbt.com/pricing)** to unlock code templates.
|
|
216
345
|
|
|
217
346
|
---
|
|
218
347
|
|
|
219
|
-
|
|
348
|
+
### Prompting Tips
|
|
349
|
+
|
|
350
|
+
| Do | Don't |
|
|
351
|
+
|-------|----------|
|
|
352
|
+
| Be specific about your use case | Ask generic "which is best?" questions |
|
|
353
|
+
| Mention budget, volume, latency needs | Only ask for model names without context |
|
|
354
|
+
| Start with `list_models` to explore | Waste recommendations on exploratory questions |
|
|
355
|
+
| Use `get_ai_recommendation` for decisions | Ask for code without mentioning language |
|
|
220
356
|
|
|
221
|
-
|
|
357
|
+
**Pro Tip:** You can say "use the list_models tool" or "call get_ai_recommendation" to explicitly trigger a specific tool.
|
|
222
358
|
|
|
223
359
|
---
|
|
224
360
|
|
|
225
|
-
|
|
361
|
+
## Pricing & Limits
|
|
226
362
|
|
|
227
|
-
|
|
363
|
+
| Tier | Recommendations | Code Templates | Cost Calculator | API Keys | Price |
|
|
364
|
+
|------|-----------------|----------------|-----------------|----------|-------|
|
|
365
|
+
| **Free** | 3/day (MCP) + 10/month (web) | No | No | No | $0 |
|
|
366
|
+
| **Pro** | Unlimited | Unlimited | Yes | Up to 5 | **$15/mo** |
|
|
228
367
|
|
|
229
|
-
|
|
230
|
-
{
|
|
231
|
-
"mcp.servers": {
|
|
232
|
-
"architectgbt": {
|
|
233
|
-
"command": "npx",
|
|
234
|
-
"args": ["-y", "architectgbt-mcp@latest"]
|
|
235
|
-
}
|
|
236
|
-
}
|
|
237
|
-
}
|
|
238
|
-
```
|
|
368
|
+
### Free Tier
|
|
239
369
|
|
|
240
|
-
|
|
370
|
+
Perfect for trying ArchitectGBT:
|
|
371
|
+
- No signup required — works instantly
|
|
372
|
+
- 3 AI recommendations/day via MCP (IP-based rate limit)
|
|
373
|
+
- Unlimited model browsing (`list_models` tool)
|
|
374
|
+
- 10 recommendations/month on the web app
|
|
375
|
+
- Full model database access on [architectgbt.com](https://architectgbt.com)
|
|
241
376
|
|
|
242
|
-
|
|
377
|
+
**Limitations:**
|
|
378
|
+
- No code templates
|
|
379
|
+
- No cost calculator
|
|
380
|
+
- No API key access
|
|
381
|
+
- No priority support
|
|
243
382
|
|
|
244
|
-
|
|
383
|
+
**Best for:** Exploring options, comparing models, trying ArchitectGBT for personal projects.
|
|
245
384
|
|
|
246
|
-
|
|
247
|
-
{
|
|
248
|
-
"context_servers": {
|
|
249
|
-
"architectgbt": {
|
|
250
|
-
"command": "npx",
|
|
251
|
-
"args": ["-y", "architectgbt-mcp@latest"]
|
|
252
|
-
}
|
|
253
|
-
}
|
|
254
|
-
}
|
|
255
|
-
```
|
|
385
|
+
---
|
|
256
386
|
|
|
257
|
-
|
|
258
|
-
```bash
|
|
259
|
-
npx architectgbt-mcp@latest
|
|
260
|
-
```
|
|
261
|
-
MCP Access | Cost | Setup Required |
|
|
262
|
-
|------|-----------|------|---------------|
|
|
263
|
-
| **Anonymous** | 3/day | $0 | None - works instantly |
|
|
264
|
-
| **Free Account** | 3/day + 10/month web | $0 | Signup only (no API key) |
|
|
265
|
-
| **Pro** | Unlimited | $15-29/month | API key required |
|
|
387
|
+
### Pro Tier ($15/month)
|
|
266
388
|
|
|
267
|
-
|
|
268
|
-
-
|
|
269
|
-
-
|
|
270
|
-
-
|
|
271
|
-
-
|
|
389
|
+
For developers shipping to production:
|
|
390
|
+
- Unlimited AI recommendations (MCP + web app)
|
|
391
|
+
- Production-ready code templates (TypeScript + Python)
|
|
392
|
+
- Cost calculator with realistic usage estimates
|
|
393
|
+
- API key access (create up to 5 keys)
|
|
394
|
+
- Priority email support
|
|
395
|
+
- Advanced filters and comparison tools
|
|
396
|
+
- Early access to new features
|
|
272
397
|
|
|
273
|
-
|
|
274
|
-
- ✅ **Unlimited recommendations** (MCP + web app)
|
|
275
|
-
- ✅ **API key access** (up to 5 keys)
|
|
276
|
-
- ✅ **Priority support**
|
|
277
|
-
- ✅ **Advanced features**
|
|
278
|
-
- 💳 [$15-29/month →](https://architectgbt.com/pricing)
|
|
398
|
+
**Best for:** Professional developers, startups, teams building AI products.
|
|
279
399
|
|
|
280
|
-
**
|
|
281
|
-
| **Pro** | Unlimited | $15/month | Required |
|
|
400
|
+
**[Get Pro Access →](https://architectgbt.com/pricing)**
|
|
282
401
|
|
|
283
|
-
|
|
402
|
+
---
|
|
284
403
|
|
|
285
|
-
|
|
404
|
+
### Enterprise (Custom Pricing)
|
|
286
405
|
|
|
287
|
-
|
|
406
|
+
Need more? We offer:
|
|
407
|
+
- Team collaboration (shared recommendations, templates)
|
|
408
|
+
- SSO and advanced security
|
|
409
|
+
- Priority support with SLA
|
|
410
|
+
- Onboarding and training
|
|
288
411
|
|
|
289
|
-
|
|
412
|
+
**[Contact Sales →](https://architectgbt.com/contact)**
|
|
290
413
|
|
|
291
|
-
|
|
414
|
+
---
|
|
292
415
|
|
|
293
|
-
|
|
294
|
-
```
|
|
295
|
-
You: "Show me all AI models from Anthropic"
|
|
416
|
+
### Rate Limit Details
|
|
296
417
|
|
|
297
|
-
|
|
418
|
+
| Endpoint | Free | Pro |
|
|
419
|
+
|----------|------|-----|
|
|
420
|
+
| `list_models` | Unlimited | Unlimited |
|
|
421
|
+
| `get_ai_recommendation` (MCP) | 3/day | Unlimited |
|
|
422
|
+
| Web app recommendations | 10/month | Unlimited |
|
|
423
|
+
| `get_code_template` | No | Unlimited |
|
|
298
424
|
|
|
299
|
-
|
|
300
|
-
Available AI Models (8 total)
|
|
301
|
-
======================================================================
|
|
425
|
+
**Rate limit resets:** Midnight UTC daily
|
|
302
426
|
|
|
303
|
-
|
|
304
|
-
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
427
|
+
**Hit your limit?**
|
|
428
|
+
1. Wait for reset (resets every 24 hours)
|
|
429
|
+
2. Use the [web app](https://architectgbt.com) (10 free/month)
|
|
430
|
+
3. **[Upgrade to Pro](https://architectgbt.com/pricing)** for unlimited access
|
|
431
|
+
|
|
432
|
+
---
|
|
433
|
+
|
|
434
|
+
## Available Tools
|
|
435
|
+
|
|
436
|
+
This MCP server exposes 3 tools that your IDE's AI assistant can use:
|
|
437
|
+
|
|
438
|
+
### 1. `list_models`
|
|
439
|
+
|
|
440
|
+
**Description:** Browse all available AI models with pricing and specifications.
|
|
309
441
|
|
|
310
442
|
**Parameters:**
|
|
311
|
-
- `provider` (optional): Filter by "OpenAI" | "Anthropic" | "Google" | "Meta" | "Mistral"
|
|
312
|
-
- `limit` (optional):
|
|
443
|
+
- `provider` (optional): Filter by provider — `"OpenAI"` | `"Anthropic"` | `"Google"` | `"Meta"` | `"Mistral"`
|
|
444
|
+
- `limit` (optional): Max models to return (default: 50)
|
|
445
|
+
|
|
446
|
+
**Returns:**
|
|
447
|
+
- List of models with name, provider, pricing (input/output per 1M tokens), context window, speed ranking
|
|
448
|
+
|
|
449
|
+
**Rate limit:** Unlimited (always free)
|
|
313
450
|
|
|
314
451
|
---
|
|
315
452
|
|
|
316
|
-
### `
|
|
453
|
+
### 2. `get_ai_recommendation`
|
|
317
454
|
|
|
318
|
-
Get
|
|
455
|
+
**Description:** Get AI-powered model recommendations based on your project requirements.
|
|
319
456
|
|
|
320
|
-
|
|
457
|
+
**Parameters:**
|
|
458
|
+
- `projectDescription` (required): Your use case (e.g., "customer support chatbot")
|
|
459
|
+
- `budget` (optional): `"low"` | `"medium"` | `"high"` | `"unlimited"` (default: medium)
|
|
460
|
+
- `priority` (optional): `"cost"` | `"speed"` | `"quality"` | `"balanced"` (default: balanced)
|
|
321
461
|
|
|
322
|
-
**
|
|
323
|
-
|
|
324
|
-
|
|
462
|
+
**Returns:**
|
|
463
|
+
- Top recommended model with match score
|
|
464
|
+
- Detailed reasoning and analysis
|
|
465
|
+
- Pros and cons
|
|
466
|
+
- Estimated costs
|
|
467
|
+
- Alternative suggestions
|
|
325
468
|
|
|
326
|
-
|
|
469
|
+
**Rate limit:**
|
|
470
|
+
- **Free:** 3 per day (resets midnight UTC)
|
|
471
|
+
- **Pro:** Unlimited
|
|
327
472
|
|
|
328
|
-
|
|
329
|
-
📝 Code Template: Claude (TypeScript)
|
|
473
|
+
---
|
|
330
474
|
|
|
331
|
-
###
|
|
332
|
-
```bash
|
|
333
|
-
npm install @anthropic-ai/sdk
|
|
334
|
-
```
|
|
475
|
+
### 3. `get_code_template`
|
|
335
476
|
|
|
336
|
-
|
|
337
|
-
```
|
|
338
|
-
ANTHROPIC_API_KEY=your_api_key_here
|
|
339
|
-
```
|
|
477
|
+
**Description:** Get production-ready integration code for specific AI models.
|
|
340
478
|
|
|
341
|
-
|
|
342
|
-
|
|
343
|
-
|
|
479
|
+
**Parameters:**
|
|
480
|
+
- `model` (required): Model name (e.g., `"Claude"`, `"GPT-4"`, `"Gemini"`)
|
|
481
|
+
- `language` (optional): `"typescript"` | `"python"` (default: typescript)
|
|
344
482
|
|
|
345
|
-
|
|
346
|
-
|
|
347
|
-
|
|
483
|
+
**Returns:**
|
|
484
|
+
- Installation commands
|
|
485
|
+
- Environment variable setup
|
|
486
|
+
- Complete working code
|
|
487
|
+
- Usage examples with error handling
|
|
348
488
|
|
|
349
|
-
|
|
350
|
-
|
|
351
|
-
|
|
352
|
-
messages: [{ role: 'user', content: 'Hello!' }],
|
|
353
|
-
});
|
|
354
|
-
```
|
|
489
|
+
**Rate limit:**
|
|
490
|
+
- **Free:** Not available (shows upgrade prompt)
|
|
491
|
+
- **Pro:** Unlimited
|
|
355
492
|
|
|
356
|
-
|
|
357
|
-
```typescript
|
|
358
|
-
// Full implementation with error handling...
|
|
359
|
-
```
|
|
360
|
-
```
|
|
493
|
+
---
|
|
361
494
|
|
|
362
|
-
|
|
363
|
-
|
|
364
|
-
|
|
495
|
+
## Troubleshooting
|
|
496
|
+
|
|
497
|
+
### "Daily Limit Reached"
|
|
498
|
+
|
|
499
|
+
**Problem:** You've used your 3 free recommendations for today.
|
|
365
500
|
|
|
366
|
-
|
|
501
|
+
**Solutions:**
|
|
502
|
+
1. **Wait for reset** — Limits reset at midnight UTC (check countdown in response)
|
|
503
|
+
2. **Use the web app** — Get 10 more recommendations/month at [architectgbt.com](https://architectgbt.com)
|
|
504
|
+
3. **Upgrade to Pro** — Get unlimited access for $15/month → [Upgrade here](https://architectgbt.com/pricing)
|
|
367
505
|
|
|
368
|
-
|
|
506
|
+
---
|
|
507
|
+
|
|
508
|
+
### "API Key Invalid"
|
|
369
509
|
|
|
370
|
-
|
|
510
|
+
**Problem:** Your API key isn't being accepted.
|
|
371
511
|
|
|
372
|
-
**
|
|
512
|
+
**Solutions:**
|
|
513
|
+
1. **Check format** — Keys start with `agbt_` (32 characters total)
|
|
514
|
+
2. **Verify Pro status** — API keys only work for Pro subscribers → [Check subscription](https://architectgbt.com/dashboard/settings)
|
|
515
|
+
3. **Regenerate key** — Create a new key at [Settings](https://architectgbt.com/dashboard/settings)
|
|
516
|
+
4. **Check config** — Ensure key is in `env` section of your MCP config
|
|
517
|
+
5. **Restart IDE** — Changes require full restart
|
|
518
|
+
|
|
519
|
+
**Example config:**
|
|
520
|
+
```json
|
|
521
|
+
{
|
|
522
|
+
"mcpServers": {
|
|
523
|
+
"architectgbt": {
|
|
524
|
+
"command": "npx",
|
|
525
|
+
"args": ["-y", "architectgbt-mcp@latest"],
|
|
526
|
+
"env": {
|
|
527
|
+
"ARCHITECTGBT_API_KEY": "agbt_abc123xyz..."
|
|
528
|
+
}
|
|
529
|
+
}
|
|
530
|
+
}
|
|
531
|
+
}
|
|
373
532
|
```
|
|
374
|
-
You: "Recommend an AI model for a customer support chatbot handling 10k requests/day"
|
|
375
533
|
|
|
376
|
-
|
|
534
|
+
---
|
|
535
|
+
|
|
536
|
+
### MCP Server Not Loading
|
|
377
537
|
|
|
378
|
-
|
|
379
|
-
🎯 AI Model Recommendation — Analysis Complete!
|
|
538
|
+
**Problem:** Tools aren't showing up in your IDE.
|
|
380
539
|
|
|
381
|
-
|
|
540
|
+
**Solutions:**
|
|
541
|
+
1. **Check Node.js** — Requires Node.js >= 18.0.0 (`node --version`)
|
|
542
|
+
2. **Verify config** — Check JSON syntax in your MCP config file
|
|
543
|
+
3. **Restart IDE** — Full restart required after config changes
|
|
544
|
+
4. **Test manually** — Run `npx -y architectgbt-mcp@latest` in terminal
|
|
545
|
+
5. **Check network** — Verify you can access https://architectgbt.com/api/models
|
|
382
546
|
|
|
383
|
-
|
|
384
|
-
Provider: Anthropic
|
|
385
|
-
Estimated Cost: $0.0240/day
|
|
386
|
-
Context Window: 200,000 tokens
|
|
547
|
+
**For Cursor users:** Look for the connection icon in the bottom right corner
|
|
387
548
|
|
|
388
|
-
|
|
389
|
-
Perfect for customer support with fast responses, strong reasoning...
|
|
549
|
+
---
|
|
390
550
|
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
551
|
+
### Models Not Showing
|
|
552
|
+
|
|
553
|
+
**Problem:** `list_models` returns empty or errors.
|
|
554
|
+
|
|
555
|
+
**Solutions:**
|
|
556
|
+
1. **Check internet** — Test connection to https://architectgbt.com
|
|
557
|
+
2. **Verify API** — Visit https://architectgbt.com/api/models in browser
|
|
558
|
+
3. **Update package** — Run with `@latest` tag: `npx -y architectgbt-mcp@latest`
|
|
559
|
+
4. **Clear cache** — Delete `node_modules/.cache` and retry
|
|
560
|
+
|
|
561
|
+
---
|
|
562
|
+
|
|
563
|
+
### Free Tier Not Working
|
|
564
|
+
|
|
565
|
+
**Problem:** Getting errors even without API key.
|
|
566
|
+
|
|
567
|
+
**Solutions:**
|
|
568
|
+
1. **Remove API key** — Free tier doesn't need `env` section at all
|
|
569
|
+
2. **Use basic config:**
|
|
570
|
+
```json
|
|
571
|
+
{
|
|
572
|
+
"mcpServers": {
|
|
573
|
+
"architectgbt": {
|
|
574
|
+
"command": "npx",
|
|
575
|
+
"args": ["-y", "architectgbt-mcp@latest"]
|
|
576
|
+
}
|
|
577
|
+
}
|
|
578
|
+
}
|
|
579
|
+
```
|
|
580
|
+
3. **Check IP limit** — Each IP gets 3/day (shared across users on same network)
|
|
581
|
+
4. **Create free account** — Get 10 more/month on [architectgbt.com](https://architectgbt.com)
|
|
582
|
+
|
|
583
|
+
---
|
|
584
|
+
|
|
585
|
+
### Still Having Issues?
|
|
586
|
+
|
|
587
|
+
- **Email support:** hello@architectgbt.com
|
|
588
|
+
- **Documentation:** [architectgbt.com/docs/mcp-integration](https://architectgbt.com/docs/mcp-integration)
|
|
589
|
+
- **Report bugs:** [GitHub Issues](https://github.com/3rdbrain/architectgbt-mcp/issues)
|
|
395
590
|
|
|
396
591
|
---
|
|
397
|
-
|
|
398
|
-
|
|
592
|
+
|
|
593
|
+
## Environment Variables
|
|
594
|
+
|
|
595
|
+
| Variable | Required | Description |
|
|
596
|
+
|----------|----------|-------------|
|
|
597
|
+
| `ARCHITECTGBT_API_KEY` | No (Pro only) | Your API key for unlimited access (starts with `agbt_`) |
|
|
598
|
+
| `ARCHITECTGBT_API_URL` | No | Custom API endpoint (default: `https://architectgbt.com`) |
|
|
599
|
+
|
|
600
|
+
**Example:**
|
|
601
|
+
```bash
|
|
602
|
+
export ARCHITECTGBT_API_KEY="agbt_your_key_here"
|
|
399
603
|
```
|
|
400
604
|
|
|
401
|
-
|
|
605
|
+
---
|
|
402
606
|
|
|
403
|
-
|
|
404
|
-
1. ✅ Wait for reset (resets every 24 hours)
|
|
405
|
-
2. 📈 [Upgrade to Pro](https://architectgbt.com/pricing) for unlimited access
|
|
607
|
+
## Links & Support
|
|
406
608
|
|
|
407
|
-
###
|
|
609
|
+
### ArchitectGBT Platform
|
|
408
610
|
|
|
409
|
-
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
611
|
+
- **Homepage:** [architectgbt.com](https://architectgbt.com) — Explore 50+ models, compare pricing, get recommendations
|
|
612
|
+
- **Browse Models:** [architectgbt.com/models](https://architectgbt.com/models) — Full database with filters and search
|
|
613
|
+
- **Pricing:** [architectgbt.com/pricing](https://architectgbt.com/pricing) — Upgrade to Pro for unlimited access
|
|
614
|
+
- **Get API Key:** [architectgbt.com/dashboard/settings](https://architectgbt.com/dashboard/settings) — Manage keys and subscription
|
|
615
|
+
- **Documentation:** [architectgbt.com/docs/mcp-integration](https://architectgbt.com/docs/mcp-integration) — Full MCP setup guide
|
|
616
|
+
- **Blog:** [architectgbt.com/blog](https://architectgbt.com/blog) — Model comparisons, benchmarks, tutorials
|
|
413
617
|
|
|
414
|
-
###
|
|
618
|
+
### NPM Package
|
|
415
619
|
|
|
416
|
-
**
|
|
417
|
-
-
|
|
418
|
-
-
|
|
419
|
-
- ✅ Just use: `"args": ["-y", "architectgbt-mcp@latest"]`
|
|
620
|
+
- **Package:** [npmjs.com/package/architectgbt-mcp](https://www.npmjs.com/package/architectgbt-mcp)
|
|
621
|
+
- **Version:** 0.4.0
|
|
622
|
+
- **License:** MIT
|
|
420
623
|
|
|
421
|
-
|
|
422
|
-
- ❌ Check API key is valid
|
|
423
|
-
- ❌ Ensure you've upgraded to Pro at [architectgbt.com/pricing](https://architectgbt.com/pricing)
|
|
424
|
-
- ❌ Free accounts cannot use API keys
|
|
624
|
+
### Support Channels
|
|
425
625
|
|
|
426
|
-
|
|
626
|
+
- **Email:** hello@architectgbt.com
|
|
627
|
+
- **Bug Reports:** [GitHub Issues](https://github.com/3rdbrain/architectgbt-mcp/issues)
|
|
628
|
+
- **Feature Requests:** [GitHub Discussions](https://github.com/3rdbrain/architectgbt-mcp/discussions)
|
|
629
|
+
- **Twitter/X:** [@architectgbt](https://twitter.com/architectgbt) — Updates and announcements
|
|
427
630
|
|
|
428
|
-
|
|
429
|
-
- `ARCHITECTGBT_API_URL` - Custom API URL (default: https://architectgbt.com)
|
|
631
|
+
---
|
|
430
632
|
|
|
431
|
-
##
|
|
633
|
+
## Why Use ArchitectGBT?
|
|
432
634
|
|
|
433
|
-
|
|
434
|
-
You've used 3 free recommendations. Options:
|
|
435
|
-
1. Wait for daily reset (midnight UTC)
|
|
436
|
-
2. [Get API key](https://architectgbt.com/dashboard/settings) for unlimited access
|
|
635
|
+
Save hours of research — We track 50+ models from 5 providers so you don't have to.
|
|
437
636
|
|
|
438
|
-
|
|
439
|
-
1. Check key starts with `agbt_`
|
|
440
|
-
2. Regenerate from [Settings](https://architectgbt.com/dashboard/settings)
|
|
441
|
-
3. Ensure it's in the `env` section of your config
|
|
637
|
+
Make better decisions — AI-powered recommendations based on your actual requirements, not marketing hype.
|
|
442
638
|
|
|
443
|
-
|
|
444
|
-
1. Check internet connection
|
|
445
|
-
2. Verify: https://architectgbt.com/api/models
|
|
446
|
-
3. Try: `npx architectgbt-mcp@latest` manually
|
|
639
|
+
Ship faster — Production-ready code templates eliminate boilerplate and integration headaches.
|
|
447
640
|
|
|
448
|
-
|
|
449
|
-
1. Node.js >= 18.0.0 required
|
|
450
|
-
2. Check config JSON syntax
|
|
451
|
-
3. Restart Cursor after changes
|
|
641
|
+
Optimize costs — Realistic cost estimates prevent budget surprises in production.
|
|
452
642
|
|
|
453
|
-
|
|
643
|
+
Stay updated — We monitor pricing changes, new releases, and deprecations across all providers.
|
|
644
|
+
|
|
645
|
+
**[Start exploring models now →](https://architectgbt.com)**
|
|
646
|
+
|
|
647
|
+
---
|
|
454
648
|
|
|
649
|
+
## Contributing
|
|
650
|
+
|
|
651
|
+
This MCP server is part of the [ArchitectGBT](https://architectgbt.com) platform. We welcome contributions.
|
|
652
|
+
|
|
653
|
+
**Development Setup:**
|
|
455
654
|
```bash
|
|
456
|
-
git clone https://github.com/
|
|
655
|
+
git clone https://github.com/3rdbrain/architectgbt-mcp.git
|
|
457
656
|
cd architectgbt-mcp
|
|
458
657
|
npm install
|
|
459
658
|
npm run build
|
|
460
659
|
npm run dev
|
|
461
660
|
```
|
|
462
661
|
|
|
463
|
-
|
|
464
|
-
|
|
465
|
-
-
|
|
466
|
-
-
|
|
467
|
-
- **API Keys**: [architectgbt.com/dashboard/settings](https://architectgbt.com/dashboard/settings)
|
|
468
|
-
- **NPM**: [npmjs.com/package/architectgbt-mcp](https://www.npmjs.com/package/architectgbt-mcp)
|
|
662
|
+
**Before submitting PRs:**
|
|
663
|
+
- Test with both Cursor and Claude Desktop
|
|
664
|
+
- Update documentation if adding features
|
|
665
|
+
- Follow existing code style
|
|
469
666
|
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
- **Email**: hello@architectgbt.com
|
|
473
|
-
- **Issues**: [GitHub](https://github.com/yourusername/architectgbt-mcp/issues)
|
|
667
|
+
---
|
|
474
668
|
|
|
475
669
|
## License
|
|
476
670
|
|
|
@@ -478,4 +672,19 @@ MIT © ArchitectGBT
|
|
|
478
672
|
|
|
479
673
|
---
|
|
480
674
|
|
|
481
|
-
|
|
675
|
+
## Acknowledgments
|
|
676
|
+
|
|
677
|
+
Built with:
|
|
678
|
+
- [Model Context Protocol (MCP)](https://modelcontextprotocol.io) by Anthropic
|
|
679
|
+
- [Cursor IDE](https://cursor.sh) and [Claude Desktop](https://claude.ai/download)
|
|
680
|
+
- TypeScript, Node.js, and the amazing open-source community
|
|
681
|
+
|
|
682
|
+
---
|
|
683
|
+
|
|
684
|
+
<div align="center">
|
|
685
|
+
|
|
686
|
+
**Built for developers who ship fast**
|
|
687
|
+
|
|
688
|
+
[Try Free](https://architectgbt.com) · [Get Pro](https://architectgbt.com/pricing) · [Read Docs](https://architectgbt.com/docs/mcp-integration)
|
|
689
|
+
|
|
690
|
+
</div>
|
|
@@ -3,13 +3,13 @@ const API_BASE = process.env.ARCHITECTGBT_API_URL || "https://architectgbt.com";
|
|
|
3
3
|
const API_KEY = process.env.ARCHITECTGBT_API_KEY;
|
|
4
4
|
export const getRecommendationTool = {
|
|
5
5
|
name: "get_ai_recommendation",
|
|
6
|
-
description: "
|
|
6
|
+
description: "Get AI model recommendations for SOFTWARE PROJECTS ONLY (web apps, APIs, chatbots, AI features, etc.). DO NOT use for physical projects, crafts, or non-software tasks. Analyzes requirements and recommends the best AI model with pricing, reasoning, and alternatives. Free tier: 3 recommendations/day. Add ARCHITECTGBT_API_KEY for unlimited access.",
|
|
7
7
|
inputSchema: {
|
|
8
8
|
type: "object",
|
|
9
9
|
properties: {
|
|
10
10
|
prompt: {
|
|
11
11
|
type: "string",
|
|
12
|
-
description: "Description of
|
|
12
|
+
description: "Description of the SOFTWARE project you want to build (e.g., 'customer support chatbot for e-commerce', 'code review AI assistant', 'document analysis API')",
|
|
13
13
|
},
|
|
14
14
|
budget: {
|
|
15
15
|
type: "string",
|
package/package.json
CHANGED
|
@@ -6,14 +6,14 @@ const API_KEY = process.env.ARCHITECTGBT_API_KEY;
|
|
|
6
6
|
export const getRecommendationTool = {
|
|
7
7
|
name: "get_ai_recommendation",
|
|
8
8
|
description:
|
|
9
|
-
"
|
|
9
|
+
"Get AI model recommendations for SOFTWARE PROJECTS ONLY (web apps, APIs, chatbots, AI features, etc.). DO NOT use for physical projects, crafts, or non-software tasks. Analyzes requirements and recommends the best AI model with pricing, reasoning, and alternatives. Free tier: 3 recommendations/day. Add ARCHITECTGBT_API_KEY for unlimited access.",
|
|
10
10
|
inputSchema: {
|
|
11
11
|
type: "object" as const,
|
|
12
12
|
properties: {
|
|
13
13
|
prompt: {
|
|
14
14
|
type: "string",
|
|
15
15
|
description:
|
|
16
|
-
"Description of
|
|
16
|
+
"Description of the SOFTWARE project you want to build (e.g., 'customer support chatbot for e-commerce', 'code review AI assistant', 'document analysis API')",
|
|
17
17
|
},
|
|
18
18
|
budget: {
|
|
19
19
|
type: "string",
|