@nirvana-labs/nirvana-mcp 1.17.0

package/src/server.ts

@@ -0,0 +1,204 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { Endpoint, endpoints, HandlerFunction, query } from './tools';
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  SetLevelRequestSchema,
+  Implementation,
+  Tool,
+} from '@modelcontextprotocol/sdk/types.js';
+import { ClientOptions } from '@nirvana-labs/nirvana';
+import NirvanaLabs from '@nirvana-labs/nirvana';
+import {
+  applyCompatibilityTransformations,
+  ClientCapabilities,
+  defaultClientCapabilities,
+  knownClients,
+  parseEmbeddedJSON,
+} from './compat';
+import { dynamicTools } from './dynamic-tools';
+import { codeTool } from './code-tool';
+import { McpOptions } from './options';
+
+export { McpOptions } from './options';
+export { ClientType } from './compat';
+export { Filter } from './tools';
+export { ClientOptions } from '@nirvana-labs/nirvana';
+export { endpoints } from './tools';
+
+export const newMcpServer = () =>
+  new McpServer(
+    {
+      name: 'nirvana_labs_nirvana_api',
+      version: '1.17.0',
+    },
+    { capabilities: { tools: {}, logging: {} } },
+  );
+
+// Create server instance
+export const server = newMcpServer();
+
+/**
+ * Initializes the provided MCP Server with the given tools and handlers.
+ * If not provided, the default client, tools and handlers will be used.
+ */
+export function initMcpServer(params: {
+  server: Server | McpServer;
+  clientOptions?: ClientOptions;
+  mcpOptions?: McpOptions;
+}) {
+  const server = params.server instanceof McpServer ? params.server.server : params.server;
+  const mcpOptions = params.mcpOptions ?? {};
+
+  let providedEndpoints: Endpoint[] | null = null;
+  let endpointMap: Record<string, Endpoint> | null = null;
+
+  const initTools = async (implementation?: Implementation) => {
+    if (implementation && (!mcpOptions.client || mcpOptions.client === 'infer')) {
+      mcpOptions.client =
+        implementation.name.toLowerCase().includes('claude') ? 'claude'
+        : implementation.name.toLowerCase().includes('cursor') ? 'cursor'
+        : undefined;
+      mcpOptions.capabilities = {
+        ...(mcpOptions.client && knownClients[mcpOptions.client]),
+        ...mcpOptions.capabilities,
+      };
+    }
+    providedEndpoints ??= await selectTools(endpoints, mcpOptions);
+    endpointMap ??= Object.fromEntries(providedEndpoints.map((endpoint) => [endpoint.tool.name, endpoint]));
+  };
+
+  const logAtLevel =
+    (level: 'debug' | 'info' | 'warning' | 'error') =>
+    (message: string, ...rest: unknown[]) => {
+      void server.sendLoggingMessage({
+        level,
+        data: { message, rest },
+      });
+    };
+  const logger = {
+    debug: logAtLevel('debug'),
+    info: logAtLevel('info'),
+    warn: logAtLevel('warning'),
+    error: logAtLevel('error'),
+  };
+
+  let client = new NirvanaLabs({
+    logger,
+    ...params.clientOptions,
+    defaultHeaders: {
+      ...params.clientOptions?.defaultHeaders,
+      'X-Stainless-MCP': 'true',
+    },
+  });
+
+  server.setRequestHandler(ListToolsRequestSchema, async () => {
+    if (providedEndpoints === null) {
+      await initTools(server.getClientVersion());
+    }
+    return {
+      tools: providedEndpoints!.map((endpoint) => endpoint.tool),
+    };
+  });
+
+  server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    if (endpointMap === null) {
+      await initTools(server.getClientVersion());
+    }
+    const { name, arguments: args } = request.params;
+    const endpoint = endpointMap![name];
+    if (!endpoint) {
+      throw new Error(`Unknown tool: ${name}`);
+    }
+
+    return executeHandler(endpoint.tool, endpoint.handler, client, args, mcpOptions.capabilities);
+  });
+
+  server.setRequestHandler(SetLevelRequestSchema, async (request) => {
+    const { level } = request.params;
+    switch (level) {
+      case 'debug':
+        client = client.withOptions({ logLevel: 'debug' });
+        break;
+      case 'info':
+        client = client.withOptions({ logLevel: 'info' });
+        break;
+      case 'notice':
+      case 'warning':
+        client = client.withOptions({ logLevel: 'warn' });
+        break;
+      case 'error':
+        client = client.withOptions({ logLevel: 'error' });
+        break;
+      default:
+        client = client.withOptions({ logLevel: 'off' });
+        break;
+    }
+    return {};
+  });
+}
+
+/**
+ * Selects the tools to include in the MCP Server based on the provided options.
+ */
+export async function selectTools(endpoints: Endpoint[], options?: McpOptions): Promise<Endpoint[]> {
+  const filteredEndpoints = query(options?.filters ?? [], endpoints);
+
+  let includedTools = filteredEndpoints;
+
+  if (includedTools.length > 0) {
+    if (options?.includeDynamicTools) {
+      includedTools = dynamicTools(includedTools);
+    }
+  } else {
+    if (options?.includeAllTools) {
+      includedTools = endpoints;
+    } else if (options?.includeDynamicTools) {
+      includedTools = dynamicTools(endpoints);
+    } else if (options?.includeCodeTools) {
+      includedTools = [await codeTool()];
+    } else {
+      includedTools = endpoints;
+    }
+  }
+
+  const capabilities = { ...defaultClientCapabilities, ...options?.capabilities };
+  return applyCompatibilityTransformations(includedTools, capabilities);
+}
+
+/**
+ * Runs the provided handler with the given client and arguments.
+ */
+export async function executeHandler(
+  tool: Tool,
+  handler: HandlerFunction,
+  client: NirvanaLabs,
+  args: Record<string, unknown> | undefined,
+  compatibilityOptions?: Partial<ClientCapabilities>,
+) {
+  const options = { ...defaultClientCapabilities, ...compatibilityOptions };
+  if (!options.validJson && args) {
+    args = parseEmbeddedJSON(args, tool.inputSchema);
+  }
+  return await handler(client, args || {});
+}
+
+export const readEnv = (env: string): string | undefined => {
+  if (typeof (globalThis as any).process !== 'undefined') {
+    return (globalThis as any).process.env?.[env]?.trim();
+  } else if (typeof (globalThis as any).Deno !== 'undefined') {
+    return (globalThis as any).Deno.env?.get?.(env)?.trim();
+  }
+  return;
+};
+
+export const readEnvOrError = (env: string): string => {
+  let envValue = readEnv(env);
+  if (envValue === undefined) {
+    throw new Error(`Environment variable ${env} is not set`);
+  }
+  return envValue;
+};

package/src/stdio.ts

@@ -0,0 +1,13 @@
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { initMcpServer, newMcpServer } from './server';
+import { McpOptions } from './options';
+
+export const launchStdioServer = async (options: McpOptions) => {
+  const server = newMcpServer();
+
+  initMcpServer({ server, mcpOptions: options });
+
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error('MCP Server running on stdio');
+};

package/src/tools/api-keys/create-api-keys.ts

@@ -0,0 +1,56 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@nirvana-labs/nirvana-mcp/filtering';
+import { Metadata, asTextContentResult } from '@nirvana-labs/nirvana-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import NirvanaLabs from '@nirvana-labs/nirvana';
+
+export const metadata: Metadata = {
+  resource: 'api_keys',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/api_keys',
+  operationId: 'create_api_key',
+};
+
+export const tool: Tool = {
+  name: 'create_api_keys',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreate a new API key\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/api_key',\n  $defs: {\n    api_key: {\n      type: 'object',\n      description: 'API key response.',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'API key ID.'\n        },\n        created_at: {\n          type: 'string',\n          description: 'When the API key was created.',\n          format: 'date-time'\n        },\n        expires_at: {\n          type: 'string',\n          description: 'When the API key expires and is no longer valid.',\n          format: 'date-time'\n        },\n        name: {\n          type: 'string',\n          description: 'API key name.'\n        },\n        status: {\n          type: 'string',\n          description: 'Status of the API key.',\n          enum: [            'active',\n            'inactive',\n            'expired'\n          ]\n        },\n        updated_at: {\n          type: 'string',\n          description: 'When the API key was updated.',\n          format: 'date-time'\n        },\n        key: {\n          type: 'string',\n          description: 'API key. Only returned on creation.'\n        },\n        starts_at: {\n          type: 'string',\n          description: 'When the API key starts to be valid.',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'created_at',\n        'expires_at',\n        'name',\n        'status',\n        'updated_at'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      expires_at: {
+        type: 'string',
+        description: 'When the API key expires and is no longer valid.',
+        format: 'date-time',
+      },
+      name: {
+        type: 'string',
+        description: 'API key name.',
+      },
+      starts_at: {
+        type: 'string',
+        description: 'When the API key starts to be valid.',
+        format: 'date-time',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['expires_at', 'name'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: NirvanaLabs, args: Record<string, unknown> | undefined) => {
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.apiKeys.create(body)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/api-keys/delete-api-keys.ts

@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from '@nirvana-labs/nirvana-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import NirvanaLabs from '@nirvana-labs/nirvana';
+
+export const metadata: Metadata = {
+  resource: 'api_keys',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/v1/api_keys/{api_key_id}',
+  operationId: 'delete_api_key',
+};
+
+export const tool: Tool = {
+  name: 'delete_api_keys',
+  description: 'Delete an API key',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      api_key_id: {
+        type: 'string',
+      },
+    },
+    required: ['api_key_id'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: NirvanaLabs, args: Record<string, unknown> | undefined) => {
+  const { api_key_id, ...body } = args as any;
+  const response = await client.apiKeys.delete(api_key_id).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/api-keys/get-api-keys.ts

@@ -0,0 +1,47 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@nirvana-labs/nirvana-mcp/filtering';
+import { Metadata, asTextContentResult } from '@nirvana-labs/nirvana-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import NirvanaLabs from '@nirvana-labs/nirvana';
+
+export const metadata: Metadata = {
+  resource: 'api_keys',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/api_keys/{api_key_id}',
+  operationId: 'get_api_key',
+};
+
+export const tool: Tool = {
+  name: 'get_api_keys',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet details about an API key\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/api_key',\n  $defs: {\n    api_key: {\n      type: 'object',\n      description: 'API key response.',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'API key ID.'\n        },\n        created_at: {\n          type: 'string',\n          description: 'When the API key was created.',\n          format: 'date-time'\n        },\n        expires_at: {\n          type: 'string',\n          description: 'When the API key expires and is no longer valid.',\n          format: 'date-time'\n        },\n        name: {\n          type: 'string',\n          description: 'API key name.'\n        },\n        status: {\n          type: 'string',\n          description: 'Status of the API key.',\n          enum: [            'active',\n            'inactive',\n            'expired'\n          ]\n        },\n        updated_at: {\n          type: 'string',\n          description: 'When the API key was updated.',\n          format: 'date-time'\n        },\n        key: {\n          type: 'string',\n          description: 'API key. Only returned on creation.'\n        },\n        starts_at: {\n          type: 'string',\n          description: 'When the API key starts to be valid.',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'created_at',\n        'expires_at',\n        'name',\n        'status',\n        'updated_at'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      api_key_id: {
+        type: 'string',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['api_key_id'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: NirvanaLabs, args: Record<string, unknown> | undefined) => {
+  const { api_key_id, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.apiKeys.get(api_key_id)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/api-keys/list-api-keys.ts

@@ -0,0 +1,44 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@nirvana-labs/nirvana-mcp/filtering';
+import { Metadata, asTextContentResult } from '@nirvana-labs/nirvana-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import NirvanaLabs from '@nirvana-labs/nirvana';
+
+export const metadata: Metadata = {
+  resource: 'api_keys',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/api_keys',
+  operationId: 'list_api_keys',
+};
+
+export const tool: Tool = {
+  name: 'list_api_keys',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nList all API keys for the authenticated user\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/api_key_list',\n  $defs: {\n    api_key_list: {\n      type: 'object',\n      properties: {\n        items: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/api_key'\n          }\n        }\n      },\n      required: [        'items'\n      ]\n    },\n    api_key: {\n      type: 'object',\n      description: 'API key response.',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'API key ID.'\n        },\n        created_at: {\n          type: 'string',\n          description: 'When the API key was created.',\n          format: 'date-time'\n        },\n        expires_at: {\n          type: 'string',\n          description: 'When the API key expires and is no longer valid.',\n          format: 'date-time'\n        },\n        name: {\n          type: 'string',\n          description: 'API key name.'\n        },\n        status: {\n          type: 'string',\n          description: 'Status of the API key.',\n          enum: [            'active',\n            'inactive',\n            'expired'\n          ]\n        },\n        updated_at: {\n          type: 'string',\n          description: 'When the API key was updated.',\n          format: 'date-time'\n        },\n        key: {\n          type: 'string',\n          description: 'API key. Only returned on creation.'\n        },\n        starts_at: {\n          type: 'string',\n          description: 'When the API key starts to be valid.',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'created_at',\n        'expires_at',\n        'name',\n        'status',\n        'updated_at'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: [],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: NirvanaLabs, args: Record<string, unknown> | undefined) => {
+  const { jq_filter } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.apiKeys.list()));
+};
+
+export default { metadata, tool, handler };

package/src/tools/api-keys/update-api-keys.ts

@@ -0,0 +1,49 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@nirvana-labs/nirvana-mcp/filtering';
+import { Metadata, asTextContentResult } from '@nirvana-labs/nirvana-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import NirvanaLabs from '@nirvana-labs/nirvana';
+
+export const metadata: Metadata = {
+  resource: 'api_keys',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'patch',
+  httpPath: '/v1/api_keys/{api_key_id}',
+  operationId: 'update_api_key',
+};
+
+export const tool: Tool = {
+  name: 'update_api_keys',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nUpdate an existing API key\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/api_key',\n  $defs: {\n    api_key: {\n      type: 'object',\n      description: 'API key response.',\n      properties: {\n        id: {\n          type: 'string',\n          description: 'API key ID.'\n        },\n        created_at: {\n          type: 'string',\n          description: 'When the API key was created.',\n          format: 'date-time'\n        },\n        expires_at: {\n          type: 'string',\n          description: 'When the API key expires and is no longer valid.',\n          format: 'date-time'\n        },\n        name: {\n          type: 'string',\n          description: 'API key name.'\n        },\n        status: {\n          type: 'string',\n          description: 'Status of the API key.',\n          enum: [            'active',\n            'inactive',\n            'expired'\n          ]\n        },\n        updated_at: {\n          type: 'string',\n          description: 'When the API key was updated.',\n          format: 'date-time'\n        },\n        key: {\n          type: 'string',\n          description: 'API key. Only returned on creation.'\n        },\n        starts_at: {\n          type: 'string',\n          description: 'When the API key starts to be valid.',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'created_at',\n        'expires_at',\n        'name',\n        'status',\n        'updated_at'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      api_key_id: {
+        type: 'string',
+      },
+      name: {
+        type: 'string',
+        description: 'API key name.',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['api_key_id'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: NirvanaLabs, args: Record<string, unknown> | undefined) => {
+  const { api_key_id, jq_filter, ...body } = args as any;
+  return asTextContentResult(await maybeFilter(jq_filter, await client.apiKeys.update(api_key_id, body)));
+};
+
+export default { metadata, tool, handler };

package/src/tools/compute/vms/availability/create-vms-compute-availability.ts

@@ -0,0 +1,161 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { maybeFilter } from '@nirvana-labs/nirvana-mcp/filtering';
+import { Metadata, asTextContentResult } from '@nirvana-labs/nirvana-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import NirvanaLabs from '@nirvana-labs/nirvana';
+
+export const metadata: Metadata = {
+  resource: 'compute.vms.availability',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/compute/vms/availability',
+  operationId: 'create_vm_availability',
+};
+
+export const tool: Tool = {
+  name: 'create_vms_compute_availability',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCheck VM Create Availability\n\n# Response Schema\n```json\n{\n  type: 'string'\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      boot_volume: {
+        type: 'object',
+        description: 'Boot volume for the VM.',
+        properties: {
+          size: {
+            type: 'integer',
+            description: 'Size of the volume in GB.',
+          },
+        },
+        required: ['size'],
+      },
+      cpu_config: {
+        $ref: '#/$defs/cpu_config_request',
+      },
+      memory_config: {
+        $ref: '#/$defs/memory_config_request',
+      },
+      name: {
+        type: 'string',
+        description: 'Name of the VM.',
+      },
+      os_image_name: {
+        type: 'string',
+        description: 'Name of the OS Image to use for the VM.',
+      },
+      public_ip_enabled: {
+        type: 'boolean',
+        description: 'Whether to enable public IP for the VM.',
+      },
+      region: {
+        $ref: '#/$defs/region_name',
+      },
+      ssh_key: {
+        $ref: '#/$defs/ssh_key_request',
+      },
+      subnet_id: {
+        type: 'string',
+        description: 'ID of the subnet to use for the VM.',
+      },
+      data_volumes: {
+        type: 'array',
+        description: 'Data volumes for the VM.',
+        items: {
+          type: 'object',
+          description: 'VM data volume create request.',
+          properties: {
+            name: {
+              type: 'string',
+              description: 'Name of the volume.',
+            },
+            size: {
+              type: 'integer',
+              description: 'Size of the volume in GB.',
+            },
+          },
+          required: ['name', 'size'],
+        },
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: [
+      'boot_volume',
+      'cpu_config',
+      'memory_config',
+      'name',
+      'os_image_name',
+      'public_ip_enabled',
+      'region',
+      'ssh_key',
+      'subnet_id',
+    ],
+    $defs: {
+      cpu_config_request: {
+        type: 'object',
+        description: 'CPU configuration for the VM.',
+        properties: {
+          vcpu: {
+            type: 'integer',
+            description: 'Number of virtual CPUs.',
+          },
+        },
+        required: ['vcpu'],
+      },
+      memory_config_request: {
+        type: 'object',
+        description: 'Memory configuration for the VM.',
+        properties: {
+          size: {
+            type: 'integer',
+            description: 'Size of the memory in GB.',
+          },
+        },
+        required: ['size'],
+      },
+      region_name: {
+        type: 'string',
+        description: 'Region the resource is in.',
+        enum: [
+          'us-sea-1',
+          'us-sva-1',
+          'us-chi-1',
+          'us-wdc-1',
+          'eu-frk-1',
+          'ap-sin-1',
+          'ap-seo-1',
+          'ap-tyo-1',
+        ],
+      },
+      ssh_key_request: {
+        type: 'object',
+        description: 'Public SSH key configuration for the VM.',
+        properties: {
+          public_key: {
+            type: 'string',
+            description: 'Public key to and and use to access the VM.',
+          },
+        },
+        required: ['public_key'],
+      },
+    },
+  },
+  annotations: {},
+};
+
+export const handler = async (client: NirvanaLabs, args: Record<string, unknown> | undefined) => {
+  const { jq_filter, ...body } = args as any;
+  return asTextContentResult(
+    await maybeFilter(jq_filter, await client.compute.vms.availability.create(body)),
+  );
+};
+
+export default { metadata, tool, handler };