@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 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
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)

{
  "mcpServers": {
    "vinkius-catalog": {
      "command": "npx",
      "args": ["-y", "@mcp-catalog/vinkius"],
      "env": {
        "VINKIUS_CATALOG_TOKEN": "vk_catalog_YOUR_TOKEN_HERE"
      }
    }
  }
}

Cursor (.cursor/mcp.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 account with a catalog token

Development

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