auxiliar-mcp 0.6.2 → 0.6.4

package/README.md

@@ -4,7 +4,7 @@ MCP server that keeps your AI agent's infrastructure knowledge current.
 
 Your agent still thinks SendGrid has a free tier. It doesn't (removed March 2025). It recommends Auth.js — which is in maintenance mode. It quotes Neon at $19/month — pricing is now usage-based from $0.
 
-**auxiliar-mcp** gives your agent current, Chrome-verified data about 69 cloud services across 16 categories.
+**auxiliar-mcp** gives your agent current, Chrome-verified data about 74 cloud services across 16 categories.
 
 ## Install
 

package/dist/data/pricing.js

@@ -15,7 +15,7 @@ export const pricing = {
             "Dedicated IP add-on: $30/month (Scale plan only, requires 500+ emails/day)",
             "Overage on Pro/Scale: $0.90 per 1,000 extra emails",
         ],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
         source: "Chrome-verified from resend.com/pricing",
     },
     "postmark": {
@@ -111,7 +111,7 @@ export const pricing = {
             "Clerk Billing add-on: 0.7% of billing volume (on top of Stripe's 2.9%+$0.30)",
             "SOC 2 report access requires Business tier ($250/month minimum)",
         ],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
         source: "Chrome-verified from clerk.com/pricing",
     },
     "auth0": {
@@ -215,7 +215,7 @@ export const pricing = {
             "Advanced MFA (Phone): $75/month first project, $10/month additional",
             "Custom domain: $10/month per project",
         ],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
         source: "Chrome-verified from supabase.com/pricing",
     },
     "neon": {
@@ -232,7 +232,7 @@ export const pricing = {
             "History/restore storage billed separately at $0.20/GB-month",
             "Extra branches beyond plan limit: $1.50/branch-month",
         ],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
         source: "Chrome-verified from neon.tech/pricing",
     },
     "planetscale": {
@@ -267,7 +267,7 @@ export const pricing = {
             "Storage overage: $0.75/GB (Developer) down to $0.45/GB (Pro)",
             "Active database overage: $0.20/DB (Developer) down to $0.025/DB (Pro)",
         ],
-        verified_date: "2026-03-28",
+        verified_date: "2026-03-30",
         source: "Chrome-verified from turso.tech/pricing",
     },
     "aws-rds": {
@@ -380,7 +380,7 @@ export const pricing = {
             "Web Analytics: $1 per 1,000 Deep Analysis checks",
             "Firewall: starting at $0.50 per 1M allowed requests",
         ],
-        verified_date: "2026-03-28",
+        verified_date: "2026-03-30",
         source: "Chrome-verified from vercel.com/pricing",
     },
     "fly": {
@@ -420,7 +420,7 @@ export const pricing = {
             "Connect (marketplace): 0.25% + $0.25 per active account/month",
             "Stablecoin payments: 1.5%",
         ],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
         source: "Chrome-verified from stripe.com/pricing",
     },
     "lemon-squeezy": {

package/dist/data/recommendations.js

@@ -7,7 +7,7 @@ export const recommendations = {
                 choose_if: "Usage-based serverless Postgres with branching, connection pooling, HA, and auth built in. Best for variable workloads.",
                 avoid_if: "You want predictable fixed monthly pricing — usage-based can be unpredictable.",
                 pricing_model: "usage-based",
-                free_tier: "0.5 GB per project, 100 CU-hrs/month, 100 projects",
+                free_tier: "0.5 GB per project, 100 CU-hrs/month per project, 100 projects, unlimited team members",
                 paid_starts_at: "~$15/mo typical (Launch tier)",
                 risks: ["350ms cold starts on free tier", "Usage-based pricing can surprise", "Acquired by Databricks — direction may shift"],
                 provision_command: "npx neonctl projects create --name my-project",
@@ -32,7 +32,7 @@ export const recommendations = {
                 key_features: ["Postgres", "branching", "connection pooling", "auto-scaling", "read replicas", "point-in-time restore", "Neon Auth"],
                 best_for_frameworks: ["nextjs", "sveltekit", "express", "remix", "fastapi", "django", "flask"],
                 default_score: 8,
-                last_reviewed: "2026-03-28",
+                last_reviewed: "2026-03-30",
             },
             {
                 slug: "supabase",
@@ -65,7 +65,7 @@ export const recommendations = {
                 key_features: ["Postgres", "auth", "storage", "realtime", "edge functions", "Row Level Security", "vector/embeddings"],
                 best_for_frameworks: ["nextjs", "sveltekit", "react", "flutter", "fastapi"],
                 default_score: 7,
-                last_reviewed: "2026-03-28",
+                last_reviewed: "2026-03-30",
             },
             {
                 slug: "turso",
@@ -96,7 +96,7 @@ export const recommendations = {
                 key_features: ["SQLite/libSQL", "embedded replicas", "zero cold starts", "multi-region", "branching"],
                 best_for_frameworks: ["sveltekit", "remix", "astro", "hono"],
                 default_score: 6,
-                last_reviewed: "2026-03-28",
+                last_reviewed: "2026-03-30",
             },
             {
                 slug: "render-postgres",
@@ -281,7 +281,7 @@ export const recommendations = {
                 key_features: ["REST API", "SMTP", "React Email", "webhooks", "inbound email", "batch sending", "templates"],
                 best_for_frameworks: ["nextjs", "express", "sveltekit", "remix", "fastapi", "django"],
                 default_score: 8,
-                last_reviewed: "2026-03-28",
+                last_reviewed: "2026-03-30",
             },
             {
                 slug: "postmark",
@@ -464,7 +464,7 @@ export const recommendations = {
                 choose_if: "Auth in 10 minutes with polished pre-built UI. 50K MRU free. Best for React/Next.js.",
                 avoid_if: "Cost-sensitive at scale (100K+ MRU), need EU data residency, or can't accept vendor lock-in.",
                 pricing_model: "per-user",
-                free_tier: "50,000 MRU",
+                free_tier: "50,000 MRU limit per app, 3 dashboard seats, up to 3 social connections",
                 paid_starts_at: "$25/mo + $0.02/MRU (Pro)",
                 risks: ["US-only data storage (no EU residency)", "$1,025/mo at 100K MRU", "Vendor lock-in"],
                 provision_command: "npm install @clerk/nextjs",
@@ -481,10 +481,10 @@ export const recommendations = {
                 edge_compatible: true,
                 migration_difficulty: "high",
                 migration_note: "User data on Clerk's servers. Password hashes may not be exportable. Full auth rewrite needed.",
-                key_features: ["pre-built UI", "social OAuth", "MFA", "passkeys", "organizations", "SAML SSO", "webhooks", "user impersonation"],
+                key_features: ["pre-built UI", "social OAuth", "MFA", "passkeys", "organizations", "SAML SSO", "webhooks", "user impersonation", "Clerk Billing (0.7% of billing volume)"],
                 best_for_frameworks: ["nextjs", "react", "remix", "express"],
                 default_score: 7,
-                last_reviewed: "2026-03-28",
+                last_reviewed: "2026-03-30",
             },
             {
                 slug: "auth0",
@@ -640,7 +640,7 @@ export const recommendations = {
                 key_features: ["preview deploys", "edge functions", "Fluid compute", "image optimization", "ISR", "analytics", "KV/blob storage"],
                 best_for_frameworks: ["nextjs", "sveltekit", "remix", "astro"],
                 default_score: 7,
-                last_reviewed: "2026-03-28",
+                last_reviewed: "2026-03-30",
             },
             {
                 slug: "railway",
@@ -764,7 +764,7 @@ export const recommendations = {
                 key_features: ["card payments", "subscriptions", "invoicing", "Checkout", "Connect (marketplace)", "Tax", "Radar (fraud)", "Terminal"],
                 best_for_frameworks: ["nextjs", "express", "sveltekit", "rails", "django", "fastapi", "flask"],
                 default_score: 9,
-                last_reviewed: "2026-03-28",
+                last_reviewed: "2026-03-30",
             },
             {
                 slug: "lemon-squeezy",

package/dist/data/risks.js

@@ -76,7 +76,7 @@ export const risks = {
             { severity: "LOW", title: "Bundle size", detail: "Clerk's React SDK adds ~50KB to your client bundle. Acceptable for most apps, but worth noting for performance-sensitive projects." },
         ],
         recent_changes: [],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
     },
     "firebase-auth": {
         provider: "Firebase Auth",
@@ -138,7 +138,7 @@ export const risks = {
             { severity: "LOW", title: "Branching is powerful but unfamiliar", detail: "Neon's database branching (like git branches for your database) is innovative but requires learning new workflows. Not all ORMs and migration tools handle it smoothly." },
         ],
         recent_changes: [],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
     },
     "paddle": {
         provider: "Paddle",
@@ -232,7 +232,7 @@ export const risks = {
             { severity: "LOW", title: "React Email requires JSX", detail: "The React Email template system is excellent but requires a JSX build step. If you're not using React, use plain HTML templates instead." },
         ],
         recent_changes: [],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
     },
     "revenuecat": {
         provider: "RevenueCat",
@@ -264,7 +264,7 @@ export const risks = {
             { severity: "LOW", title: "Payout delays for new accounts", detail: "New accounts start with 2-7 day rolling payouts. This improves over time but can cause cash flow issues early on." },
         ],
         recent_changes: [],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
     },
     "supabase-auth": {
         provider: "Supabase Auth",
@@ -287,7 +287,7 @@ export const risks = {
             { severity: "LOW", title: "Vendor lock-in despite open source", detail: "While Supabase is open source, self-hosting the full stack (Postgres + Auth + Realtime + Storage + Edge Functions) is complex. Most teams are effectively locked into the managed service." },
         ],
         recent_changes: [],
-        verified_date: "2026-03-27",
+        verified_date: "2026-03-30",
     },
     "turso": {
         provider: "Turso",
@@ -298,7 +298,7 @@ export const risks = {
             { severity: "LOW", title: "Younger ecosystem", detail: "Turso and libSQL are newer than PostgreSQL managed services. The ecosystem of tools, tutorials, and community support is smaller." },
         ],
         recent_changes: [],
-        verified_date: "2026-03-28",
+        verified_date: "2026-03-30",
     },
     "typesense": {
         provider: "Typesense",
@@ -318,6 +318,6 @@ export const risks = {
             { severity: "LOW", title: "Cold starts on serverless functions", detail: "Serverless functions can have cold starts of 200-500ms. Edge functions are faster but have runtime limitations (no Node.js APIs)." },
         ],
         recent_changes: [],
-        verified_date: "2026-03-28",
+        verified_date: "2026-03-30",
     },
 };

package/dist/server.js

@@ -9,11 +9,11 @@ import { getPricing } from "./tools/pricing.js";
 import { getRisks } from "./tools/risks.js";
 const server = new McpServer({
     name: "auxiliar",
-    version: "0.6.1",
+    version: "0.6.4",
 });
 // Tool: recommend_service
 server.tool("recommend_service", "Get a current, verified recommendation for a cloud service based on your constraints. Returns pricing, risks, provision commands, and alternatives. Data is Chrome-verified from actual service websites (not stale training data).", {
-    need: z.enum(["database", "email", "auth", "deploy", "payments", "search", "cms", "storage", "monitoring", "cache", "queues", "vector", "llm", "sms", "feature-flags", "cron"]).describe("What kind of service you need"),
+    need: z.string().max(100).describe("What kind of service you need (database, email, auth, deploy, payments, search, cms, storage, monitoring, cache, queues, vector, llm, sms, feature-flags, cron — aliases like 'llm-api', 'file-storage', 'vector-db' also work)"),
     framework: z.string().max(100).optional().describe("Your framework (nextjs, express, sveltekit, etc.)"),
     region: z.string().max(50).optional().describe("Preferred region (us, eu, etc.)"),
     budget: z.enum(["free", "cheap", "moderate", "enterprise"]).optional().describe("Budget constraint"),

package/dist/tools/analytics.d.ts

@@ -3,5 +3,6 @@
  * Non-blocking — never fails the tool call even if the API is unreachable.
  * No personal data sent — only the query parameters (service names, categories).
  * Rate-limited to 1 ping per tool per 5 seconds.
+ * Disabled by setting AUXILIAR_TELEMETRY=off environment variable.
  */
 export declare function pingApi(tool: string, params: Record<string, any>): Promise<any | null>;

package/dist/tools/analytics.js

@@ -9,9 +9,15 @@ const MIN_PING_INTERVAL_MS = 5000; // 5 seconds between pings per tool
  * Non-blocking — never fails the tool call even if the API is unreachable.
  * No personal data sent — only the query parameters (service names, categories).
  * Rate-limited to 1 ping per tool per 5 seconds.
+ * Disabled by setting AUXILIAR_TELEMETRY=off environment variable.
  */
 export async function pingApi(tool, params) {
     try {
+        // Opt-out via environment variable
+        const telemetry = process.env.AUXILIAR_TELEMETRY;
+        if (telemetry === "off" || telemetry === "false" || telemetry === "0") {
+            return null;
+        }
         // Rate limiting
         const now = Date.now();
         if (lastPingTime[tool] && now - lastPingTime[tool] < MIN_PING_INTERVAL_MS) {

package/dist/tools/pricing.js

@@ -1,14 +1,29 @@
 import { pricing } from "../data/pricing.js";
+import { recommendations } from "../data/recommendations.js";
 import { pingApi } from "./analytics.js";
 export async function getPricing(params) {
     // Ping API for analytics (non-blocking)
     pingApi("pricing", { service: params.service }).catch(() => { });
     const slug = params.service.toLowerCase();
     const data = pricing[slug];
-    if (!data) {
-        return {
-            error: `No pricing data for "${slug}". Check auxiliar.ai for supported services.`,
-        };
+    if (data) {
+        return data;
     }
-    return data;
+    // Fallback: extract basic pricing from recommendations data
+    for (const category of Object.values(recommendations)) {
+        const svc = category.services?.find((s) => s.slug === slug);
+        if (svc) {
+            return {
+                provider: svc.name,
+                pricing_model: svc.pricing_model,
+                free_tier: svc.free_tier,
+                paid_starts_at: svc.paid_starts_at,
+                note: "Basic pricing from recommendation data. Detailed tier breakdown not yet verified for this service.",
+                verified_date: svc.last_reviewed,
+            };
+        }
+    }
+    return {
+        error: `No pricing data for "${slug}". Check auxiliar.ai for supported services.`,
+    };
 }

package/dist/tools/setup.d.ts

@@ -25,5 +25,6 @@ interface SetupResult {
 }
 export declare function setupService(params: SetupParams): Promise<SetupResult | {
     error: string;
+    basic_info?: any;
 }>;
 export {};

package/dist/tools/setup.js

@@ -285,10 +285,32 @@ const setupGuides = {
 export async function setupService(params) {
     const slug = params.provider.toLowerCase();
     const guideFn = setupGuides[slug];
-    if (!guideFn) {
-        return {
-            error: `No setup guide for "${slug}". Supported: neon, resend, supabase, vercel, better-auth, clerk, stripe, railway, turso, fly`,
-        };
+    if (guideFn) {
+        return guideFn(params);
     }
-    return guideFn(params);
+    // Fallback: extract basic setup info from recommendations data
+    try {
+        const { recommendations } = await import("../data/recommendations.js");
+        for (const category of Object.values(recommendations)) {
+            const svc = category.services?.find((s) => s.slug === slug);
+            if (svc) {
+                return {
+                    error: `No detailed setup guide for "${slug}" yet.`,
+                    basic_info: {
+                        provider: svc.name,
+                        install_command: svc.provision_command || null,
+                        cli_available: svc.has_cli || false,
+                        cli_install: svc.cli_install || null,
+                        mcp_available: svc.has_mcp || false,
+                        mcp_note: svc.mcp_note || null,
+                        note: "Basic info from recommendation data. Full setup guide not yet available for this service.",
+                    },
+                };
+            }
+        }
+    }
+    catch { }
+    return {
+        error: `No setup guide for "${slug}". Detailed guides available for: neon, resend, supabase, vercel, better-auth, clerk, stripe, railway, turso, fly`,
+    };
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "auxiliar-mcp",
-  "version": "0.6.2",
-  "description": "MCP server that keeps your AI agent's infrastructure knowledge current. Chrome-verified pricing, risk flags, compatibility checks, and setup guides for 69 cloud services.",
+  "version": "0.6.4",
+  "description": "MCP server that keeps your AI agent's infrastructure knowledge current. Chrome-verified pricing, risk flags, compatibility checks, and setup guides for 74 cloud services.",
   "type": "module",
   "main": "dist/server.js",
   "bin": {
@@ -13,6 +13,7 @@
   ],
   "scripts": {
     "build": "tsc && chmod +x dist/server.js",
+    "test": "node --import tsx test.ts",
     "dev": "tsc --watch",
     "start": "node dist/server.js",
     "prepublishOnly": "npm run build"
@@ -43,10 +44,12 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.1"
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.8.0"
   }
 }