@volaticloud/mcp-server 0.1.0-dev.pr507.25e1c71

package/README.md

@@ -0,0 +1,104 @@
+# @volaticloud/mcp-server
+
+MCP (Model Context Protocol) server for the VolatiCloud GraphQL API. Lets AI agents manage strategies, bots, exchanges, and backtests through natural language.
+
+## Quick Start
+
+```bash
+npx -y @volaticloud/mcp-server
+```
+
+## Prerequisites
+
+1. A VolatiCloud account with an organization
+2. An API client (create one at **Organization > API Keys** in the dashboard)
+
+## Configuration
+
+### Claude Code
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "volaticloud": {
+      "command": "npx",
+      "args": ["-y", "@volaticloud/mcp-server"],
+      "env": {
+        "VOLATICLOUD_ENDPOINT": "https://api.volaticloud.com/gateway/v1/query",
+        "VOLATICLOUD_CLIENT_ID": "<your-client-id>",
+        "VOLATICLOUD_CLIENT_SECRET": "<your-client-secret>"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS):
+
+```json
+{
+  "mcpServers": {
+    "volaticloud": {
+      "command": "npx",
+      "args": ["-y", "@volaticloud/mcp-server"],
+      "env": {
+        "VOLATICLOUD_ENDPOINT": "https://api.volaticloud.com/gateway/v1/query",
+        "VOLATICLOUD_CLIENT_ID": "<your-client-id>",
+        "VOLATICLOUD_CLIENT_SECRET": "<your-client-secret>"
+      }
+    }
+  }
+}
+```
+
+## Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `VOLATICLOUD_CLIENT_ID` | Yes | — | API client ID |
+| `VOLATICLOUD_CLIENT_SECRET` | Yes | — | API client secret |
+| `VOLATICLOUD_ENDPOINT` | No | `https://api.volaticloud.com/gateway/v1/query` | GraphQL endpoint URL |
+
+## Available Tools
+
+### Static Tools
+
+| Tool | Description |
+|------|-------------|
+| `introspect_schema` | Explore the API schema, optionally drill into a specific type |
+| `search_schema` | Search types, fields, and enums by keyword |
+| `execute_query` | Run any GraphQL query with variables |
+| `execute_mutation` | Run any GraphQL mutation with variables |
+
+### Dynamic Tools (auto-generated)
+
+The server introspects the GraphQL schema at startup and generates individual tools for each query and mutation. Examples:
+
+- `strategies`, `bots`, `exchanges`, `runners` — List resources
+- `create_strategy`, `create_bot`, `create_exchange` — Create resources
+- `update_strategy`, `update_bot` — Update resources
+- `delete_strategy`, `delete_bot` — Delete resources
+- `start_bot`, `stop_bot`, `restart_bot` — Bot lifecycle
+- `run_backtest`, `run_simulation` — Run analysis
+- `get_bot_open_positions`, `get_bot_trading_config` — Live data
+
+## How It Works
+
+1. On startup, authenticates using your API client credentials (OAuth2 client_credentials flow)
+2. Introspects the GraphQL schema to discover all available operations
+3. Generates MCP tool definitions from each query and mutation
+4. Communicates with AI agents via stdio (standard MCP transport)
+5. Automatically refreshes the access token before expiry
+
+## Development
+
+```bash
+cd mcp-server
+npm install
+npm run build
+node dist/index.js
+```

package/bin/mcp-server.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+import { fileURLToPath } from "url";
+import { dirname, resolve } from "path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const entry = resolve(__dirname, "..", "dist", "index.js");
+
+import(entry).catch((err) => {
+  console.error("Failed to start VolatiCloud MCP server:", err.message);
+  process.exit(1);
+});

package/dist/graphql/auth.d.ts

@@ -0,0 +1,9 @@
+import type { ServerConfig } from "../types.js";
+export declare class AuthManager {
+    private token;
+    private config;
+    constructor(config: ServerConfig);
+    getAccessToken(): Promise<string>;
+    private authenticate;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/graphql/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/graphql/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA8B,YAAY,EAAE,MAAM,aAAa,CAAC;AAY5E,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,MAAM,CAAe;gBAEjB,MAAM,EAAE,YAAY;IAI1B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;YAQzB,YAAY;CAyC3B"}

package/dist/graphql/auth.js

@@ -0,0 +1,51 @@
+const AUTHENTICATE_MUTATION = `
+  mutation AuthenticateAPIClient($clientId: String!, $clientSecret: String!) {
+    authenticateAPIClient(clientId: $clientId, clientSecret: $clientSecret) {
+      accessToken
+      tokenType
+      expiresIn
+    }
+  }
+`;
+export class AuthManager {
+    token = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async getAccessToken() {
+        if (this.token && Date.now() < this.token.expiresAt - 30_000) {
+            return this.token.accessToken;
+        }
+        await this.authenticate();
+        return this.token.accessToken;
+    }
+    async authenticate() {
+        const response = await fetch(this.config.endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                query: AUTHENTICATE_MUTATION,
+                variables: {
+                    clientId: this.config.clientId,
+                    clientSecret: this.config.clientSecret,
+                },
+            }),
+        });
+        if (!response.ok) {
+            throw new Error(`Authentication failed: HTTP ${response.status} ${response.statusText}`);
+        }
+        const result = await response.json();
+        if (result.errors?.length) {
+            throw new Error(`Authentication failed: ${result.errors.map((e) => e.message).join(", ")}`);
+        }
+        const auth = result.data.authenticateAPIClient;
+        this.token = {
+            accessToken: auth.accessToken,
+            tokenType: auth.tokenType,
+            expiresIn: auth.expiresIn,
+            expiresAt: Date.now() + auth.expiresIn * 1000,
+        };
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/graphql/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/graphql/auth.ts"],"names":[],"mappings":"AAEA,MAAM,qBAAqB,GAAG;;;;;;;;CAQ7B,CAAC;AAEF,MAAM,OAAO,WAAW;IACd,KAAK,GAAqB,IAAI,CAAC;IAC/B,MAAM,CAAe;IAE7B,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,KAAM,CAAC,WAAW,CAAC;IACjC,CAAC;IAEO,KAAK,CAAC,YAAY;QACxB,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE;YACjD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,KAAK,EAAE,qBAAqB;gBAC5B,SAAS,EAAE;oBACT,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;oBAC9B,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY;iBACvC;aACF,CAAC;SACH,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,+BAA+B,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACxE,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAMP,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE3B,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,0BAA0B,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC3E,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAK,CAAC,qBAAqB,CAAC;QAChD,IAAI,CAAC,KAAK,GAAG;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI;SAC9C,CAAC;IACJ,CAAC;CACF"}

package/dist/graphql/client.d.ts

@@ -0,0 +1,10 @@
+import type { GraphQLResponse } from "../types.js";
+import type { AuthManager } from "./auth.js";
+export declare class GraphQLClient {
+    private endpoint;
+    private auth;
+    constructor(endpoint: string, auth: AuthManager);
+    execute<T = Record<string, unknown>>(query: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+    executeUnauthenticated<T = Record<string, unknown>>(query: string, variables?: Record<string, unknown>): Promise<GraphQLResponse<T>>;
+}
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/graphql/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE7C,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,IAAI,CAAc;gBAEd,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW;IAKzC,OAAO,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAqBxB,sBAAsB,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAe/B"}

package/dist/graphql/client.js

@@ -0,0 +1,35 @@
+export class GraphQLClient {
+    endpoint;
+    auth;
+    constructor(endpoint, auth) {
+        this.endpoint = endpoint;
+        this.auth = auth;
+    }
+    async execute(query, variables) {
+        const token = await this.auth.getAccessToken();
+        const response = await fetch(this.endpoint, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${token}`,
+            },
+            body: JSON.stringify({ query, variables }),
+        });
+        if (!response.ok) {
+            throw new Error(`GraphQL request failed: HTTP ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    async executeUnauthenticated(query, variables) {
+        const response = await fetch(this.endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ query, variables }),
+        });
+        if (!response.ok) {
+            throw new Error(`GraphQL request failed: HTTP ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/graphql/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/graphql/client.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,aAAa;IAChB,QAAQ,CAAS;IACjB,IAAI,CAAc;IAE1B,YAAY,QAAgB,EAAE,IAAiB;QAC7C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,OAAO,CACX,KAAa,EACb,SAAmC;QAEnC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC1C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,KAAK,EAAE;aACjC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACzE,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAiC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,sBAAsB,CAC1B,KAAa,EACb,SAAmC;QAEnC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE;YAC1C,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACb,gCAAgC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CACzE,CAAC;QACJ,CAAC;QAED,OAAO,QAAQ,CAAC,IAAI,EAAiC,CAAC;IACxD,CAAC;CACF"}

package/dist/graphql/introspect.d.ts

@@ -0,0 +1,20 @@
+import type { GraphQLClient } from "./client.js";
+import type { IntrospectedSchema, IntrospectedField, IntrospectedFullType, IntrospectedType } from "../types.js";
+export declare class SchemaIntrospector {
+    private client;
+    private schema;
+    private typeMap;
+    constructor(client: GraphQLClient);
+    introspect(): Promise<IntrospectedSchema>;
+    getSchema(): IntrospectedSchema;
+    getType(name: string): IntrospectedFullType | undefined;
+    getQueryFields(): IntrospectedField[];
+    getMutationFields(): IntrospectedField[];
+    resolveTypeName(type: IntrospectedType): string;
+    isRequired(type: IntrospectedType): boolean;
+    isList(type: IntrospectedType): boolean;
+    searchTypes(keyword: string): IntrospectedFullType[];
+    describeType(typeName: string): string;
+    formatType(type: IntrospectedType): string;
+}
+//# sourceMappingURL=introspect.d.ts.map

package/dist/graphql/introspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"introspect.d.ts","sourceRoot":"","sources":["../../src/graphql/introspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,KAAK,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAkFrB,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,OAAO,CAAgD;gBAEnD,MAAM,EAAE,aAAa;IAI3B,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAoB/C,SAAS,IAAI,kBAAkB;IAK/B,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,GAAG,SAAS;IAIvD,cAAc,IAAI,iBAAiB,EAAE;IAMrC,iBAAiB,IAAI,iBAAiB,EAAE;IAMxC,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM;IAM/C,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAI3C,MAAM,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO;IAMvC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,EAAE;IAUpD,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAoCtC,UAAU,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM;CAS3C"}

package/dist/graphql/introspect.js

@@ -0,0 +1,184 @@
+const INTROSPECTION_QUERY = `
+  query IntrospectionQuery {
+    __schema {
+      queryType { name }
+      mutationType { name }
+      types {
+        kind
+        name
+        description
+        fields(includeDeprecated: false) {
+          name
+          description
+          args {
+            name
+            description
+            type {
+              kind
+              name
+              ofType {
+                kind
+                name
+                ofType {
+                  kind
+                  name
+                  ofType {
+                    kind
+                    name
+                  }
+                }
+              }
+            }
+            defaultValue
+          }
+          type {
+            kind
+            name
+            ofType {
+              kind
+              name
+              ofType {
+                kind
+                name
+                ofType {
+                  kind
+                  name
+                }
+              }
+            }
+          }
+        }
+        inputFields {
+          name
+          description
+          type {
+            kind
+            name
+            ofType {
+              kind
+              name
+              ofType {
+                kind
+                name
+                ofType {
+                  kind
+                  name
+                }
+              }
+            }
+          }
+          defaultValue
+        }
+        enumValues(includeDeprecated: false) {
+          name
+          description
+        }
+      }
+    }
+  }
+`;
+export class SchemaIntrospector {
+    client;
+    schema = null;
+    typeMap = new Map();
+    constructor(client) {
+        this.client = client;
+    }
+    async introspect() {
+        const result = await this.client.executeUnauthenticated(INTROSPECTION_QUERY);
+        if (result.errors?.length) {
+            throw new Error(`Introspection failed: ${result.errors.map((e) => e.message).join(", ")}`);
+        }
+        this.schema = result.data.__schema;
+        this.typeMap.clear();
+        for (const type of this.schema.types) {
+            this.typeMap.set(type.name, type);
+        }
+        return this.schema;
+    }
+    getSchema() {
+        if (!this.schema)
+            throw new Error("Schema not introspected yet");
+        return this.schema;
+    }
+    getType(name) {
+        return this.typeMap.get(name);
+    }
+    getQueryFields() {
+        if (!this.schema?.queryType)
+            return [];
+        const queryType = this.typeMap.get(this.schema.queryType.name);
+        return queryType?.fields ?? [];
+    }
+    getMutationFields() {
+        if (!this.schema?.mutationType)
+            return [];
+        const mutationType = this.typeMap.get(this.schema.mutationType.name);
+        return mutationType?.fields ?? [];
+    }
+    resolveTypeName(type) {
+        if (type.name)
+            return type.name;
+        if (type.ofType)
+            return this.resolveTypeName(type.ofType);
+        return "Unknown";
+    }
+    isRequired(type) {
+        return type.kind === "NON_NULL";
+    }
+    isList(type) {
+        if (type.kind === "LIST")
+            return true;
+        if (type.ofType)
+            return this.isList(type.ofType);
+        return false;
+    }
+    searchTypes(keyword) {
+        const lower = keyword.toLowerCase();
+        return this.schema.types.filter((t) => !t.name.startsWith("__") &&
+            (t.name.toLowerCase().includes(lower) ||
+                t.description?.toLowerCase().includes(lower)));
+    }
+    describeType(typeName) {
+        const type = this.typeMap.get(typeName);
+        if (!type)
+            return `Type "${typeName}" not found`;
+        const lines = [`${type.kind} ${type.name}`];
+        if (type.description)
+            lines.push(type.description);
+        if (type.fields) {
+            lines.push("\nFields:");
+            for (const field of type.fields) {
+                const typeName = this.formatType(field.type);
+                const desc = field.description ? ` — ${field.description}` : "";
+                lines.push(`  ${field.name}: ${typeName}${desc}`);
+            }
+        }
+        if (type.inputFields) {
+            lines.push("\nInput Fields:");
+            for (const field of type.inputFields) {
+                const typeName = this.formatType(field.type);
+                const desc = field.description ? ` — ${field.description}` : "";
+                lines.push(`  ${field.name}: ${typeName}${desc}`);
+            }
+        }
+        if (type.enumValues) {
+            lines.push("\nValues:");
+            for (const val of type.enumValues) {
+                const desc = val.description ? ` — ${val.description}` : "";
+                lines.push(`  ${val.name}${desc}`);
+            }
+        }
+        return lines.join("\n");
+    }
+    formatType(type) {
+        if (type.kind === "NON_NULL") {
+            return `${this.formatType(type.ofType)}!`;
+        }
+        if (type.kind === "LIST") {
+            return `[${this.formatType(type.ofType)}]`;
+        }
+        return type.name ?? "Unknown";
+    }
+}
+//# sourceMappingURL=introspect.js.map

package/dist/graphql/introspect.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+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":""}

package/dist/index.js

@@ -0,0 +1,29 @@
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createServer } from "./server.js";
+function getConfig() {
+    const endpoint = process.env.VOLATICLOUD_ENDPOINT ??
+        "https://api.volaticloud.com/gateway/v1/query";
+    const clientId = process.env.VOLATICLOUD_CLIENT_ID;
+    const clientSecret = process.env.VOLATICLOUD_CLIENT_SECRET;
+    if (!clientId || !clientSecret) {
+        console.error("Error: VOLATICLOUD_CLIENT_ID and VOLATICLOUD_CLIENT_SECRET environment variables are required.\n\n" +
+            "Create an API client at: https://console.volaticloud.com/organization/api-keys\n" +
+            "Then configure:\n" +
+            "  VOLATICLOUD_CLIENT_ID=<your client id>\n" +
+            "  VOLATICLOUD_CLIENT_SECRET=<your client secret>\n" +
+            "  VOLATICLOUD_ENDPOINT=https://api.volaticloud.com/gateway/v1/query (optional)");
+        process.exit(1);
+    }
+    return { endpoint, clientId, clientSecret };
+}
+async function main() {
+    const config = getConfig();
+    const server = await createServer(config);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal:", err);
+    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":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG3C,SAAS,SAAS;IAChB,MAAM,QAAQ,GACZ,OAAO,CAAC,GAAG,CAAC,oBAAoB;QAChC,8CAA8C,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;IAE3D,IAAI,CAAC,QAAQ,IAAI,CAAC,YAAY,EAAE,CAAC;QAC/B,OAAO,CAAC,KAAK,CACX,oGAAoG;YAClG,kFAAkF;YAClF,mBAAmB;YACnB,4CAA4C;YAC5C,oDAAoD;YACpD,gFAAgF,CACnF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC;AAC9C,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,MAAM,CAAC,CAAC;IAC1C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ServerConfig } from "./types.js";
+export declare function createServer(config: ServerConfig): Promise<McpServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAW/C,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,SAAS,CAAC,CAgI3E"}

package/dist/server.js

@@ -0,0 +1,94 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { AuthManager } from "./graphql/auth.js";
+import { GraphQLClient } from "./graphql/client.js";
+import { SchemaIntrospector } from "./graphql/introspect.js";
+import { ToolGenerator } from "./tools/generator.js";
+import { ToolExecutor } from "./tools/executor.js";
+import { formatSchemaOverview, formatSearchResults, } from "./tools/formatter.js";
+export async function createServer(config) {
+    const server = new McpServer({
+        name: "volaticloud",
+        version: "0.1.0",
+    });
+    // Initialize auth and client
+    const auth = new AuthManager(config);
+    const client = new GraphQLClient(config.endpoint, auth);
+    const introspector = new SchemaIntrospector(client);
+    // Introspect schema
+    await introspector.introspect();
+    // Generate dynamic tools from schema
+    const generator = new ToolGenerator(introspector);
+    const dynamicTools = generator.generate();
+    const executor = new ToolExecutor(client, dynamicTools);
+    // --- Static tools ---
+    server.tool("introspect_schema", "Get the VolatiCloud GraphQL schema overview, or drill into a specific type by name", { typeName: z.string().optional().describe("Specific type name to inspect (e.g. 'Bot', 'Strategy', 'CreateBotInput')") }, async ({ typeName }) => {
+        if (typeName) {
+            return {
+                content: [{ type: "text", text: introspector.describeType(typeName) }],
+            };
+        }
+        return {
+            content: [{ type: "text", text: formatSchemaOverview(introspector) }],
+        };
+    });
+    server.tool("search_schema", "Search the GraphQL schema for types, fields, or enums matching a keyword", { keyword: z.string().describe("Search keyword") }, async ({ keyword }) => ({
+        content: [
+            { type: "text", text: formatSearchResults(introspector, keyword) },
+        ],
+    }));
+    server.tool("execute_query", "Execute an arbitrary GraphQL query against the VolatiCloud API", {
+        query: z.string().describe("GraphQL query string"),
+        variables: z.record(z.string(), z.unknown()).optional().describe("Query variables as JSON object"),
+    }, async ({ query, variables }) => {
+        const result = await client.execute(query, variables);
+        if (result.errors?.length) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ errors: result.errors, data: result.data }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }],
+        };
+    });
+    server.tool("execute_mutation", "Execute a GraphQL mutation against the VolatiCloud API (creates, updates, or deletes resources)", {
+        query: z.string().describe("GraphQL mutation string"),
+        variables: z.record(z.string(), z.unknown()).optional().describe("Mutation variables as JSON object"),
+    }, async ({ query, variables }) => {
+        const result = await client.execute(query, variables);
+        if (result.errors?.length) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ errors: result.errors, data: result.data }, null, 2),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result.data, null, 2) }],
+        };
+    });
+    // --- Dynamic tools (auto-generated from schema) ---
+    for (const tool of dynamicTools) {
+        server.tool(tool.name, tool.description, tool.zodParams, async (args) => {
+            const result = await executor.execute(tool.name, args);
+            const parsed = JSON.parse(result);
+            const isError = parsed !== null && typeof parsed === "object" && "error" in parsed;
+            return {
+                content: [{ type: "text", text: result }],
+                isError,
+            };
+        });
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/tools/executor.d.ts

@@ -0,0 +1,10 @@
+import type { GraphQLClient } from "../graphql/client.js";
+import type { GeneratedTool } from "../types.js";
+export declare class ToolExecutor {
+    private client;
+    private toolMap;
+    constructor(client: GraphQLClient, tools: GeneratedTool[]);
+    execute(toolName: string, args: Record<string, unknown>): Promise<string>;
+    getTool(name: string): GeneratedTool | undefined;
+}
+//# sourceMappingURL=executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAA6B;gBAEhC,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,aAAa,EAAE;IAKnD,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC;IAkBlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;CAGjD"}

package/dist/tools/executor.js

@@ -0,0 +1,26 @@
+export class ToolExecutor {
+    client;
+    toolMap;
+    constructor(client, tools) {
+        this.client = client;
+        this.toolMap = new Map(tools.map((t) => [t.name, t]));
+    }
+    async execute(toolName, args) {
+        const tool = this.toolMap.get(toolName);
+        if (!tool) {
+            return JSON.stringify({ error: `Unknown tool: ${toolName}` });
+        }
+        const result = await this.client.execute(tool.graphqlQuery, args);
+        if (result.errors?.length) {
+            return JSON.stringify({
+                error: result.errors.map((e) => e.message).join("; "),
+                data: result.data ?? null,
+            });
+        }
+        return JSON.stringify(result.data, null, 2);
+    }
+    getTool(name) {
+        return this.toolMap.get(name);
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/tools/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/tools/executor.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,YAAY;IACf,MAAM,CAAgB;IACtB,OAAO,CAA6B;IAE5C,YAAY,MAAqB,EAAE,KAAsB;QACvD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,OAAO,CACX,QAAgB,EAChB,IAA6B;QAE7B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAElE,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;gBACrD,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;aAC1B,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,OAAO,CAAC,IAAY;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/tools/formatter.d.ts

@@ -0,0 +1,4 @@
+import type { SchemaIntrospector } from "../graphql/introspect.js";
+export declare function formatSchemaOverview(introspector: SchemaIntrospector): string;
+export declare function formatSearchResults(introspector: SchemaIntrospector, keyword: string): string;
+//# sourceMappingURL=formatter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/tools/formatter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAEnE,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,kBAAkB,GAC/B,MAAM,CA8BR;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,kBAAkB,EAChC,OAAO,EAAE,MAAM,GACd,MAAM,CAQR"}

package/dist/tools/formatter.js

@@ -0,0 +1,34 @@
+export function formatSchemaOverview(introspector) {
+    const queries = introspector.getQueryFields();
+    const mutations = introspector.getMutationFields();
+    const lines = ["# VolatiCloud GraphQL Schema\n"];
+    lines.push("## Queries\n");
+    for (const q of queries) {
+        if (q.name.startsWith("__"))
+            continue;
+        const args = q.args.map((a) => `${a.name}: ${introspector.formatType(a.type)}`);
+        const argsStr = args.length > 0 ? `(${args.join(", ")})` : "";
+        const ret = introspector.formatType(q.type);
+        const desc = q.description ? ` — ${q.description}` : "";
+        lines.push(`- **${q.name}**${argsStr}: ${ret}${desc}`);
+    }
+    lines.push("\n## Mutations\n");
+    for (const m of mutations) {
+        const args = m.args.map((a) => `${a.name}: ${introspector.formatType(a.type)}`);
+        const argsStr = args.length > 0 ? `(${args.join(", ")})` : "";
+        const ret = introspector.formatType(m.type);
+        const desc = m.description ? ` — ${m.description}` : "";
+        lines.push(`- **${m.name}**${argsStr}: ${ret}${desc}`);
+    }
+    return lines.join("\n");
+}
+export function formatSearchResults(introspector, keyword) {
+    const types = introspector.searchTypes(keyword);
+    if (types.length === 0)
+        return `No types found matching "${keyword}"`;
+    return types
+        .slice(0, 20)
+        .map((t) => introspector.describeType(t.name))
+        .join("\n\n---\n\n");
+}
+//# sourceMappingURL=formatter.js.map

package/dist/tools/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/tools/formatter.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,oBAAoB,CAClC,YAAgC;IAEhC,MAAM,OAAO,GAAG,YAAY,CAAC,cAAc,EAAE,CAAC;IAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,iBAAiB,EAAE,CAAC;IAEnD,MAAM,KAAK,GAAa,CAAC,gCAAgC,CAAC,CAAC;IAE3D,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACtC,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CACrB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,KAAK,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CACrB,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CACvD,CAAC;QACF,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9D,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC5C,MAAM,IAAI,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxD,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,KAAK,GAAG,GAAG,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,YAAgC,EAChC,OAAe;IAEf,MAAM,KAAK,GAAG,YAAY,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,4BAA4B,OAAO,GAAG,CAAC;IAEtE,OAAO,KAAK;SACT,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SAC7C,IAAI,CAAC,aAAa,CAAC,CAAC;AACzB,CAAC"}

package/dist/tools/generator.d.ts

@@ -0,0 +1,14 @@
+import type { SchemaIntrospector } from "../graphql/introspect.js";
+import type { GeneratedTool } from "../types.js";
+export declare class ToolGenerator {
+    private introspector;
+    constructor(introspector: SchemaIntrospector);
+    generate(): GeneratedTool[];
+    private fieldToTool;
+    private argToZod;
+    private typeToZod;
+    private buildGraphQLOperation;
+    private buildSelectionSet;
+    private toSnakeCase;
+}
+//# sourceMappingURL=generator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../../src/tools/generator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,KAAK,EACV,aAAa,EAId,MAAM,aAAa,CAAC;AAKrB,qBAAa,aAAa;IACxB,OAAO,CAAC,YAAY,CAAqB;gBAE7B,YAAY,EAAE,kBAAkB;IAI5C,QAAQ,IAAI,aAAa,EAAE;IAkB3B,OAAO,CAAC,WAAW;IA6BnB,OAAO,CAAC,QAAQ;IAQhB,OAAO,CAAC,SAAS;IA6DjB,OAAO,CAAC,qBAAqB;IAsB7B,OAAO,CAAC,iBAAiB;IAqCzB,OAAO,CAAC,WAAW;CAMpB"}

package/dist/tools/generator.js

@@ -0,0 +1,159 @@
+import { z } from "zod";
+const SKIP_QUERIES = new Set(["node", "nodes", "__schema", "__type"]);
+const SKIP_MUTATIONS = new Set(["authenticateAPIClient"]);
+export class ToolGenerator {
+    introspector;
+    constructor(introspector) {
+        this.introspector = introspector;
+    }
+    generate() {
+        const tools = [];
+        for (const field of this.introspector.getQueryFields()) {
+            if (SKIP_QUERIES.has(field.name))
+                continue;
+            const tool = this.fieldToTool(field, "query");
+            if (tool)
+                tools.push(tool);
+        }
+        for (const field of this.introspector.getMutationFields()) {
+            if (SKIP_MUTATIONS.has(field.name))
+                continue;
+            const tool = this.fieldToTool(field, "mutation");
+            if (tool)
+                tools.push(tool);
+        }
+        return tools;
+    }
+    fieldToTool(field, operationType) {
+        const toolName = this.toSnakeCase(field.name);
+        const description = field.description || `${operationType}: ${field.name}`;
+        const zodParams = {};
+        for (const arg of field.args) {
+            let schema = this.argToZod(arg, new Set());
+            if (!this.introspector.isRequired(arg.type)) {
+                schema = schema.optional();
+            }
+            zodParams[arg.name] = schema;
+        }
+        const graphqlQuery = this.buildGraphQLOperation(field, operationType);
+        return {
+            name: toolName,
+            description,
+            zodParams,
+            operationType,
+            operationName: field.name,
+            graphqlQuery,
+        };
+    }
+    argToZod(arg, visited) {
+        let schema = this.typeToZod(arg.type, visited);
+        if (arg.description) {
+            schema = schema.describe(arg.description);
+        }
+        return schema;
+    }
+    typeToZod(type, visited) {
+        if (type.kind === "NON_NULL") {
+            return this.typeToZod(type.ofType, visited);
+        }
+        if (type.kind === "LIST") {
+            return z.array(this.typeToZod(type.ofType, visited));
+        }
+        const name = type.name ?? "Unknown";
+        switch (name) {
+            case "String":
+            case "ID":
+            case "Cursor":
+            case "Time":
+            case "UUID":
+                return z.string();
+            case "Int":
+                return z.number().int();
+            case "Float":
+                return z.number();
+            case "Boolean":
+                return z.boolean();
+            case "Map":
+            case "JSON":
+                return z.record(z.string(), z.unknown());
+            default: {
+                const fullType = this.introspector.getType(name);
+                if (fullType?.kind === "ENUM" && fullType.enumValues) {
+                    const values = fullType.enumValues.map((v) => v.name);
+                    if (values.length > 0) {
+                        return z.enum(values);
+                    }
+                    return z.string();
+                }
+                if (fullType?.kind === "INPUT_OBJECT" && fullType.inputFields) {
+                    // Cycle detection for self-referential WhereInput types
+                    if (visited.has(name)) {
+                        return z.record(z.string(), z.unknown()).describe(`${name} (recursive, accepts any object)`);
+                    }
+                    visited.add(name);
+                    const shape = {};
+                    for (const field of fullType.inputFields) {
+                        let fieldSchema = this.argToZod(field, visited);
+                        if (!this.introspector.isRequired(field.type)) {
+                            fieldSchema = fieldSchema.optional();
+                        }
+                        shape[field.name] = fieldSchema;
+                    }
+                    return z.object(shape).passthrough();
+                }
+                return z.record(z.string(), z.unknown());
+            }
+        }
+    }
+    buildGraphQLOperation(field, operationType) {
+        const varDefs = field.args
+            .map((a) => `$${a.name}: ${this.introspector.formatType(a.type)}`)
+            .join(", ");
+        const args = field.args
+            .map((a) => `${a.name}: $${a.name}`)
+            .join(", ");
+        const returnTypeName = this.introspector.resolveTypeName(field.type);
+        const selectionSet = this.buildSelectionSet(returnTypeName, 2);
+        const opName = field.name.charAt(0).toUpperCase() + field.name.slice(1);
+        const varDefsStr = varDefs ? `(${varDefs})` : "";
+        const argsStr = args ? `(${args})` : "";
+        return `${operationType} ${opName}${varDefsStr} {\n  ${field.name}${argsStr} ${selectionSet}\n}`;
+    }
+    buildSelectionSet(typeName, depth) {
+        if (depth <= 0)
+            return "";
+        const type = this.introspector.getType(typeName);
+        if (!type?.fields)
+            return "";
+        if (typeName.endsWith("Connection")) {
+            const edgesField = type.fields.find((f) => f.name === "edges");
+            if (edgesField) {
+                const edgeTypeName = this.introspector.resolveTypeName(edgesField.type);
+                const edgeType = this.introspector.getType(edgeTypeName);
+                const nodeField = edgeType?.fields?.find((f) => f.name === "node");
+                if (nodeField) {
+                    const nodeTypeName = this.introspector.resolveTypeName(nodeField.type);
+                    const nodeSelection = this.buildSelectionSet(nodeTypeName, depth - 1);
+                    return `{\n    totalCount\n    edges {\n      node ${nodeSelection}\n      cursor\n    }\n    pageInfo {\n      hasNextPage\n      endCursor\n    }\n  }`;
+                }
+            }
+        }
+        const scalars = type.fields.filter((f) => {
+            const resolvedName = this.introspector.resolveTypeName(f.type);
+            const resolved = this.introspector.getType(resolvedName);
+            return ((resolved !== undefined && !resolved.fields) ||
+                ["String", "Int", "Float", "Boolean", "ID", "Time", "UUID", "Map", "JSON"].includes(resolvedName));
+        });
+        if (scalars.length === 0)
+            return "";
+        const fields = scalars.map((f) => f.name).join("\n    ");
+        return `{\n    ${fields}\n  }`;
+    }
+    toSnakeCase(name) {
+        return name
+            .replace(/([A-Z])/g, "_$1")
+            .toLowerCase()
+            .replace(/^_/, "");
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/tools/generator.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,67 @@
+export interface ServerConfig {
+    endpoint: string;
+    clientId: string;
+    clientSecret: string;
+}
+export interface AuthToken {
+    accessToken: string;
+    tokenType: string;
+    expiresIn: number;
+    expiresAt: number;
+}
+export interface GraphQLResponse<T = Record<string, unknown>> {
+    data?: T;
+    errors?: GraphQLError[];
+}
+export interface GraphQLError {
+    message: string;
+    path?: string[];
+    extensions?: Record<string, unknown>;
+}
+export interface IntrospectedField {
+    name: string;
+    description: string | null;
+    args: IntrospectedArg[];
+    type: IntrospectedType;
+}
+export interface IntrospectedArg {
+    name: string;
+    description: string | null;
+    type: IntrospectedType;
+    defaultValue: string | null;
+}
+export interface IntrospectedType {
+    kind: string;
+    name: string | null;
+    ofType: IntrospectedType | null;
+}
+export interface IntrospectedSchema {
+    queryType: {
+        name: string;
+    } | null;
+    mutationType: {
+        name: string;
+    } | null;
+    types: IntrospectedFullType[];
+}
+export interface IntrospectedFullType {
+    kind: string;
+    name: string;
+    description: string | null;
+    fields: IntrospectedField[] | null;
+    inputFields: IntrospectedArg[] | null;
+    enumValues: {
+        name: string;
+        description: string | null;
+    }[] | null;
+}
+import type { ZodTypeAny } from "zod";
+export interface GeneratedTool {
+    name: string;
+    description: string;
+    zodParams: Record<string, ZodTypeAny>;
+    operationType: "query" | "mutation";
+    operationName: string;
+    graphqlQuery: string;
+}
+//# 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,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,IAAI,EAAE,gBAAgB,CAAC;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnC,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACtC,KAAK,EAAE,oBAAoB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,MAAM,EAAE,iBAAiB,EAAE,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IACtC,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,EAAE,GAAG,IAAI,CAAC;CACnE;AAED,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEtC,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACtC,aAAa,EAAE,OAAO,GAAG,UAAU,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+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":""}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@volaticloud/mcp-server",
+  "version": "0.1.0-dev.pr507.25e1c71",
+  "description": "MCP server for the VolatiCloud GraphQL API — manage strategies, bots, exchanges, and backtests via AI agents",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "volaticloud-mcp": "bin/mcp-server.mjs"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "volaticloud",
+    "graphql",
+    "trading",
+    "ai-agent"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.1",
+    "zod": "^3.25 || ^4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}