delete_instance

Instructions

Implementation Reference

• src/api/instances.ts:178-201 (handler)

  The actual handler/API function that executes the delete instance logic. It sends a DELETE request to the Civo API to delete an instance by ID and region.

  export async function deleteInstance(params: {
    id: string;
    region: string;
  }): Promise<any> {
    checkRateLimit();
  
    const url = new URL(`${CIVO_API_URL}/instances/${params.id}`);
    url.searchParams.set('region', params.region);
  
    const response = await fetch(url.toString(), {
      method: 'DELETE',
      headers: {
        Authorization: `Bearer ${CIVO_API_KEY}`,
      },
    });
  
    if (!response.ok) {
      throw new Error(
        `Civo API error: ${response.status} ${response.statusText}`
      );
    }
  
    return response.json();
  }

• src/index.ts:449-471 (registration)

  The tool handler case in the main server that routes 'delete_instance' calls to the deleteInstance API function. Validates arguments, calls deleteInstance, and returns a success message.

  case 'delete_instance': {
    if (
      typeof args !== 'object' ||
      args === null ||
      typeof args.id !== 'string' ||
      typeof args.region !== 'string'
    ) {
      throw new Error('Invalid arguments for delete_instance');
    }
  
    const result = await deleteInstance(
      args as { id: string; region: string }
    );
    return {
      content: [
        {
          type: 'text',
          text: `Instance ${args.id} deleted: ${result.result}`,
        },
      ],
      isError: false,
    };
  }

• src/tools/instances.ts:140-157 (schema)

  The tool definition/schema for delete_instance, specifying name, description, and input schema requiring 'id' (string) and 'region' (string).

  export const DELETE_INSTANCE_TOOL: Tool = {
    name: 'delete_instance',
    description: 'Delete a cloud instance on Civo',
    inputSchema: {
      type: 'object',
      properties: {
        id: {
          type: 'string',
          description: 'Instance ID',
        },
        region: {
          type: 'string',
          description: 'Region identifier',
        },
      },
      required: ['id', 'region'],
    },
  };

• src/index.ts:70-92 (registration)

  Registration of DELETE_INSTANCE_TOOL in the server's tool list using its name as the key.

      tools: {
        [CREATE_INSTANCE_TOOL.name]: CREATE_INSTANCE_TOOL,
        [LIST_INSTANCES_TOOL.name]: LIST_INSTANCES_TOOL,
        [REBOOT_INSTANCE_TOOL.name]: REBOOT_INSTANCE_TOOL,
        [SHUTDOWN_INSTANCE_TOOL.name]: SHUTDOWN_INSTANCE_TOOL,
        [START_INSTANCE_TOOL.name]: START_INSTANCE_TOOL,
        [RESIZE_INSTANCE_TOOL.name]: RESIZE_INSTANCE_TOOL,
        [DELETE_INSTANCE_TOOL.name]: DELETE_INSTANCE_TOOL,
        [LIST_DISK_IMAGES_TOOL.name]: LIST_DISK_IMAGES_TOOL,
        [GET_DISK_IMAGE_TOOL.name]: GET_DISK_IMAGE_TOOL,
        [LIST_SIZES_TOOL.name]: LIST_SIZES_TOOL,
        [LIST_REGIONS_TOOL.name]: LIST_REGIONS_TOOL,
        [LIST_NETWORKS_TOOL.name]: LIST_NETWORKS_TOOL,
        [CREATE_NETWORK_TOOL.name]: CREATE_NETWORK_TOOL,
        [RENAME_NETWORK_TOOL.name]: RENAME_NETWORK_TOOL,
        [DELETE_NETWORK_TOOL.name]: DELETE_NETWORK_TOOL,
        [LIST_KUBERNETES_CLUSTERS_TOOL.name]: LIST_KUBERNETES_CLUSTERS_TOOL,
        [CREATE_KUBERNETES_CLUSTER_TOOL.name]: CREATE_KUBERNETES_CLUSTER_TOOL,
        [DELETE_KUBERNETES_CLUSTER_TOOL.name]: DELETE_KUBERNETES_CLUSTER_TOOL,
        [LIST_KUBERNETES_VERSIONS_TOOL.name]: LIST_KUBERNETES_VERSIONS_TOOL,
      },
    },
  }

• src/index.ts:96-118 (registration)

  Registration of DELETE_INSTANCE_TOOL in the ListToolsRequestSchema handler, making it visible to clients listing available tools.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [
      CREATE_INSTANCE_TOOL,
      LIST_INSTANCES_TOOL,
      REBOOT_INSTANCE_TOOL,
      SHUTDOWN_INSTANCE_TOOL,
      START_INSTANCE_TOOL,
      RESIZE_INSTANCE_TOOL,
      DELETE_INSTANCE_TOOL,
      LIST_DISK_IMAGES_TOOL,
      GET_DISK_IMAGE_TOOL,
      LIST_SIZES_TOOL,
      LIST_REGIONS_TOOL,
      LIST_NETWORKS_TOOL,
      CREATE_NETWORK_TOOL,
      RENAME_NETWORK_TOOL,
      DELETE_NETWORK_TOOL,
      LIST_KUBERNETES_CLUSTERS_TOOL,
      CREATE_KUBERNETES_CLUSTER_TOOL,
      DELETE_KUBERNETES_CLUSTER_TOOL,
      LIST_KUBERNETES_VERSIONS_TOOL,
    ],
  }));