@vanmoose/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,189 @@
+# @vanmoose/mcp-server
+
+73 developer utility APIs as MCP tools — one key, one server.
+
+[![npm version](https://badge.fury.io/js/@vanmoose%2Fmcp-server.svg)](https://www.npmjs.com/package/@vanmoose/mcp-server)
+
+## What This Does
+
+This MCP server exposes **192 tools from 73 VanMoose APIs** to any MCP-compatible AI agent (Claude, GPT, Cursor, Windsurf, etc.).
+
+One API key. One server. Screenshot capture, email validation, NLP, WHOIS, tech stack detection, PDF generation, and 66 more — all callable as native tools.
+
+## Quick Start
+
+### 1. Get Your API Key
+
+Sign up free at [vanmoose.cc](https://vanmoose.cc/sign-up) — a key is auto-issued on signup.
+
+### 2. Configure Claude Desktop
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "vanmoose": {
+      "command": "npx",
+      "args": ["-y", "@vanmoose/mcp-server"],
+      "env": {
+        "VANMOOSE_API_KEY": "vm_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+Restart Claude Desktop. You'll see 192 tools available.
+
+### 3. Configure Cursor / Windsurf
+
+Add to `.cursor/mcp.json` or `.windsurf/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "vanmoose": {
+      "command": "npx",
+      "args": ["-y", "@vanmoose/mcp-server"],
+      "env": {
+        "VANMOOSE_API_KEY": "vm_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### 4. Configure Claude Code
+
+Add to `.claude/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "vanmoose": {
+      "command": "npx",
+      "args": ["-y", "@vanmoose/mcp-server"],
+      "env": {
+        "VANMOOSE_API_KEY": "vm_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Available Tools (190 total)
+
+### Image Generation
+| Tool | Description |
+|------|-------------|
+| `vanmoose_screenshot` | Capture full-page screenshots via headless Chrome |
+| `vanmoose_qrcode` | Generate QR codes with custom colors and sizes |
+| `vanmoose_barcode` | Generate barcodes (Code128, EAN-13, etc.) |
+| `vanmoose_socialcard` | Generate Open Graph and Twitter Card images |
+| `vanmoose_placeholder` | Generate SVG placeholder images |
+| `vanmoose_avatar` | Generate SVG avatars (initials, identicons, pixel art) |
+| `vanmoose_gradient` | Generate CSS and SVG gradients |
+| `vanmoose_patterngen` | Generate SVG patterns |
+| `vanmoose_favicon` | Extract favicons from any website |
+| `vanmoose_imagecompress` | Compress images with quality control |
+| `vanmoose_imageresize` | Resize and crop images |
+
+### Web Scraping & Intelligence
+| Tool | Description |
+|------|-------------|
+| `vanmoose_techstack_detect` | Detect frameworks, CMS, technologies on websites |
+| `vanmoose_metadata_extract` | Extract Open Graph, Twitter Cards, meta tags |
+| `vanmoose_readable_extract` | Extract clean article content from URLs |
+| `vanmoose_unfurl_preview` | Link preview data for rich embeds |
+| `vanmoose_pricewatch` | Extract prices from web pages |
+| `vanmoose_rssfeed_parse` | Parse RSS/Atom feeds |
+| `vanmoose_sitemap_parse` | Parse XML sitemaps |
+| `vanmoose_linkcheck_check` | Check if URLs are alive, dead, or redirecting |
+| `vanmoose_changecheck` | Detect website content changes |
+
+### Validation
+| Tool | Description |
+|------|-------------|
+| `vanmoose_emailverify_verify` | Validate emails (syntax, MX, disposable) |
+| `vanmoose_emailverify_bulk` | Bulk email verification |
+| `vanmoose_phonevalidate` | Validate international phone numbers |
+| `vanmoose_vatvalidate` | Validate EU VAT numbers |
+| `vanmoose_whois_lookup` | Domain WHOIS lookup |
+| `vanmoose_checkcheck` | Domain availability check |
+| `vanmoose_breachcheck` | Check emails/passwords in known breaches |
+| `vanmoose_vpndetect` | Detect VPN, proxy, Tor IPs |
+
+### Text & NLP
+| Tool | Description |
+|------|-------------|
+| `vanmoose_nlptools` | Language detection, sentiment, keywords |
+| `vanmoose_markdown` | Convert Markdown ↔ HTML |
+| `vanmoose_profanity` | Detect and filter profanity |
+| `vanmoose_languagedetect` | Detect text language |
+| `vanmoose_readability` | Analyze text readability |
+
+### Developer Utils
+| Tool | Description |
+|------|-------------|
+| `vanmoose_jwt` | Create, decode, verify JWTs |
+| `vanmoose_hashtools` | Generate/verify hashes (MD5, SHA256) |
+| `vanmoose_uuidgen` | Generate UUIDs, ULIDs, NanoIDs |
+| `vanmoose_regextester` | Test regular expressions |
+| `vanmoose_cronparser` | Parse cron expressions |
+| `vanmoose_dataconv` | Convert JSON ↔ CSV ↔ XML ↔ YAML |
+
+*Plus 130+ more tools across network, converter, and data categories.*
+
+## For Agent Builders
+
+```typescript
+// An LLM orchestrator discovers tools via list_tools
+const tools = await mcpClient.listTools();
+// → Returns 190 tool definitions with inputSchemas
+
+// Call any tool
+const result = await mcpClient.callTool('vanmoose_emailverify_verify', {
+  email: 'test@example.com'
+});
+```
+
+All tools return structured JSON. Error responses include machine-readable codes:
+- `VANMOOSE_AUTH_ERROR` — Invalid/missing API key
+- `VANMOOSE_QUOTA_EXCEEDED` — Monthly limit hit (upgrade URL included)
+- `VANMOOSE_VALIDATION_ERROR` — Bad input parameters
+- `VANMOOSE_RATE_LIMITED` — Too many requests (Retry-After included)
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `VANMOOSE_API_KEY` | Yes | Your `vm_live_` API key |
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Generate tool definitions from OpenAPI specs
+pnpm run generate
+
+# Build
+pnpm run build
+
+# Run locally (stdio transport)
+VANMOOSE_API_KEY=vm_live_xxx node dist/index.js
+```
+
+## Links
+
+- [Van Moose API Platform](https://vanmoose.cc)
+- [Get API Key](https://vanmoose.cc/dashboard)
+- [All 73 APIs](https://vanmoose.cc/apis)
+- [JavaScript SDK](https://www.npmjs.com/package/@vanmoose/sdk)
+
+## License
+
+MIT — [Van Moose BV](https://vanmoose.com), Amsterdam

package/dist/auth.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @vanmoose/mcp-server — API key validation + env handling
+ */
+export declare function getApiKey(): string;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAgB,SAAS,IAAI,MAAM,CAiBlC"}

package/dist/auth.js

@@ -0,0 +1,19 @@
+/**
+ * @vanmoose/mcp-server — API key validation + env handling
+ */
+const API_KEY_PREFIX = 'vm_live_';
+export function getApiKey() {
+    const key = process.env.VANMOOSE_API_KEY;
+    if (!key) {
+        console.error('Error: VANMOOSE_API_KEY environment variable is required.\n' +
+            'Get your free API key at https://vanmoose.cc/dashboard');
+        process.exit(1);
+    }
+    if (!key.startsWith(API_KEY_PREFIX)) {
+        console.error(`Error: Invalid API key format. Keys must start with "${API_KEY_PREFIX}".\n` +
+            'Get a valid key at https://vanmoose.cc/dashboard');
+        process.exit(1);
+    }
+    return key;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,cAAc,GAAG,UAAU,CAAC;AAElC,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IACzC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CACX,6DAA6D;YAC7D,wDAAwD,CACzD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QACpC,OAAO,CAAC,KAAK,CACX,wDAAwD,cAAc,MAAM;YAC5E,kDAAkD,CACnD,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @vanmoose/mcp-server — VanMoose API HTTP client
+ *
+ * Lightweight fetch-based client. No external dependencies.
+ */
+export declare class VanMooseClient {
+    private apiKey;
+    constructor(apiKey: string);
+    request(domain: string, path: string, method: 'GET' | 'POST', params: Record<string, unknown>): Promise<unknown>;
+    private mapError;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,MAAM;IAIpB,OAAO,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,KAAK,GAAG,MAAM,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,OAAO,CAAC;IA0EnB,OAAO,CAAC,QAAQ;CAkCjB"}

package/dist/client.js

@@ -0,0 +1,115 @@
+/**
+ * @vanmoose/mcp-server — VanMoose API HTTP client
+ *
+ * Lightweight fetch-based client. No external dependencies.
+ */
+import { ERROR_CODES } from './types.js';
+const TIMEOUT_MS = 30_000;
+export class VanMooseClient {
+    apiKey;
+    constructor(apiKey) {
+        this.apiKey = apiKey;
+    }
+    async request(domain, path, method, params) {
+        const url = new URL(`https://${domain}${path}`);
+        const headers = {
+            'X-VanMoose-Key': this.apiKey,
+            'User-Agent': '@vanmoose/mcp-server/1.0.0',
+        };
+        let body;
+        if (method === 'GET') {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    if (Array.isArray(value)) {
+                        url.searchParams.set(key, value.join(','));
+                    }
+                    else {
+                        url.searchParams.set(key, String(value));
+                    }
+                }
+            }
+        }
+        else {
+            headers['Content-Type'] = 'application/json';
+            body = JSON.stringify(params);
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), TIMEOUT_MS);
+        try {
+            const response = await fetch(url.toString(), {
+                method,
+                headers,
+                body,
+                signal: controller.signal,
+            });
+            const retryAfter = response.headers.get('Retry-After');
+            const rateLimitRemaining = response.headers.get('X-RateLimit-Remaining');
+            if (!response.ok) {
+                const errorBody = await response.text().catch(() => 'Unknown error');
+                throw this.mapError(response.status, errorBody, retryAfter);
+            }
+            const contentType = response.headers.get('Content-Type') || '';
+            if (contentType.includes('application/json')) {
+                const data = await response.json();
+                return {
+                    data,
+                    _meta: {
+                        rateLimitRemaining: rateLimitRemaining ? parseInt(rateLimitRemaining) : undefined,
+                    },
+                };
+            }
+            // Binary or text response (screenshots, PDFs, etc.)
+            const text = await response.text();
+            return { data: text };
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                const e = {
+                    code: ERROR_CODES.TIMEOUT,
+                    message: `Request timed out after ${TIMEOUT_MS / 1000}s`,
+                    status: 408,
+                };
+                throw e;
+            }
+            throw error;
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    mapError(status, body, retryAfter) {
+        switch (status) {
+            case 401:
+                return {
+                    code: ERROR_CODES.AUTH_ERROR,
+                    message: 'Invalid or missing API key. Get one at https://vanmoose.cc/dashboard',
+                    status,
+                };
+            case 402:
+                return {
+                    code: ERROR_CODES.QUOTA_EXCEEDED,
+                    message: `Monthly quota exceeded. Upgrade at https://vanmoose.cc/dashboard/billing — ${body}`,
+                    status,
+                };
+            case 422:
+                return {
+                    code: ERROR_CODES.VALIDATION_ERROR,
+                    message: `Validation error: ${body}`,
+                    status,
+                };
+            case 429:
+                return {
+                    code: ERROR_CODES.RATE_LIMITED,
+                    message: `Rate limited.${retryAfter ? ` Retry after ${retryAfter}s.` : ''} ${body}`,
+                    status,
+                };
+            default:
+                return {
+                    code: ERROR_CODES.API_ERROR,
+                    message: `API error (${status}): ${body}`,
+                    status,
+                };
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * @vanmoose/mcp-server — 72 developer utility APIs as MCP tools
+ *
+ * One key. One server. 72 tools for any AI agent.
+ * https://vanmoose.cc
+ */
+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;;;;;GAKG"}

package/dist/index.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+/**
+ * @vanmoose/mcp-server — 72 developer utility APIs as MCP tools
+ *
+ * One key. One server. 72 tools for any AI agent.
+ * https://vanmoose.cc
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { getApiKey } from "./auth.js";
+import { VanMooseClient } from "./client.js";
+import { getKeyScope } from "./scope.js";
+import { tools } from "./tools/index.js";
+// ============================================================================
+// INITIALIZATION
+// ============================================================================
+const apiKey = getApiKey();
+const client = new VanMooseClient(apiKey);
+const server = new McpServer({
+    name: "@vanmoose/mcp-server",
+    version: "1.0.0",
+});
+// ============================================================================
+// HELPER: Build zod schema from tool parameter definitions
+// ============================================================================
+function buildZodSchema(params) {
+    const shape = {};
+    for (const p of params) {
+        let schema;
+        switch (p.type) {
+            case 'number':
+            case 'integer':
+                schema = z.number().describe(p.description);
+                break;
+            case 'boolean':
+                schema = z.boolean().describe(p.description);
+                break;
+            case 'array':
+                schema = z.array(z.string()).describe(p.description);
+                break;
+            case 'object':
+                schema = z.record(z.unknown()).describe(p.description);
+                break;
+            default:
+                schema = z.string().describe(p.description);
+        }
+        if (!p.required) {
+            schema = schema.optional();
+        }
+        shape[p.name] = schema;
+    }
+    return z.object(shape);
+}
+// ============================================================================
+// REGISTER ALL TOOLS
+// ============================================================================
+function registerTool(tool) {
+    const allParams = [...tool.parameters, ...tool.bodyParameters];
+    const inputSchema = buildZodSchema(allParams);
+    server.registerTool(tool.name, {
+        title: tool.title,
+        description: tool.description,
+        inputSchema,
+        annotations: {
+            readOnlyHint: true,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async (params) => {
+        try {
+            // Split params into query vs body based on tool definition
+            const queryParamNames = new Set(tool.parameters.map(p => p.name));
+            const queryParams = {};
+            const bodyParams = {};
+            for (const [key, value] of Object.entries(params)) {
+                if (value === undefined)
+                    continue;
+                if (queryParamNames.has(key)) {
+                    queryParams[key] = value;
+                }
+                else {
+                    bodyParams[key] = value;
+                }
+            }
+            const requestParams = tool.method === 'GET' ? queryParams : bodyParams;
+            const result = await client.request(tool.domain, tool.path, tool.method, requestParams);
+            return {
+                content: [{
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
+                    }],
+            };
+        }
+        catch (error) {
+            const vmError = error;
+            if (vmError.code) {
+                return {
+                    isError: true,
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                error: vmError.code,
+                                message: vmError.message,
+                                status: vmError.status,
+                            }),
+                        }],
+                };
+            }
+            return {
+                isError: true,
+                content: [{
+                        type: "text",
+                        text: `Error calling ${tool.name}: ${error instanceof Error ? error.message : String(error)}`,
+                    }],
+            };
+        }
+    });
+}
+// ============================================================================
+// SCOPE-AWARE TOOL REGISTRATION
+// ============================================================================
+async function registerTools() {
+    // Fetch scope to determine which tools to register
+    const scope = await getKeyScope(apiKey);
+    let filteredTools = tools;
+    if (scope && scope.scopeType !== 'full') {
+        const allowedSet = new Set(scope.allowedSlugs);
+        filteredTools = tools.filter(t => allowedSet.has(t.apiId));
+        if (scope.scopeType === 'category') {
+            console.error(`[Scope] Key scoped to category "${scope.scopeValue}" — ${filteredTools.length}/${tools.length} tools`);
+        }
+        else if (scope.scopeType === 'api') {
+            console.error(`[Scope] Key scoped to API "${scope.scopeValue}" — ${filteredTools.length}/${tools.length} tools`);
+        }
+    }
+    for (const tool of filteredTools) {
+        registerTool(tool);
+    }
+    // Register catalog resource with filtered tools
+    server.registerResource("API Catalog", "vanmoose://catalog", {
+        description: `Catalog of ${filteredTools.length} VanMoose APIs available with this key`,
+        mimeType: "application/json",
+    }, async () => {
+        const catalog = filteredTools.map(t => ({
+            name: t.name,
+            title: t.title,
+            description: t.description,
+            apiId: t.apiId,
+            domain: t.domain,
+        }));
+        return {
+            contents: [{
+                    uri: "vanmoose://catalog",
+                    mimeType: "application/json",
+                    text: JSON.stringify(catalog, null, 2),
+                }],
+        };
+    });
+    return filteredTools.length;
+}
+// ============================================================================
+// TRANSPORT
+// ============================================================================
+async function main() {
+    const toolCount = await registerTools();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error(`@vanmoose/mcp-server running — ${toolCount} tools registered`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/scope.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @vanmoose/mcp-server — Scope filtering
+ * Fetches allowed API slugs from vanmoose.cc based on the key's scope.
+ */
+export interface KeyScope {
+    scopeType: string;
+    scopeValue: string | null;
+    allowedSlugs: string[];
+}
+/**
+ * Get the scope info for the current API key.
+ * Returns all slugs for full-access keys.
+ * On error, returns null (caller should register all tools as fallback).
+ */
+export declare function getKeyScope(apiKey: string): Promise<KeyScope | null>;
+//# sourceMappingURL=scope.d.ts.map

package/dist/scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.d.ts","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,YAAY,EAAE,MAAM,EAAE,CAAA;CACvB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAkB1E"}

package/dist/scope.js

@@ -0,0 +1,29 @@
+/**
+ * @vanmoose/mcp-server — Scope filtering
+ * Fetches allowed API slugs from vanmoose.cc based on the key's scope.
+ */
+const BASE_URL = process.env.VANMOOSE_BASE_URL || 'https://vanmoose.cc';
+/**
+ * Get the scope info for the current API key.
+ * Returns all slugs for full-access keys.
+ * On error, returns null (caller should register all tools as fallback).
+ */
+export async function getKeyScope(apiKey) {
+    try {
+        const res = await fetch(`${BASE_URL}/api/key-scope`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ apiKey }),
+        });
+        if (!res.ok) {
+            console.error(`[Scope] Failed to fetch key scope: ${res.status}`);
+            return null;
+        }
+        return (await res.json());
+    }
+    catch (error) {
+        console.error('[Scope] Error fetching key scope:', error);
+        return null;
+    }
+}
+//# sourceMappingURL=scope.js.map

package/dist/scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope.js","sourceRoot":"","sources":["../src/scope.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,qBAAqB,CAAA;AAQvE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,QAAQ,gBAAgB,EAAE;YACnD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;SACjC,CAAC,CAAA;QAEF,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,sCAAsC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAA;YACjE,OAAO,IAAI,CAAA;QACb,CAAC;QAED,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAa,CAAA;IACvC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAA;QACzD,OAAO,IAAI,CAAA;IACb,CAAC;AACH,CAAC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Auto-generated tool definitions for @vanmoose/mcp-server
+ * Generated: 2026-03-17T19:05:16.421Z
+ * Total: 192 tools from 73 APIs
+ *
+ * DO NOT EDIT — run `npm run generate` to regenerate.
+ */
+import type { ToolDefinition } from '../types.js';
+export declare const tools: ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,KAAK,EAAE,cAAc,EAo2HjC,CAAC"}