Tailscale MCP Server

Instructions

Implementation Reference

• src/tools/device-tools.ts:131-165 (handler)

  The handler function for the manage_routes tool, which enables or disables specified CIDR routes for a given device using the Tailscale client.

  async function manageRoutes(
    args: z.infer<typeof ManageRoutesSchema>,
    context: ToolContext,
  ): Promise<CallToolResult> {
    try {
      logger.debug("Managing routes:", args);
  
      let result: UnifiedResponse<void>;
      if (args.action === "enable") {
        result = await context.client.enableDeviceRoutes(
          args.deviceId,
          args.routes,
        );
      } else {
        result = await context.client.disableDeviceRoutes(
          args.deviceId,
          args.routes,
        );
      }
  
      if (!result.success) {
        return returnToolError(result.error);
      }
  
      const verbPast = args.action === "enable" ? "enabled" : "disabled";
      return returnToolSuccess(
        `Successfully ${verbPast} routes ${args.routes.join(
          ", ",
        )} for device ${args.deviceId}`,
      );
    } catch (error: unknown) {
      logger.error("Error managing routes:", error);
      return returnToolError(error);
    }
  }

• src/tools/device-tools.ts:24-30 (schema)

  Zod input schema for the manage_routes tool defining deviceId, routes array, and action (enable/disable).

  const ManageRoutesSchema = z.object({
    deviceId: z.string().describe("The ID of the device"),
    routes: z.array(z.string()).describe("Array of CIDR routes to manage"),
    action: z
      .enum(["enable", "disable"])
      .describe("Whether to enable or disable the routes"),
  });

• src/tools/device-tools.ts:182-187 (registration)

  Tool registration object within the deviceTools module's tools array, linking name, description, schema, and handler.

  {
    name: "manage_routes",
    description: "Enable or disable routes for a device",
    inputSchema: ManageRoutesSchema,
    handler: manageRoutes,
  },