@mcp-catalog/vinkius 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vinkius
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,187 @@
+# @mcp-catalog/vinkius
+
+**Unlock apps and data for your agents — instantly.** One stdio connection arms your AI agent with 2,000+ hardened, governed MCP servers from [Vinkius AI Gateway](https://vinkius.com) from day one.
+
+No more juggling dozens of MCP configs. Your agent connects once, then **searches, activates, and orchestrates** any server from the App Catalog in real time.
+
+---
+
+## Why this exists
+
+Every AI agent today faces the same bottleneck: **tool access.** You need GitHub for code, Stripe for payments, Salesforce for CRM, Snowflake for analytics, FRED for economic data — and each one requires a separate MCP server config, separate credentials, separate maintenance.
+
+**Vinkius MCP Catalog solves this in one line of config.**
+
+Your agent gets a single gateway that can discover, activate, and call any of the 2,000+ production-ready MCP servers in the Vinkius App Catalog — from enterprise SaaS to government datasets to AI platforms.
+
+## What's in the catalog
+
+This isn't another list of GitHub and Slack integrations. Vinkius has done the impossible — turning every major API into a governed, production-grade MCP server:
+
+| Category | What your agent can access |
+|----------|---------------------------|
+| **Industry Titans** | Salesforce · SAP S/4HANA · Dynamics 365 · Oracle NetSuite · Okta · HubSpot CRM |
+| **Money Moves** | Stripe · PayPal · Plaid · Brex · Mercury · QuickBooks · Shopify · DocuSign |
+| **Ship It** | GitHub · GitLab · Jira · Cloudflare (25 tools!) · CircleCI · Bitbucket · Linear |
+| **AI Frontier** | OpenAI · Anthropic · NVIDIA · Databricks · Cohere · Azure AI · Amazon Bedrock |
+| **The Unthinkable** | FRED (816K+ economic series) · NOAA (36 tools) · Eurostat · U.S. Census · ECB · BLS · EIA |
+| **Fort Knox** | CrowdStrike Falcon · Snyk · CyberArk · Checkmarx · Auth0 · Black Duck |
+| **Growth Engine** | Google Ads · Meta Ads · Facebook Ads · Mailchimp · Amplitude · Ahrefs · ActiveCampaign |
+| **Talk to Me** | Slack · WhatsApp · Twilio · Zoom · Discord · Intercom · Zendesk |
+| **Brain Trust** | Snowflake · BigQuery · Notion · Confluence · Databricks · Elasticsearch |
+| **Superpower** | Midjourney · Wolfram Alpha · ArcGIS · E2B · Home Assistant · Alexa |
+| **Friends of MCP** | Firecrawl · LangSmith · LangGraph · LlamaIndex · Mem0 · Zapier · Make |
+
+> **2,000+ servers. Every vertical.** From federal reserve data to smart home control, from enterprise ERP to AI image generation.
+
+## How it works
+
+```
+┌─────────────┐     stdio      ┌──────────────────┐     HTTPS     ┌─────────────────────┐
+│  AI Agent   │ ◄────────────► │  mcp-catalog     │ ◄───────────► │  Vinkius AI Gateway │
+│  (Claude,   │                │  (this package)  │               │  API                │
+│   Cursor)   │                └──────────────────┘               └──────────┬──────────┘
+└─────────────┘                                                              │
+                    ┌────────────────────────────────────────────────────────┘
+                    ▼
+              2,000+ governed MCP servers
+              DLP · FinOps · SSRF protection on every call
+```
+
+**Two-tier architecture:**
+
+- **Meta-tools** — Always available. Search the catalog, activate servers, manage subscriptions.
+- **Proxy-tools** — Dynamically loaded from your active servers, namespaced as `{slug}__{tool_name}`.
+
+All tool execution flows through the Vinkius AI Gateway, which enforces:
+- 🔐 **Authentication** — single `vk_catalog_*` token resolves to per-server credentials transparently
+- 🛡️ **DLP Protection** — PII redaction on every API response
+- 💰 **FinOps Guard** — token budget protection via response truncation
+- 🔒 **SSRF Guard** — DNS-pinned fetches for all upstream calls
+
+## Quick start
+
+### 1. Get your catalog token
+
+1. Sign up at [cloud.vinkius.com](https://cloud.vinkius.com)
+2. Go to **Settings → Catalog Tokens**
+3. Click **"Create catalog token"** and copy the `vk_catalog_*` token
+
+### 2. Add one config block
+
+#### Claude Desktop (`claude_desktop_config.json`)
+
+```json
+{
+  "mcpServers": {
+    "vinkius-catalog": {
+      "command": "npx",
+      "args": ["-y", "@mcp-catalog/vinkius"],
+      "env": {
+        "VINKIUS_CATALOG_TOKEN": "vk_catalog_YOUR_TOKEN_HERE"
+      }
+    }
+  }
+}
+```
+
+#### Cursor (`.cursor/mcp.json`)
+
+```json
+{
+  "mcpServers": {
+    "vinkius-catalog": {
+      "command": "npx",
+      "args": ["-y", "@mcp-catalog/vinkius"],
+      "env": {
+        "VINKIUS_CATALOG_TOKEN": "vk_catalog_YOUR_TOKEN_HERE"
+      }
+    }
+  }
+}
+```
+
+### 3. Done. Your agent now has access to 2,000+ MCP servers.
+
+## Built-in tools
+
+| Tool | Description |
+|------|-------------|
+| `catalog_search` | Search by intent — "analyze U.S. inflation", "process refunds", "monitor Kubernetes" |
+| `catalog_browse` | Browse all categories and discover what's available |
+| `catalog_activate` | Subscribe to a server (free = instant, paid = checkout link) |
+| `catalog_deactivate` | Unsubscribe from a server |
+| `catalog_tools` | List all currently available tools across active servers |
+| `catalog_analytics` | View usage stats for your active subscriptions |
+
+## Example: cross-category orchestration
+
+This is what no other MCP setup can do — seamlessly switching between government data, payments, and communications in a single conversation:
+
+```
+You: I need to analyze U.S. inflation trends and correlate with our Stripe revenue
+
+Agent: [uses catalog_search("U.S. inflation economic data")]
+       Found "FRED Full Access — U.S. Economic Intelligence" (19 tools)
+       and "Bureau of Labor Statistics — The Mega Server" (5 tools)
+
+You: Activate FRED and pull CPI data for the last 2 years
+
+Agent: [uses catalog_activate("fred-full-access")]
+       ✓ FRED activated — 19 tools now available.
+       [uses fred-full-access__get_series_observations({ series_id: "CPIAUCSL", ... })]
+       CPI data retrieved: 24 monthly observations...
+
+You: Now pull our Stripe revenue for the same period
+
+Agent: [uses catalog_search("payment processing revenue")]
+       Found "Stripe" — already subscribed.
+       [uses stripe__list_balance_transactions({ created: { gte: ... } })]
+       Revenue data retrieved: $847K across 2,400 transactions...
+
+You: Great. Now send a summary to our #finance Slack channel
+
+Agent: [uses slack__send_message({ channel: "#finance", text: "..." })]
+       ✓ Summary posted to #finance
+```
+
+> **One connection. Three categories. Zero config changes.**
+
+## Environment variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `VINKIUS_CATALOG_TOKEN` | ✅ | — | Your `vk_catalog_*` authentication token |
+| `VINKIUS_API_URL` | ❌ | `https://api.vinkius.com` | API base URL (for self-hosted setups) |
+
+## Security
+
+- Your catalog token is **HMAC-SHA256 hashed** — plaintext is never stored on our servers
+- All communication with upstream APIs flows through the Vinkius AI Gateway — your agent never connects directly
+- Each activated server uses its own isolated, scoped credentials
+- Every call passes through DLP, FinOps, and SSRF protection layers
+
+## Requirements
+
+- Node.js ≥ 18
+- A [Vinkius](https://vinkius.com) account with a catalog token
+
+## Development
+
+```bash
+npm install
+VINKIUS_CATALOG_TOKEN=vk_catalog_... npm run dev   # Run locally
+npm run lint                                        # Type-check
+npm run build                                       # Production build
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE)
+
+---
+
+<p align="center">
+  <strong>The governed infrastructure for the AI era.</strong><br/>
+  <a href="https://vinkius.com">vinkius.com</a>
+</p>

package/dist/api/client.d.ts

@@ -0,0 +1,31 @@
+/**
+ * HTTP client for the Vinkius AI Gateway Catalog API.
+ *
+ * All requests are authenticated with the vk_catalog_* Bearer token.
+ * The base URL defaults to the production API but can be overridden
+ * via the VINKIUS_API_URL environment variable.
+ */
+import type { CatalogToolsResponse, CatalogExecuteResponse, CatalogSearchResponse, CatalogActivateResponse, CatalogBrowseResponse, CatalogAnalyticsResponse } from '../types.js';
+export declare class VinkiusClient {
+    private readonly baseUrl;
+    private readonly token;
+    constructor(token: string, baseUrl?: string);
+    /** GET /catalog/tools — Aggregated tool manifest. */
+    getTools(): Promise<CatalogToolsResponse>;
+    /** POST /catalog/execute — Route execution to correct upstream server. */
+    execute(toolName: string, args: Record<string, unknown>): Promise<CatalogExecuteResponse>;
+    /** GET /catalog/search — Smart search with synonym expansion. */
+    search(query: string, limit?: number): Promise<CatalogSearchResponse>;
+    /** POST /catalog/activate — Subscribe to a listing. */
+    activate(listingId: string): Promise<CatalogActivateResponse>;
+    /** POST /catalog/deactivate — Unsubscribe from a listing. */
+    deactivate(subscriptionId: string): Promise<{
+        deactivated: boolean;
+    }>;
+    /** GET /catalog/browse — Browse categories. */
+    browse(): Promise<CatalogBrowseResponse>;
+    /** GET /catalog/analytics — Usage insights. */
+    analytics(): Promise<CatalogAnalyticsResponse>;
+    private request;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/api/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACzB,MAAM,aAAa,CAAC;AAIrB,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;IAK3C,qDAAqD;IAC/C,QAAQ,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAI/C,0EAA0E;IACpE,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAO/F,iEAAiE;IAC3D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAKvE,uDAAuD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAMnE,6DAA6D;IACvD,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,WAAW,EAAE,OAAO,CAAA;KAAE,CAAC;IAM3E,+CAA+C;IACzC,MAAM,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAI9C,+CAA+C;IACzC,SAAS,IAAI,OAAO,CAAC,wBAAwB,CAAC;YAMtC,OAAO;CAyBtB"}

package/dist/api/client.js

@@ -0,0 +1,73 @@
+/**
+ * HTTP client for the Vinkius AI Gateway Catalog API.
+ *
+ * All requests are authenticated with the vk_catalog_* Bearer token.
+ * The base URL defaults to the production API but can be overridden
+ * via the VINKIUS_API_URL environment variable.
+ */
+const DEFAULT_API_URL = 'https://api.vinkius.com';
+export class VinkiusClient {
+    baseUrl;
+    token;
+    constructor(token, baseUrl) {
+        this.token = token;
+        this.baseUrl = (baseUrl ?? DEFAULT_API_URL).replace(/\/+$/, '');
+    }
+    /** GET /catalog/tools — Aggregated tool manifest. */
+    async getTools() {
+        return this.request('GET', '/catalog/tools');
+    }
+    /** POST /catalog/execute — Route execution to correct upstream server. */
+    async execute(toolName, args) {
+        return this.request('POST', '/catalog/execute', {
+            tool_name: toolName,
+            arguments: args,
+        });
+    }
+    /** GET /catalog/search — Smart search with synonym expansion. */
+    async search(query, limit = 15) {
+        const params = new URLSearchParams({ q: query, limit: String(limit) });
+        return this.request('GET', `/catalog/search?${params}`);
+    }
+    /** POST /catalog/activate — Subscribe to a listing. */
+    async activate(listingId) {
+        return this.request('POST', '/catalog/activate', {
+            listing_id: listingId,
+        });
+    }
+    /** POST /catalog/deactivate — Unsubscribe from a listing. */
+    async deactivate(subscriptionId) {
+        return this.request('POST', '/catalog/deactivate', {
+            subscription_id: subscriptionId,
+        });
+    }
+    /** GET /catalog/browse — Browse categories. */
+    async browse() {
+        return this.request('GET', '/catalog/browse');
+    }
+    /** GET /catalog/analytics — Usage insights. */
+    async analytics() {
+        return this.request('GET', '/catalog/analytics');
+    }
+    // ── Internal ──────────────────────────────────────────────────────────────
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        const headers = {
+            'Authorization': `Bearer ${this.token}`,
+            'Accept': 'application/json',
+            'User-Agent': '@mcp-catalog/vinkius',
+        };
+        const init = { method, headers };
+        if (body) {
+            headers['Content-Type'] = 'application/json';
+            init.body = JSON.stringify(body);
+        }
+        const response = await fetch(url, init);
+        if (!response.ok) {
+            const text = await response.text().catch(() => 'Unknown error');
+            throw new Error(`Vinkius API ${method} ${path} returned ${response.status}: ${text}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/api/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/api/client.ts"],"names":[],"mappings":"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"}

package/dist/engine/router.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Tool name router for the MCP Catalog.
+ *
+ * Handles the bidirectional mapping between:
+ *   - Namespaced MCP tool names: `{listing_slug}__{tool_name}`
+ *   - Upstream server slugs and their raw tool names
+ */
+/** Parse a namespaced tool name into its server slug and real tool name. */
+export declare function parseToolName(namespacedName: string): {
+    slug: string;
+    toolName: string;
+} | null;
+/** Create a namespaced tool name from a slug and tool name. */
+export declare function namespaceTool(slug: string, toolName: string): string;
+//# sourceMappingURL=router.d.ts.map

package/dist/engine/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../src/engine/router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4EAA4E;AAC5E,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAW/F;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpE"}

package/dist/engine/router.js

@@ -0,0 +1,23 @@
+/**
+ * Tool name router for the MCP Catalog.
+ *
+ * Handles the bidirectional mapping between:
+ *   - Namespaced MCP tool names: `{listing_slug}__{tool_name}`
+ *   - Upstream server slugs and their raw tool names
+ */
+/** Parse a namespaced tool name into its server slug and real tool name. */
+export function parseToolName(namespacedName) {
+    const separatorIndex = namespacedName.indexOf('__');
+    if (separatorIndex === -1) {
+        return null;
+    }
+    return {
+        slug: namespacedName.substring(0, separatorIndex),
+        toolName: namespacedName.substring(separatorIndex + 2),
+    };
+}
+/** Create a namespaced tool name from a slug and tool name. */
+export function namespaceTool(slug, toolName) {
+    return `${slug}__${toolName}`;
+}
+//# sourceMappingURL=router.js.map

package/dist/engine/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../../src/engine/router.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,cAAsB;IAClD,MAAM,cAAc,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,IAAI,cAAc,KAAK,CAAC,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,EAAE,cAAc,CAAC,SAAS,CAAC,CAAC,EAAE,cAAc,CAAC;QACjD,QAAQ,EAAE,cAAc,CAAC,SAAS,CAAC,cAAc,GAAG,CAAC,CAAC;KACvD,CAAC;AACJ,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,QAAgB;IAC1D,OAAO,GAAG,IAAI,KAAK,QAAQ,EAAE,CAAC;AAChC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * Vinkius MCP Catalog — Unified gateway to 2,000+ MCP servers.
+ *
+ * A single stdio MCP server that aggregates all marketplace MCPs
+ * behind one connection, with intelligent search and routing.
+ *
+ * Configuration:
+ *   VINKIUS_CATALOG_TOKEN  — Required. Your vk_catalog_* token.
+ *   VINKIUS_API_URL        — Optional. Defaults to https://api.vinkius.com
+ *
+ * Usage (claude_desktop_config.json):
+ *   {
+ *     "mcpServers": {
+ *       "vinkius-catalog": {
+ *         "command": "npx",
+ *         "args": ["-y", "@mcp-catalog/vinkius"],
+ *         "env": { "VINKIUS_CATALOG_TOKEN": "vk_catalog_..." }
+ *       }
+ *     }
+ *   }
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;GAoBG"}

package/dist/index.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+/**
+ * Vinkius MCP Catalog — Unified gateway to 2,000+ MCP servers.
+ *
+ * A single stdio MCP server that aggregates all marketplace MCPs
+ * behind one connection, with intelligent search and routing.
+ *
+ * Configuration:
+ *   VINKIUS_CATALOG_TOKEN  — Required. Your vk_catalog_* token.
+ *   VINKIUS_API_URL        — Optional. Defaults to https://api.vinkius.com
+ *
+ * Usage (claude_desktop_config.json):
+ *   {
+ *     "mcpServers": {
+ *       "vinkius-catalog": {
+ *         "command": "npx",
+ *         "args": ["-y", "@mcp-catalog/vinkius"],
+ *         "env": { "VINKIUS_CATALOG_TOKEN": "vk_catalog_..." }
+ *       }
+ *     }
+ *   }
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { VinkiusClient } from './api/client.js';
+import { registerMetaTools } from './tools/meta-tools.js';
+import { refreshProxyTools } from './tools/proxy-tools.js';
+// ── Configuration ───────────────────────────────────────────────────────────
+const CATALOG_TOKEN = process.env.VINKIUS_CATALOG_TOKEN;
+const API_URL = process.env.VINKIUS_API_URL;
+if (!CATALOG_TOKEN) {
+    console.error('╔═══════════════════════════════════════════════════════════════════╗\n' +
+        '║  VINKIUS_CATALOG_TOKEN is required to use the MCP Catalog.      ║\n' +
+        '╚═══════════════════════════════════════════════════════════════════╝\n\n' +
+        'Follow these steps to get started:\n\n' +
+        '  1. Sign up or log in at https://cloud.vinkius.com\n' +
+        '  2. Go to Settings → Catalog Tokens\n' +
+        '     https://cloud.vinkius.com/settings/catalog-tokens\n' +
+        '  3. Click "Create catalog token" and copy the vk_catalog_* token\n' +
+        '  4. Add it to your MCP client configuration:\n\n' +
+        '     claude_desktop_config.json:\n' +
+        '     {\n' +
+        '       "mcpServers": {\n' +
+        '         "vinkius-catalog": {\n' +
+        '           "command": "npx",\n' +
+        '           "args": ["-y", "@mcp-catalog/vinkius"],\n' +
+        '           "env": {\n' +
+        '             "VINKIUS_CATALOG_TOKEN": "vk_catalog_YOUR_TOKEN_HERE"\n' +
+        '           }\n' +
+        '         }\n' +
+        '       }\n' +
+        '     }\n\n' +
+        '  5. Restart your AI agent\n');
+    process.exit(1);
+}
+if (!CATALOG_TOKEN.startsWith('vk_catalog_')) {
+    console.error('Error: VINKIUS_CATALOG_TOKEN must start with "vk_catalog_".\n\n' +
+        'You are using: ' + CATALOG_TOKEN.substring(0, 12) + '...\n\n' +
+        'This looks like a regular server token (vk_live_*).\n' +
+        'Catalog tokens are different — they give access to ALL your subscribed MCPs.\n\n' +
+        'Create a catalog token at:\n' +
+        '  https://cloud.vinkius.com/settings/catalog-tokens\n');
+    process.exit(1);
+}
+// ── Bootstrap ───────────────────────────────────────────────────────────────
+const client = new VinkiusClient(CATALOG_TOKEN, API_URL);
+const registeredProxyTools = new Set();
+const server = new McpServer({
+    name: 'vinkius-catalog',
+    version: '0.1.0',
+});
+// Register meta-tools (always available)
+registerMetaTools(server, client);
+// Load proxy tools from existing subscriptions (best-effort on startup)
+try {
+    await refreshProxyTools(server, client, registeredProxyTools);
+}
+catch {
+    // Non-fatal: proxy tools will load when user calls catalog_tools
+    console.error('Warning: Could not load proxy tools on startup. Use catalog_tools to refresh.');
+}
+// ── Start stdio transport ───────────────────────────────────────────────────
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,+EAA+E;AAE/E,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;AACxD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAE5C,IAAI,CAAC,aAAa,EAAE,CAAC;IACnB,OAAO,CAAC,KAAK,CACX,yEAAyE;QACzE,uEAAuE;QACvE,2EAA2E;QAC3E,wCAAwC;QACxC,uDAAuD;QACvD,wCAAwC;QACxC,0DAA0D;QAC1D,qEAAqE;QACrE,mDAAmD;QACnD,oCAAoC;QACpC,UAAU;QACV,0BAA0B;QAC1B,iCAAiC;QACjC,gCAAgC;QAChC,sDAAsD;QACtD,uBAAuB;QACvB,sEAAsE;QACtE,gBAAgB;QAChB,cAAc;QACd,YAAY;QACZ,YAAY;QACZ,8BAA8B,CAC/B,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;IAC7C,OAAO,CAAC,KAAK,CACX,iEAAiE;QACjE,iBAAiB,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,SAAS;QAC9D,uDAAuD;QACvD,kFAAkF;QAClF,8BAA8B;QAC9B,uDAAuD,CACxD,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,+EAA+E;AAE/E,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AACzD,MAAM,oBAAoB,GAAG,IAAI,GAAG,EAAU,CAAC;AAE/C,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,yCAAyC;AACzC,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElC,wEAAwE;AACxE,IAAI,CAAC;IACH,MAAM,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC;AAChE,CAAC;AAAC,MAAM,CAAC;IACP,iEAAiE;IACjE,OAAO,CAAC,KAAK,CAAC,+EAA+E,CAAC,CAAC;AACjG,CAAC;AAED,+EAA+E;AAE/E,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;AAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC"}

package/dist/tools/meta-tools.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Meta-tools — Tier 1 tools that are always available in the catalog.
+ *
+ * These tools allow the agent to discover, search, activate, and
+ * manage MCP servers without needing any pre-configured subscriptions.
+ */
+import type { VinkiusClient } from '../api/client.js';
+/** Register all meta-tools on the MCP server instance. */
+export declare function registerMetaTools(server: any, client: VinkiusClient): void;
+//# sourceMappingURL=meta-tools.d.ts.map

package/dist/tools/meta-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-tools.d.ts","sourceRoot":"","sources":["../../src/tools/meta-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,0DAA0D;AAC1D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAmF1E"}

package/dist/tools/meta-tools.js

@@ -0,0 +1,56 @@
+/**
+ * Meta-tools — Tier 1 tools that are always available in the catalog.
+ *
+ * These tools allow the agent to discover, search, activate, and
+ * manage MCP servers without needing any pre-configured subscriptions.
+ */
+/** Register all meta-tools on the MCP server instance. */
+export function registerMetaTools(server, client) {
+    // ── catalog_search ─────────────────────────────────────────────────────
+    server.tool('catalog_search', 'Search the Vinkius MCP marketplace to find servers that match your needs. ' +
+        'Returns relevant MCPs with descriptions, top tools, ratings, and activation instructions. ' +
+        'Use this when you need a capability that is not yet activated.', {
+        query: { type: 'string', description: 'What you need (e.g., "track cloud spending", "manage github issues")' },
+        limit: { type: 'number', description: 'Max results to return (default: 10)', default: 10 },
+    }, async (args) => {
+        const result = await client.search(args.query, args.limit ?? 10);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    // ── catalog_browse ─────────────────────────────────────────────────────
+    server.tool('catalog_browse', 'Browse available MCP categories in the Vinkius marketplace. ' +
+        'Returns categories with listing counts. Use this to explore what types of MCPs are available.', {}, async () => {
+        const result = await client.browse();
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    // ── catalog_activate ───────────────────────────────────────────────────
+    server.tool('catalog_activate', 'Activate (subscribe to) an MCP server from the marketplace. ' +
+        'For free MCPs, activation is instant and tools become available immediately. ' +
+        'For paid MCPs, returns a checkout URL that the user must open in a browser.', {
+        listing_id: { type: 'string', description: 'The listing UUID to activate (from catalog_search results)' },
+    }, async (args) => {
+        const result = await client.activate(args.listing_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    // ── catalog_deactivate ─────────────────────────────────────────────────
+    server.tool('catalog_deactivate', 'Deactivate (unsubscribe from) an MCP server. ' +
+        'Revokes access and removes the server tools from the catalog.', {
+        subscription_id: { type: 'string', description: 'The subscription UUID to deactivate (from catalog_analytics)' },
+    }, async (args) => {
+        const result = await client.deactivate(args.subscription_id);
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    // ── catalog_tools ──────────────────────────────────────────────────────
+    server.tool('catalog_tools', 'List all currently activated MCP servers and their available tools. ' +
+        'Shows which servers are active and what tools each provides. ' +
+        'Use this to see what capabilities are currently available.', {}, async () => {
+        const result = await client.getTools();
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+    // ── catalog_analytics ──────────────────────────────────────────────────
+    server.tool('catalog_analytics', 'View usage analytics for your activated MCP servers. ' +
+        'Shows request counts, last usage times, and subscription status.', {}, async () => {
+        const result = await client.analytics();
+        return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=meta-tools.js.map

package/dist/tools/meta-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-tools.js","sourceRoot":"","sources":["../../src/tools/meta-tools.ts"],"names":[],"mappings":"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"}

package/dist/tools/proxy-tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Proxy-tools — Tier 2 tools dynamically loaded from activated servers.
+ *
+ * These tools are registered/unregistered as the user activates/deactivates
+ * MCP servers via the catalog meta-tools. Each tool is namespaced as
+ * `{listing_slug}__{tool_name}` to prevent collisions.
+ */
+import type { VinkiusClient } from '../api/client.js';
+/** Refresh all proxy tools on the MCP server based on current subscriptions. */
+export declare function refreshProxyTools(server: any, client: VinkiusClient, registeredTools: Set<string>): Promise<void>;
+//# sourceMappingURL=proxy-tools.d.ts.map

package/dist/tools/proxy-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-tools.d.ts","sourceRoot":"","sources":["../../src/tools/proxy-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGtD,gFAAgF;AAChF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,GAAG,EACX,MAAM,EAAE,aAAa,EACrB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/tools/proxy-tools.js

@@ -0,0 +1,38 @@
+/**
+ * Proxy-tools — Tier 2 tools dynamically loaded from activated servers.
+ *
+ * These tools are registered/unregistered as the user activates/deactivates
+ * MCP servers via the catalog meta-tools. Each tool is namespaced as
+ * `{listing_slug}__{tool_name}` to prevent collisions.
+ */
+/** Refresh all proxy tools on the MCP server based on current subscriptions. */
+export async function refreshProxyTools(server, client, registeredTools) {
+    const response = await client.getTools();
+    const newToolNames = new Set();
+    for (const catalogServer of response.servers) {
+        for (const tool of catalogServer.tools) {
+            newToolNames.add(tool.name);
+            // Skip if already registered
+            if (registeredTools.has(tool.name)) {
+                continue;
+            }
+            // Register the proxy tool
+            server.tool(tool.name, `[${catalogServer.title}] ${tool.description}`, tool.inputSchema?.properties ?? {}, async (args) => {
+                const result = await client.execute(tool.name, args);
+                return {
+                    content: result.content,
+                    isError: result.isError,
+                };
+            });
+            registeredTools.add(tool.name);
+        }
+    }
+    // Remove tools that are no longer in the active set
+    for (const existingTool of registeredTools) {
+        if (!newToolNames.has(existingTool)) {
+            // MCP SDK doesn't have a direct remove method, but we track state
+            registeredTools.delete(existingTool);
+        }
+    }
+}
+//# sourceMappingURL=proxy-tools.js.map

package/dist/tools/proxy-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-tools.js","sourceRoot":"","sources":["../../src/tools/proxy-tools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,gFAAgF;AAChF,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAW,EACX,MAAqB,EACrB,eAA4B;IAE5B,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,QAAQ,EAAE,CAAC;IACzC,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC,KAAK,MAAM,aAAa,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC7C,KAAK,MAAM,IAAI,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACvC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAE5B,6BAA6B;YAC7B,IAAI,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,0BAA0B;YAC1B,MAAM,CAAC,IAAI,CACT,IAAI,CAAC,IAAI,EACT,IAAI,aAAa,CAAC,KAAK,KAAK,IAAI,CAAC,WAAW,EAAE,EAC9C,IAAI,CAAC,WAAW,EAAE,UAAU,IAAI,EAAE,EAClC,KAAK,EAAE,IAA6B,EAAE,EAAE;gBACtC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;gBACrD,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;iBACxB,CAAC;YACJ,CAAC,CACF,CAAC;YAEF,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,oDAAoD;IACpD,KAAK,MAAM,YAAY,IAAI,eAAe,EAAE,CAAC;QAC3C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACpC,kEAAkE;YAClE,eAAe,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Type definitions for the Vinkius MCP Catalog gateway.
+ */
+/** A single tool definition as returned by the Vinkius AI Gateway API. */
+export interface CatalogTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+/** A server entry in the aggregated tools response. */
+export interface CatalogServer {
+    slug: string;
+    listing_id: string;
+    title: string;
+    short_description: string;
+    icon_url: string | null;
+    tools: CatalogTool[];
+}
+/** Response from GET /catalog/tools */
+export interface CatalogToolsResponse {
+    servers: CatalogServer[];
+}
+/** Response from POST /catalog/execute */
+export interface CatalogExecuteResponse {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: boolean;
+}
+/** A search result listing. */
+export interface CatalogSearchResult {
+    id: string;
+    slug: string;
+    title: string;
+    short_description: string;
+    listing_type: string;
+    publisher_type: string;
+    avg_rating: number | null;
+    tags: string[];
+    categories: string[];
+    icon_url: string | null;
+    top_tools: Array<{
+        name: string;
+        description: string;
+    }>;
+    action: string;
+}
+/** Response from GET /catalog/search */
+export interface CatalogSearchResponse {
+    results: CatalogSearchResult[];
+    total: number;
+    hint: string;
+}
+/** Response from POST /catalog/activate */
+export interface CatalogActivateResponse {
+    activated: boolean;
+    subscription_id?: string;
+    checkout_url?: string;
+    message: string;
+}
+/** Response from GET /catalog/browse */
+export interface CatalogBrowseResponse {
+    categories: Array<{
+        slug: string;
+        label: string;
+        listing_count: number;
+    }>;
+}
+/** Response from GET /catalog/analytics */
+export interface CatalogAnalyticsResponse {
+    subscriptions: Array<{
+        subscription_id: string;
+        title: string;
+        slug: string;
+        status: string;
+        started_at: string;
+        request_count: number;
+        last_used_at: string | null;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,uDAAuD;AACvD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED,uCAAuC;AACvC,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,0CAA0C;AAC1C,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,+BAA+B;AAC/B,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wCAAwC;AACxC,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2CAA2C;AAC3C,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wCAAwC;AACxC,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;CACJ;AAED,2CAA2C;AAC3C,MAAM,WAAW,wBAAwB;IACvC,aAAa,EAAE,KAAK,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC,CAAC;CACJ"}

package/dist/types.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for the Vinkius MCP Catalog gateway.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@mcp-catalog/vinkius",
+  "version": "0.1.0",
+  "description": "Unlock apps and data for your AI agents instantly — 2,000+ hardened, governed MCP servers via a single stdio connection",
+  "author": "Vinkius",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "llm",
+    "claude",
+    "cursor",
+    "agent",
+    "tools",
+    "marketplace",
+    "gateway",
+    "stdio",
+    "vinkius"
+  ],
+  "homepage": "https://github.com/VinkiusLabs/mcp-catalog#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VinkiusLabs/mcp-catalog.git"
+  },
+  "bugs": {
+    "url": "https://github.com/VinkiusLabs/mcp-catalog/issues"
+  },
+  "bin": {
+    "mcp-catalog": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}